Сведения о повторно используемых возможностях
Повторное использование — это длинные строки многократно используемых текста, например абзацы или процедурные списки, на которые можно ссылаться в нескольких файлах содержимого.
Для повторного использования мы используем Markdown (вместо YAML). Markdown позволяет конвейеру локализации разделить строки на более мелкие переведенные сегменты, что приводит к меньшему числу ошибок перевода и меньшему объему обработки при изменении исходного содержимого английского языка.
Каждый повторно используемый файл живет в собственном файле Markdown.
Путь и имя файла каждого файла Markdown определяет, какой путь будет находиться в объекте данных. Например, именованный /data/reusables/foo/bar.md файл будет доступен как {% data reusables.foo.bar %} на страницах.
Повторно используемые файлы обычно делятся на каталоги по задачам. Например, если вы создаете повторно использованную строку для статей о уведомлениях GitHub, вы добавите его в каталог data/reusables/notifications/в файл с именем data/reusables/notifications/YOUR-REUSABLE-NAME.md. Ссылка на содержимое, которую вы добавите в источник, будет выглядеть следующим {% data reusables.notifications.YOUR-REUSABLE-NAME %}образом.
Применение управления версиями для повторно используемых компонентов
Для повторного использования можно включить условные условия Liquid для условной отрисовки содержимого в зависимости от текущей версии, просматриваемой.
Сведения о переменных
Переменные — это короткие строки многократно используемого текста.
Мы используем файлы YAML для переменных.
Переменные path, filename и keys в каждом файле YAML определяют его путь в объекте данных.
Например, этот ФАЙЛ data/variables/foo/bar.ymlYAML содержит две переменные:
# the YAML file can contain multiple short strings in one file
meaning_of_life: 42
# the strings can also be nested if needed
nested:
values:
too: Yes!
Значения будут доступны как {% data foo.bar.meaning_of_life %} и {% data foo.bar.nested.values.too %}.