Перейти к содержанию

Книга проекта

Функционал доступен на gitflic.ru


Книга проекта позволяет создать подробную документацию из вашего проекта. Данную документацию можно создать как в виде отдельного репозитория, так и в самом проекте.

Для создания книги перейдите в настройки проекта и откройте вкладку "Книга". Добавьте текстовый идентификатор для вашей книги и нажмите "Создать". Вам будет доступна ссылка на вашу книгу, можете добавлять ее к описанию проекта, чтобы пользователи имели прямой доступ к вашей книге.

Для инициализации страницы с книгой в проект необходимо добавить 2 файла: README.md для главной страницы SUMMARY.md для создания оглавления.

Оформление SUMMARY.md

SUMMARY.md наполняется следующим образом: в файле могут присутствовать заголовки и обязательно ссылки на файлы, указанные разметкой Markdown. пример оформления оглавления ниже

# Документация 

* [Введение](README.md)

## Раздел 1
* [Статья 1](file1.md)
* [Статья 2](file2.md)
* [Подраздел]()
    * [Статья 3](folder/file3.md)
    * [Статья 4](folder/file4.md)

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