The 2026 Drupal Business Survey is open. Your response will help shape the future of the Drupal business ecosystem.i.5. Условные обозначения Руководства
Это руководство имеет следующие предположения и предполагаемые требования:
- Это руководство организовано с помощью тем; смотрите Раздел i.3, «Структура» для деталей. Многие темы включают свои Prerequisite knowledge разделы, в которых есть списки остальных тем для которых необходимые знания располагаются в порядке нужным для понимания темы, которую вы читаете. Некоторые общие знания, которые не описаны в руководстве также предполагаются; смотрите Раздел i.2, «Аудитория и Цель» для большей информации.
- Во многих задачах есть Site prerequisites, которые также являются задачами необходимые к выполнению на вашем сайте, перед тем как вы сможете выполнить задачу в читаемой теме.
- Специфичные требования к сайту относятся к сценарию использованному во многих темах этого руководства для создания сайта ярмарки города N (смотрите Раздел i.6, «Основной сценарий» для большей информации). Вы можете адаптировать таски к своему собственному сценарию, но тогда вы должны помнить, что изменения которые вы сделали должны соответствовать требованиям к сайту в других задачах.
- Для всех задач после Раздел 3.7, «Запуск интерактивного установщика», также есть неявное требование: вы должны установить последнюю версию Drupal, и авторизоваться под пользователем имеющим достаточные права для выполнения задачи (таким пользователем является аккаунт созданный при установке сайта, который автоматически имеет все права).
- Если вы прочитали все темы в последовательном порядке и выполнили все шаги из задач , то у вас должны быть все знания и настройки сайта, которые вы получили из предыдущих тем.
- Это руководство показывает как выполнить задачи используя пользовательский интерфейс, и где возможно используя последнюю стабильную версию Drush утилиту командной строки (смотрите Раздел 3.2, «Основы: Дополнителные инструменты»). Вы можете свободно использовать различные утилиты командной строки, такие как Drupal Console (если вы нашли подходящую команду) или используйте пользовательский интерфейс для начала.
Следующие обозначения использованы в тексте этого руководства:
- URL example.com означает базовый URL вашего сайта. Смотрите раздел Навигации ниже для больше информации про внутренние URL вашего сайта.
- Текст который вам следует искать в пользовательском интерфейсе выделен italics, например: Нажмите Save configuration. Это касается только текста пользовательского интерфейса который находится в Drupal и не является текстом, который мы вводим в предыдущей теме. Например, в теме о редактирование, вы можете увидеть такие инструкции: Нажмите Edit в строчке О Ярмарке (Edit будет выделено курсивом, однако О Ярмарке не будет выделено, потому что страница О Ярмарке была создана в предыдущей теме).
- URL, имена файлов и новые введенные термины также будут выделены italics.
Текст который вам следует ввести в командной строке будет написан
моношириннымшрифтом, например:drush cache:rebuild
- На протяжение руководства, слово directory будет всегда использоваться для указания на папки с файлами (которые некоторые пользователи называют folders).
Чтобы сделать большинство задач этого руководства, вам будет необходимы указания на одну или несколько страниц в пользовательском интерфейсе вашего сайта. Вы можете посмотреть похожие указания в инструкциях (это будет иметь больше смыслы после того как вы установите Drupal):
В Manage меню администратора, перейдите на Structure > Taxonomy (admin/structure/taxonomy).
Инструкции по переходам на подобие вышеуказанных предполагают что вы установили Toolbar модуль из ядра Drupal и этот пример означает что у вас есть верхнее меню администратора на вашем сайте, вы сможете выбрать Manage, чтобы раскрыть меню, затем нажмите Structure, и выберите Taxonomy и в после этого, вы перейдете на страницу с URL http://example.com/admin/structure/taxonomy (если адрес вашего сайта http://example.com).
Еще один пример:
В Manage меню администратора, перейдите на Configuration > System > Basic site settings (admin/config/system/site-information).
В этом примере, после нажатия на Manage и Configuration, вы сможете найти System раздел на странице и затем нажать Basic site settings. После чего вы попадёте на: http://example.com/admin/config/system/site-information.
Еще одно замечание: если вы используете стандартную тему администрирования Seven, многие кнопки "Добавить" в пользовательском интерфейсе отображаются со знаком плюс + на них. Например, на admin/content, кнопка Добавить новый контент появляется как + Add new content. Однако, это зависит от темы оформления и не является частью текста кнопки (например, это не обязательно появится на всех устройствах), так что в этом руководстве, мы не заостряем внимание на знаке плюса на кнопках.
Многие задачи в этом руководстве включают шаги где вам нужно заполнить форму. В большинстве случаев, скриншоты этих форм будут добавлены в текст, также как и таблицы со значениями, которые вы должны ввести в каждое поле формы. Например, вы можете увидеть таблицу которая начинается как показано ниже, в качестве объяснения формы основных настроек сайта, формы которую вы можете увидеть если перейдете на Configuration > System > Site information (admin/config/system/site-information):
| Имя поля | Объяснение | Примерное значение |
|---|---|---|
Настройки сайта > Имя сайта | Название вашего сайта | Ярмарка города N |
Используя эту таблицу, вы можете найти поле Site name в форме раздела с названием Site details и ввести имя вашего сайта в этом поле. Как пример имя сайта "Ярмарка города N" предложенное в таблице, которое относится к сценарию создания сайта городской ярмарки, который мы будет создавать в различных темах этого руководства (смотрите Раздел i.6, «Основной сценарий» для больше информации). Также заметьте что в некоторых формах, вы должны будете нажать на заголовок раздела (как например в Site details), чтобы раскрыть раздел и найти поле, которое в нем содержится.
Авторы
Написано/отредактировано Jennifer Hodgdon.
Переведено Абраменко Иван из DrupalBook.
Source file: preface-conventions.asciidoc
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
