Skip to main content

Эта версия GitHub Enterprise Server была прекращена 2024-03-26. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Создание повторно используемых содержимого

Вы можете создать повторно используемый контент, на который можно ссылаться в нескольких файлах содержимого.

Сведения о повторно используемых возможностях

Повторное использование — это длинные строки многократно используемых текста, например абзацы или процедурные списки, на которые можно ссылаться в нескольких файлах содержимого.

Для повторного использования мы используем 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 %}.