Перейти на сайт

Для сборки сайта из markdown файлов используется генератор статических сайтов MkDocs. С синтаксисом markdown можно ознакомиться здесь.

1. Форкните проект, создайте новую ветку и начинайте работу.
2. Когда работа будет готова — проверьте локально что сайт собирается и запушьте ветку в репозиторий.
3. Создайте Pull Request в master.

Пошаговые инструкции:

1. От GitHub, на английском: Creating a pull request
2. На русском GitHub - Внесение собственного вклада в проекты

Для локальной сборки сайта необходимо установить:

• python 3+
• зависимости проекта

Для установки зависимостей проекта используйте команду pip install -r requirements.txt

Запустить проект:

mkdocs serve

Нужны:

• docker
• docker-compose

А дальше запускаете:

docker-compose up --build

Или можете просто установить Obsidian и в нём редактировать и сразу видеть отрендеренный Markdown.

  ,-.       _,---._ __  / \
 /  )    .-'       `./ /   \
(  (   ,'            `/    /|
 \  `-"             \'\   / |
  `.              ,  \ \ /  |
   /`.          ,'-`----Y   |
  (            ;        |   '
  |  ,-.    ,-'         |  /
  |  | (   |            | /
  )  |  \  `.___________|/
  `--'   `--'