From d6cd3fcb81ec5a81817676c7ce8653b5cd6f15a9 Mon Sep 17 00:00:00 2001 From: Bugo Date: Tue, 3 Oct 2023 16:31:44 +0500 Subject: [PATCH] Update translations --- .../extending/admin-events/index.md | 2 +- docs/admin-panel/faq/index.md | 2 +- docs/admin-panel/page/advanced/index.md | 2 +- docs/admin-panel/page/configuration/index.md | 2 +- docs/admin-panel/page/index.md | 2 +- docs/admin-panel/page/options/index.md | 2 +- .../grav-16-upgrade-guide/index.md | 2 +- docs/advanced/scheduler/index.md | 2 +- docs/cli-console/command-line-intro/index.md | 4 ++-- docs/cli-console/grav-cli-plugin/index.md | 6 ++--- docs/content/collections/index.md | 10 ++++----- docs/content/content-pages/index.md | 4 ++-- docs/content/headers/index.md | 22 ++++++++----------- docs/content/modular/index.md | 2 +- docs/cookbook/general-recipes/index.md | 8 +++---- docs/cookbook/plugin-recipes/index.md | 6 ++--- .../cookbook/tutorials/create-a-blog/index.md | 2 +- docs/cookbook/twig-recipes/index.md | 4 ++-- .../blueprints/advanced-features/index.md | 2 +- .../blueprints/fields-available/index.md | 4 ++-- docs/forms/forms/index.md | 2 +- docs/security/overview/index.md | 2 +- docs/themes/customization/index.md | 2 +- docs/themes/theme-vars/index.md | 6 ++--- .../functions/index.md | 2 +- .../twig-tags-filters-functions/tags/index.md | 2 +- .../internal-server-error/index.md | 2 +- 27 files changed, 52 insertions(+), 56 deletions(-) diff --git a/docs/admin-panel/extending/admin-events/index.md b/docs/admin-panel/extending/admin-events/index.md index 06d57772..6d4537be 100644 --- a/docs/admin-panel/extending/admin-events/index.md +++ b/docs/admin-panel/extending/admin-events/index.md @@ -19,7 +19,7 @@ description: Список доступных хуков админки Grav CMS. ### onAdminCreatePageFrontmatter -При создании новой страницы это событие запускается после того, как данные заголовка изначально настроены так, чтобы плагины могли программно манипулировать frontmatter. +При создании новой страницы это событие вызывается после первоначальной установки данных заголовка, что позволяет плагинам программно манипулировать блоком метаданных. ### onAdminSave diff --git a/docs/admin-panel/faq/index.md b/docs/admin-panel/faq/index.md index c02d8199..0722ae78 100644 --- a/docs/admin-panel/faq/index.md +++ b/docs/admin-panel/faq/index.md @@ -106,7 +106,7 @@ hashed_password: $2y$10$5RAUI6ZCISWR.4f0D6FILu3efYq3078ZX/.9vtAnZbjxS/4PXN/WW ## Пользовательский URL-адрес админки -Один из способов защитить вашу админ-панель - скрыть ее местоположение. Для этого нужно изменить URL-адрес с +Один из способов защитить вашу админ-панель - скрыть её местоположение. Для этого нужно изменить URL-адрес с ```text https://yourwebsite.com/admin diff --git a/docs/admin-panel/page/advanced/index.md b/docs/admin-panel/page/advanced/index.md index 88e78d4d..4a235832 100644 --- a/docs/admin-panel/page/advanced/index.md +++ b/docs/admin-panel/page/advanced/index.md @@ -48,7 +48,7 @@ description: Расширенные параметры редактора стр ![Редактор страниц](page-advanced-overrides.png) -Переопределения - это те параметры, которые наделяют вашу страницу дополнительной функциональностью, устанавливают для ее заголовка значение, отличное от значения по умолчанию, на основе имени папки, настроек кэширования, видимости навигации и делают страницу недоступной по прямому URL-адресу. +Переопределения - это те параметры, которые наделяют вашу страницу дополнительной функциональностью, устанавливают для её заголовка значение, отличное от значения по умолчанию, на основе имени папки, настроек кэширования, видимости навигации и делают страницу недоступной по прямому URL-адресу. Вы также можете использовать эту область для включения и выключения различных процессов для страницы, таких как Twig, который позволяет вам вставлять Twig в содержимое вашей страницы и выполнять его рендеринг. diff --git a/docs/admin-panel/page/configuration/index.md b/docs/admin-panel/page/configuration/index.md index 578a2fec..c3242ea0 100644 --- a/docs/admin-panel/page/configuration/index.md +++ b/docs/admin-panel/page/configuration/index.md @@ -19,4 +19,4 @@ description: Описание настроек секции страниц в а | **Включить кэширование рендеринга** | Кэширование рендеринга ускоряет рендеринг контента за счет кэширования результирующего HTML. | | **Время жизни кэша рендеринга (в секундах)** | Срок службы кэширования рендеринга в секундах. | -Если визуализируемый HTML-код содержит динамическое содержимое, кэш рендеринга можно отключить из шаблона Twig с помощью ```{% verbatim %}{% do block.disableCache() %}{% endverbatim %}```. +Если визуализируемый HTML-код содержит динамическое содержимое, кэш рендеринга можно отключить из шаблона Twig с помощью ```{% do block.disableCache() %}```. diff --git a/docs/admin-panel/page/index.md b/docs/admin-panel/page/index.md index 3c5e6ebd..53c4d7fc 100644 --- a/docs/admin-panel/page/index.md +++ b/docs/admin-panel/page/index.md @@ -71,7 +71,7 @@ description: Обзор раздела для управления страни Выбор заголовка любой страницы приведет вас прямо к редактору этой страницы. Большой значок **X** справа от каждой страницы позволяет удалить страницу. -Если вы наведете курсор на значок слева от страницы, он сообщит вам ее текущий статус. Например, он может сказать **Страница • Маршрутизируемая • Видимая**, если страница является маршрутизируемой (видимой через URL-адрес) и видимой (отображается в меню навигации). +Если вы наведете курсор на значок слева от страницы, он сообщит вам её текущий статус. Например, он может сказать **Страница • Маршрутизируемая • Видимая**, если страница является маршрутизируемой (видимой через URL-адрес) и видимой (отображается в меню навигации). Вы можете **фильтровать** и **искать** свои страницы, чтобы упростить поиск именно той страницы, которую вы ищете. Например, используя параметр **Добавить фильтры**, вы можете фильтровать страницы по типу, чтобы в списке отображались только **модульные**, **видимые** и/или **маршрутизируемые** страницы. diff --git a/docs/admin-panel/page/options/index.md b/docs/admin-panel/page/options/index.md index de7cb669..cc64555e 100644 --- a/docs/admin-panel/page/options/index.md +++ b/docs/admin-panel/page/options/index.md @@ -40,7 +40,7 @@ description: Параметры редактора страниц в админ ![Редактор страниц](page-options-taxonomies.png) -В области «Таксономии» вы можете настроить организационные свойства своей страницы. Здесь можно настроить категории, в которых будет отображаться страница, ее теги и многое другое. +В области «Таксономии» вы можете настроить организационные свойства своей страницы. Здесь можно настроить категории, в которых будет отображаться страница, её теги и многое другое. | Параметр | Описание | diff --git a/docs/advanced/grav-development/grav-16-upgrade-guide/index.md b/docs/advanced/grav-development/grav-16-upgrade-guide/index.md index 7d1f1414..30504ff3 100644 --- a/docs/advanced/grav-development/grav-16-upgrade-guide/index.md +++ b/docs/advanced/grav-development/grav-16-upgrade-guide/index.md @@ -91,7 +91,7 @@ strict_mode: ### Отложенные блоки -Вам следует обновить свою тему до версии, в которой добавлена ​​поддержка отложенных блоков ресурсов, чтобы обеспечить полную поддержку Grav 1.6. В качестве альтернативы, если у вас есть настраиваемая измененная тема или вы разработали свою собственную, вам следует обновить ее самостоятельно, чтобы убедиться, что она продолжает работать с новыми функциями и более поздними версиями Grav и его плагинов, следуя руководству в [Важные обновления темы](https://getgrav.org/blog/important-theme-updates) сообщение в блоге. +Вам следует обновить свою тему до версии, в которой добавлена ​​поддержка отложенных блоков ресурсов, чтобы обеспечить полную поддержку Grav 1.6. В качестве альтернативы, если у вас есть настраиваемая измененная тема или вы разработали свою собственную, вам следует обновить её самостоятельно, чтобы убедиться, что она продолжает работать с новыми функциями и более поздними версиями Grav и его плагинов, следуя руководству в [Важные обновления темы](https://getgrav.org/blog/important-theme-updates) сообщение в блоге. ### Устаревший Twig diff --git a/docs/advanced/scheduler/index.md b/docs/advanced/scheduler/index.md index 3014ed7f..e9d26590 100644 --- a/docs/advanced/scheduler/index.md +++ b/docs/advanced/scheduler/index.md @@ -99,7 +99,7 @@ Scheduler Jobs Listing Планировщик Grav управляется основным файлом конфигурации. Он находится в `user/config/scheduler.yaml`, и для его выполнения требуется, чтобы любое задание было `enabled`. -Ниже конфигурации показаны доступные задания и разрешено ли им выполнение. Просто установите для записи значение `disabled`, чтобы остановить ее выполнение. +Ниже конфигурации показаны доступные задания и разрешено ли им выполнение. Просто установите для записи значение `disabled`, чтобы остановить её выполнение. ```yaml status: diff --git a/docs/cli-console/command-line-intro/index.md b/docs/cli-console/command-line-intro/index.md index 33c37358..c05bdf11 100644 --- a/docs/cli-console/command-line-intro/index.md +++ b/docs/cli-console/command-line-intro/index.md @@ -35,7 +35,7 @@ MacOS основана на Unix и соответствует стандарт ## Windows -Windows стоит отдельно от пакета по ряду причин. Многие команды в командной строке Windows напоминают ее корни DOS. Общие команды, такие как `ls` для вывода списка каталогов, здесь не работают. Вместо этого вы должны набрать `dir`. Вот несколько ресурсов, которые помогут вам разобраться в командной строке Windows: +Windows стоит отдельно от пакета по ряду причин. Многие команды в командной строке Windows напоминают её корни DOS. Общие команды, такие как `ls` для вывода списка каталогов, здесь не работают. Вместо этого вы должны набрать `dir`. Вот несколько ресурсов, которые помогут вам разобраться в командной строке Windows: * [Руководство MakeUseOf для начинающих по командной строке Windows](https://www.makeuseof.com/tag/a-beginners-guide-to-the-windows-command-line/) - Хорошо написанное введение в командную строку для Windows. * [DOSPrompt.info](https://dosprompt.info/) - Целый сайт, посвященный ознакомлению пользователей с командной строкой. @@ -93,7 +93,7 @@ Windows стоит отдельно от пакета по ряду причин ## Символические ссылки -Символические ссылки (также известные как символические ссылки) невероятно полезны и легко выполняются в командной строке. Что он делает: он создает виртуальную копию (клон) заданной папки или ее содержимого и помещает ее туда, куда вы хотите. В отличие от настоящей копии, это просто туннель к оригиналу, поэтому все, что вы видите и изменяете, отражается сразу в нескольких местах. +Символические ссылки (также известные как символические ссылки) невероятно полезны и легко выполняются в командной строке. Что он делает: он создает виртуальную копию (клон) заданной папки или её содержимого и помещает её туда, куда вы хотите. В отличие от настоящей копии, это просто туннель к оригиналу, поэтому все, что вы видите и изменяете, отражается сразу в нескольких местах. Еще одно большое преимущество этого заключается в том, что он практически не занимает дополнительного дискового пространства, поскольку у вас нет нескольких копий одних и тех же файлов. diff --git a/docs/cli-console/grav-cli-plugin/index.md b/docs/cli-console/grav-cli-plugin/index.md index 3afd6c20..a766db8a 100644 --- a/docs/cli-console/grav-cli-plugin/index.md +++ b/docs/cli-console/grav-cli-plugin/index.md @@ -55,13 +55,13 @@ description: Список доступных командов для работ Как видите, большинство параметров и команд соответствуют [зарезервированному списку](#zarezervirovannye-komandy-i-parametry). Фактические команды, предлагаемые плагином входа в систему, - это `add-user`, `new-user` и `newuser`. -Как вы можете заметить, описание всех трех команд идентично. Это потому, что по выбору 3 команды абсолютно одинаковы. **add-user** и **newuser** фактически являются псевдонимами для **new-user**, что позволяет легко угадать команду, не зная и не запоминая ее. +Как вы можете заметить, описание всех трех команд идентично. Это потому, что по выбору 3 команды абсолютно одинаковы. **add-user** и **newuser** фактически являются псевдонимами для **new-user**, что позволяет легко угадать команду, не зная и не запоминая её. -Теперь, когда мы знаем, что плагин входа в систему поставляется с командой `new-user`, нам нужно только узнать, как ее использовать. Здесь появляется зарезервированная команда **help**. Запустим `bin/plugin login help new-user`. +Теперь, когда мы знаем, что плагин входа в систему поставляется с командой `new-user`, нам нужно только узнать, как её использовать. Здесь появляется зарезервированная команда **help**. Запустим `bin/plugin login help new-user`. ![](bin-plugin-newuser.png) -Теперь у нас есть полное представление о команде `new-user` и мы знаем, как ее использовать. +Теперь у нас есть полное представление о команде `new-user`. Попробуем создать нового пользователя. Поскольку все параметры по определению являются необязательными, мы намеренно опускаем пароль (позже нас спросят об этом). ```bash diff --git a/docs/content/collections/index.md b/docs/content/collections/index.md index 7879cb7d..788ffc6c 100644 --- a/docs/content/collections/index.md +++ b/docs/content/collections/index.md @@ -4,7 +4,7 @@ description: Рассматриваем коллекции страниц в Gra # Коллекции страниц -В Grav наиболее распространенным типом коллекции является список страниц, который может быть определен либо в frontmatter страницы, либо в самой Twig-разметке. Наиболее распространенным является определение коллекции в frontmatter. Если коллекция определена, она доступна в Twig страницы, чтобы делать с ней всё, что вы пожелаете. Используя методы коллекции страниц или циклически проходя через каждый [объект страницы](/themes/theme-vars/#obekt-page) и используя методы или свойства страницы, вы можете делать мощные вещи. Распространенные примеры этого включают отображение списка записей в блоге или отображение модульных подстраниц для визуализации сложного дизайна страницы. +В Grav наиболее распространенным типом коллекции является список страниц, который может быть определён либо в блоке метаданных страницы, либо в самой Twig-разметке. Наиболее распространенным является определение коллекции в блоке метаданных. Если коллекция определена, она доступна в Twig страницы, чтобы делать с ней всё, что вы пожелаете. Используя методы коллекции страниц или циклически проходя через каждый [объект страницы](/themes/theme-vars/#obekt-page) и используя методы или свойства страницы, вы можете делать мощные вещи. Распространенные примеры этого включают отображение списка записей в блоге или отображение модульных подстраниц для визуализации сложного дизайна страницы. ## Объект коллекции @@ -16,7 +16,7 @@ description: Рассматриваем коллекции страниц в Gra ## Пример определения коллекции -Пример коллекции, определенной в frontmatter страницы: +Пример коллекции, определенной в блоке метаданных страницы: ```yaml content: @@ -28,7 +28,7 @@ content: pagination: true ``` -Значение `content.items` в frontmatter страницы указывает Grav собирать коллекцию элементов, и информация, передаваемая ей, определяет, как должна быть построена коллекция. +Значение `content.items` в начале страницы указывает Grav собирать коллекцию элементов, и информация, передаваемая ей, определяет, как должна быть построена коллекция. Это определение создает коллекцию для страницы, которая состоит из всех **дочерних страниц**, отсортированных по **дате** и **по убыванию**, отображаемых вместе с **нумерацией страниц**, по **10 элементов** на странице. @@ -561,7 +561,7 @@ foreach ($collection as $page) { } ``` -Функция `order()` может также, в дополнение к параметрам `by` и `dir`, принимать параметры `manual` и `sort_flags`. Это [задокументировано выше](#Варианты-сортировки). Вы также можете использовать тот же метод `evaluate()`, который используют коллекции страниц на основе frontmatter: +Функция `order()` может также, в дополнение к параметрам `by` и `dir`, принимать параметры `manual` и `sort_flags`. Это [задокументировано выше](#Варианты-сортировки). Вы также можете использовать тот же метод `evaluate()`, который используют коллекции страниц на основе блока метаданных: ```php order('header.price','asc',null,SORT_NUMERIC) ``` -Генерация меню для всего сайта (вам необходимо установить свойство **menu** во frontmatter страницы): +Генерация меню для всего сайта (вам необходимо установить свойство **menu** в блоке метаданных страницы): ```yaml diff --git a/docs/content/content-pages/index.md b/docs/content/content-pages/index.md index c33bc56a..5055f33b 100644 --- a/docs/content/content-pages/index.md +++ b/docs/content/content-pages/index.md @@ -113,7 +113,7 @@ Grav понимает, что любое целочисленное значен ## Файл страницы -В папке страницы мы создаем фактический файл страницы. Имя файла должно заканчиваться на `.md`, чтобы указать, что это файл в формате Markdown. Технически, это Markdown с YAML FrontMatter, что звучит впечатляюще, но на самом деле не имеет большого значения. Мы скоро рассмотрим детали файловой структуры. +В папке страницы мы создаем фактический файл страницы. Имя файла должно заканчиваться на `.md`, чтобы указать, что это файл в формате Markdown. Технически, это Markdown с блоком метаданных YAML, что звучит впечатляюще, но на самом деле не имеет большого значения. Мы скоро рассмотрим детали файловой структуры. Важно понимать, что имя файла напрямую ссылается на имя файла шаблона темы, который будет использоваться для визуализации. Стандартное имя для основного файла шаблона — **default**, поэтому файл будет называться `default.md`. @@ -145,7 +145,7 @@ sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Pellente velit orci, laoreet at adipiscing eu, interdum quis nibh. Nunc a accumsan purus. ``` -Настройки между парой маркеров `---` называются YAML FrontMatter и состоят из основных настроек YAML для страницы. +Настройки между парой маркеров `---` называются блоком метаданных YAML и состоят из основных настроек YAML для страницы. В этом примере мы явно устанавливаем заголовок, а также таксономию **blog**, чтобы можно было отфильтровать её позже. Содержимое после второго `---` - это фактическое содержимое, которое будет скомпилировано и отображено на вашем сайте в виде HTML. Это написано в [Markdown](../markdown), который будет подробно рассмотрен в следующей главе. Просто знайте, что маркеры `#`, `**` и `_` переводятся в **заголовок 1**, **полужирный** и **курсив** соответственно. diff --git a/docs/content/headers/index.md b/docs/content/headers/index.md index d94c571b..7f50d274 100644 --- a/docs/content/headers/index.md +++ b/docs/content/headers/index.md @@ -1,18 +1,14 @@ --- -description: Настраиваем заголовки страниц в Grav CMS. Знакомимся с Frontmatter. +description: Настраиваем метаданные страниц в Grav CMS. Знакомимся с Frontmatter. --- -# Заголовки / Frontmatter +# Метаданные / Frontmatter -Заголовки (альтернативно известные как Frontmatter) в верхней части файла страницы совершенно необязательны, они вообще не нужны для отображения страницы в Grav. В Grav существует 3 основных типа страниц (**Обычная**, **Листинг** и **Модульная**), и каждая из них имеет соответствующие заголовки. +Frontmatter - это блок метаданных, который располагается в начале Markdown-файла. Он используется для описания и хранения информации о документе (метаданные документа), такой как заголовок, описание, автор, дата создания, дата публикации, категория, теги и другие параметры. Метаданные совершенно необязательны, они вообще не нужны для отображения страниц в Grav. В Grav существует 3 основных типа страниц (**Обычная**, **Листинг** и **Модульная**), и каждая из них имеет соответствующие метаданные. -!!! info "" - - Заголовки также известны как **Frontmatter страницы** и обычно называются таковыми, чтобы не путать их с HTTP-заголовками. - -## Основные заголовки страниц +## Основные метаданные страниц -Есть несколько основных доступных опций заголовка. +Есть несколько основных доступных параметров метаданных. ### Использование кэша @@ -187,7 +183,7 @@ login_redirect_here: false Заголовок `login_redirect_here` позволяет вам определить, должен ли пользователь оставаться на этой странице после входа в систему через [плагин Login](https://github.com/getgrav/grav-plugin-login). Если установить для этого заголовка значение `false`, пользователи будут перенаправлены на предыдущую страницу. -Значение `true` здесь позволит человеку оставаться на текущей странице после успешного входа в систему. Это также настройка по умолчанию, которая применяется, если в frontmatter нет заголовка `login_redirect_here`. +Значение `true` здесь позволит человеку оставаться на текущей странице после успешного входа в систему. Это также настройка по умолчанию, которая применяется, если в блоке метаданных нет параметра `login_redirect_here`. Вы можете переопределить это поведение по умолчанию принудительно установив стандартное расположение, указав явный параметр в конфигурации входа YAML: @@ -520,9 +516,9 @@ metadata: ## Frontmatter.yaml -Расширенная функция, которая может пригодиться некоторым опытным пользователям — это возможность использовать общие значения frontmatter через `frontmatter.yaml`, находящийся в папке страницы. Это особенно полезно при работе с многоязычными сайтами, где вы можете поделиться частью frontmatter между всеми языковыми версиями данной страницы. +Расширенная функция, которая может пригодиться некоторым опытным пользователям — это возможность использовать общие значения метаданных через `frontmatter.yaml`, находящийся в папке страницы. Это особенно полезно при работе с многоязычными сайтами, где вы можете поделиться частью метаданных между всеми языковыми версиями данной страницы. -Чтобы воспользоваться этим, просто создайте файл `frontmatter.yaml` рядом с файлом вашей страницы `.md` и добавьте любые допустимые значения frontmatter. Например: +Чтобы воспользоваться этим, просто создайте файл `frontmatter.yaml` рядом с файлом вашей страницы `.md` и добавьте любые допустимые значения метаданных. Например: ```yaml metadata: @@ -532,7 +528,7 @@ metadata: !!! info "" - Если заголовок определен и в frontmatter.yaml, и в заголовках страницы, то приоритет имеют значения заголовков страницы. + Если конкретный параметр определён и в frontmatter.yaml, и в метаданных страницы, то приоритет имеют значения метаданных страницы. !!! danger "" diff --git a/docs/content/modular/index.md b/docs/content/modular/index.md index ef379860..a68f16e4 100644 --- a/docs/content/modular/index.md +++ b/docs/content/modular/index.md @@ -28,7 +28,7 @@ description: Изучаем модульные страницы в Grav CMS. Каждая подпапка содержит файл Markdown, который действует как страница. -Данные в этих папках модулей, включая файлы Markdown, изображения и т. д., затем извлекаются и отображаются на странице Modular. Это достигается путем создания первичной страницы, определения [Коллекции страниц](../collections) в YAML FrontMatter первичной страницы, а затем повторения этой коллекции в шаблоне Twig для создания объединенной HTML-страницы. В теме уже должен быть шаблон `modular.html.twig`, который будет делать это и будет использоваться при создании типа модульной страницы. Вот простой пример из `modular.html.twig`: +Данные в этих папках модулей, включая файлы Markdown, изображения и т. д., затем извлекаются и отображаются на странице Modular. Это достигается путем создания первичной страницы, определения [Коллекции страниц](../collections) в блоке метаданных YAML первичной страницы, а затем повторения этой коллекции в шаблоне Twig для создания объединенной HTML-страницы. В теме уже должен быть шаблон `modular.html.twig`, который будет делать это и будет использоваться при создании типа модульной страницы. Вот простой пример из `modular.html.twig`: ```twig diff --git a/docs/cookbook/general-recipes/index.md b/docs/cookbook/general-recipes/index.md index 19952ca5..9b7e481e 100644 --- a/docs/cookbook/general-recipes/index.md +++ b/docs/cookbook/general-recipes/index.md @@ -347,7 +347,7 @@ Grav позволяет очень легко создать приватный Если у вас его ещё нет, установите его через панель администратора или с помощью утилиты командной строки GPM. -Далее откройте страницу в админке, переключитесь в экспертный режим и в разделе FrontMatter добавьте +Далее откройте страницу в админке, переключитесь в экспертный режим и в блоке метаданных добавьте ```yaml access: @@ -555,7 +555,7 @@ for(var i = 0; i < tree.length; i++){ ## Динамическое оформление одной или нескольких страниц -Вы можете динамически стилизовать разные страницы/сообщения на своем сайте Grav (независимо от назначения файла шаблона), настроив файл Twig темы для применения класса CSS, переданного как переменная в FrontMatter страницы. +Вы можете динамически стилизовать разные страницы/сообщения на своем сайте Grav (независимо от назначения файла шаблона), настроив файл Twig темы для применения класса CSS, переданного как переменная в метаданных страницы. Вы можете стилизовать разные сообщения/страницы на своем сайте Grav двумя способами: @@ -584,7 +584,7 @@ body_classes: featurepost Вы, вероятно, скачали тему, и она состоит из нескольких файлов HTML. Начнем с того, что просто заставим Grav загрузить домашнюю страницу. Никакого настраиваемого контента, просто копируйте тему HTML, но в структуре Grav. -Во-первых, используйте плагин [Grav Devtools](/themes/theme-tutorial), чтобы создать пустую тему, и настройте Grav для ее использования в системных настройках. +Во-первых, используйте плагин [Grav Devtools](/themes/theme-tutorial), чтобы создать пустую тему, и настройте Grav для её использования в системных настройках. Создайте шаблон Twig `templates/home.html.twig` внутри папки шаблонов темы. Это будет представлять собой шаблон, специфичный для домашней страницы. Обычно главная страница — это уникальная страница на сайте, поэтому она, вероятно, заслуживает отдельного файла Twig. @@ -623,7 +623,7 @@ body_classes: featurepost Изменения страницы теперь должны отображаться в вашем браузере. Если нет, убедитесь, что кэш страниц и кэш Twig отключены в настройках конфигурации системы Grav. -Это только начало. Теперь вам может потребоваться добавить больше страниц и придумать более эффективные способы представления содержимого ваших страниц с помощью заголовка FrontMatter и настраиваемого Twig, который обрабатывает обычные необходимые строительные блоки: отзывы на домашней странице, обзоры, функции продукта и т. Д. . +Это только начало. Теперь вам может потребоваться добавить больше страниц и придумать более эффективные способы представления содержимого ваших страниц с помощью метаданных и настраиваемого Twig, который обрабатывает обычные необходимые строительные блоки: отзывы на домашней странице, обзоры, функции продукта и т. д. ### Добавление ещё одной страницы diff --git a/docs/cookbook/plugin-recipes/index.md b/docs/cookbook/plugin-recipes/index.md index 6060336c..d4f9df21 100644 --- a/docs/cookbook/plugin-recipes/index.md +++ b/docs/cookbook/plugin-recipes/index.md @@ -20,7 +20,7 @@ description: Список проблем и решений, связанных `user/plugins/example/example.yaml` `user/plugins/example/twig/ExampleTwigExtension.php` -В `twig/ExampleTwigExtension.php` вы выполните свою собственную обработку и вернете ее в виде строки в `exampleFunction()`. +В `twig/ExampleTwigExtension.php` вы выполните свою собственную обработку и вернете её в виде строки в `exampleFunction()`. Затем в вашем файле шаблона Twig (или в файле Markdown страницы, если вы включили обработку Twig в Pages) визуализируйте вывод, используя: `{{ example() }}`. @@ -270,9 +270,9 @@ enabled: true Вы хотите получить доступ ко всем страницам и связанным с каждой страницей носителям через PHP и/или Twig, чтобы над ними можно было зацикливаться или иным образом манипулировать плагином. -Используйте возможности Grav для создания рекурсивного индекса всех страниц, а при индексировании также собирайте медиа-файлы для каждой страницы. Плагин [DirectoryListing](https://github.com/OleVik/grav-plugin-directorylisting/blob/v2.0.0-rc.2/Utilities.php#L64-L105) делает именно это и создает HTML- список с использованием созданной древовидной структуры. Для этого мы создадим рекурсивную функцию - или метод, который может иметь место в классе плагина, - который просматривает каждую страницу и сохраняет ее в массиве. Метод рекурсивен, потому что он снова вызывает себя для каждой найденной страницы, имеющей дочерние элементы. +Используйте возможности Grav для создания рекурсивного индекса всех страниц, а при индексировании также собирайте медиа-файлы для каждой страницы. Плагин [DirectoryListing](https://github.com/OleVik/grav-plugin-directorylisting/blob/v2.0.0-rc.2/Utilities.php#L64-L105) делает именно это и создает HTML- список с использованием созданной древовидной структуры. Для этого мы создадим рекурсивную функцию - или метод, который может иметь место в классе плагина, - который просматривает каждую страницу и сохраняет её в массиве. Метод рекурсивен, потому что он снова вызывает себя для каждой найденной страницы, имеющей дочерние элементы. -Но обо всем по порядку, метод принимает три параметра: первый - это `$route` к странице, который сообщает Grav, где его найти; второй - `$mode`, который сообщает методу, следует ли выполнять итерацию по самой странице или по ее дочерним элементам; третий - `$depth`, который отслеживает, на каком уровне находится страница. Метод сначала создает экземпляр объекта Page, затем работает с глубиной и режимом и создает коллекцию. По умолчанию мы упорядочиваем страницы по дате, по убыванию, но вы можете сделать это настраиваемым. Затем мы создаем массив `$paths` для хранения каждой страницы. Поскольку маршруты в Grav уникальны, они используются как ключи в этом массиве для идентификации каждой страницы. +Но обо всем по порядку, метод принимает три параметра: первый - это `$route` к странице, который сообщает Grav, где его найти; второй - `$mode`, который сообщает методу, следует ли выполнять итерацию по самой странице или по её дочерним элементам; третий - `$depth`, который отслеживает, на каком уровне находится страница. Метод сначала создает экземпляр объекта Page, затем работает с глубиной и режимом и создает коллекцию. По умолчанию мы упорядочиваем страницы по дате, по убыванию, но вы можете сделать это настраиваемым. Затем мы создаем массив `$paths` для хранения каждой страницы. Поскольку маршруты в Grav уникальны, они используются как ключи в этом массиве для идентификации каждой страницы. Теперь мы перебираем страницы, добавляя глубину, заголовок и маршрут (также сохраняемые как значение для облегчения доступа). В цикле foreach мы также пытаемся получить дочерние страницы и добавить их, если они найдены. Также мы находим все медиа, связанные со страницей, и добавляем их. Поскольку метод рекурсивен, он будет продолжать поиск страниц и дочерних страниц до тех пор, пока больше не будет найдено. diff --git a/docs/cookbook/tutorials/create-a-blog/index.md b/docs/cookbook/tutorials/create-a-blog/index.md index a3605a22..697cc87e 100644 --- a/docs/cookbook/tutorials/create-a-blog/index.md +++ b/docs/cookbook/tutorials/create-a-blog/index.md @@ -60,7 +60,7 @@ content: {% endfor %} ``` -`page.collection()` по умолчанию выбирает свойство `content.items` страницы YAML frontmatter и возвращает массив, содержащий элементы, соответствующие этому определению. +`page.collection()` по умолчанию выбирает свойство `content.items` из метаданных YAML и возвращает массив, содержащий элементы, соответствующие этому определению. Если страница содержит: diff --git a/docs/cookbook/twig-recipes/index.md b/docs/cookbook/twig-recipes/index.md index 56dfbcbf..2088dfae 100644 --- a/docs/cookbook/twig-recipes/index.md +++ b/docs/cookbook/twig-recipes/index.md @@ -58,7 +58,7 @@ process: Вы хотите отобразить все сообщения в блоге, которые произошли в этом календарном году. -Просто найдите страницу `/blog`, получите ее дочерние элементы, отфильтруйте по соответствующему `dateRange()` и упорядочите их по дате в порядке убывания: +Просто найдите страницу `/blog`, получите её дочерние элементы, отфильтруйте по соответствующему `dateRange()` и упорядочите их по дате в порядке убывания: ```twig