Skip to content

Commit

Permalink
поправил ссылку
Browse files Browse the repository at this point in the history
  • Loading branch information
Starkovden committed Aug 6, 2019
1 parent 876fca1 commit 8c8ed08
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion Publishing-doc/Static-site-generators.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@
Время сборки - серьезное преимущество в скорости, которое позволит масштабировать сайт документации надежными способами. Автор (чьи документы находятся на [https://docs.mendix.com](https://docs.mendix.com/)) переключился с Jekyll на Hugo (см. [Обзор документов в GitHub](https://github.com/mendix/docs)). Его переход предполагает, что скорость, возможно, является основной характеристикой для оценки в генераторах статичных сайтов.

Разница между Hugo и Jekyll потребует от подумать о размере проекта - насколько большим должен быть проект? Должен ли быть один гигантский проект с контентом для всей документации/продуктов, хранящихся в одном репозитории? Или это будут несколько небольших репозиториев? Вот некоторые из соображений, с которыми Том Джонсон сталкивался при [реализации инструментов docs-as-code](Doc-as-code.md#integration). Он пришел к выводу, что иметь один масштабный проект предпочтительнее, потому что он позволяет упростить повторное использование контента, адаптацию, валидацию и проверку ошибок, управление развертыванием и многое другое.
Разница между Hugo и Jekyll потребует от подумать о размере проекта - насколько большим должен быть проект? Должен ли быть один гигантский проект с контентом для всей документации/продуктов, хранящихся в одном репозитории? Или это будут несколько небольших репозиториев? Вот некоторые из соображений, с которыми Том Джонсон сталкивался при [реализации инструментов docs-as-code](Doc-as-code-tools.md#integration). Он пришел к выводу, что иметь один масштабный проект предпочтительнее, потому что он позволяет упростить повторное использование контента, адаптацию, валидацию и проверку ошибок, управление развертыванием и многое другое.

Что касается скорости сборки, в Jekyll есть обходные пути для ускорения сборки. В своих рабочих проектах документации (где 1500 страниц или около того в разных наборах документации) были реализованы ярлыки сборки. Каскадными файлами конфигурации можно ограничить сборки одним конкретным каталогом документов. Есть один файл конфигурации (например,` _config.yml`, по умолчанию), который устанавливает все содержимое как `publish: true`, и другой файл конфигурации (например, `config-acme.yml`), который устанавливает все содержимое как `publish: false`, за исключением конкретного документа. каталог (тот, с которым я работаю, например, acme). При работе с каталогом acme doc, Jekyll собирается следующим образом:

Expand Down

0 comments on commit 8c8ed08

Please sign in to comment.