Для сборки сайта из markdown
файлов используется генератор статических сайтов MkDocs.
С синтаксисом markdown можно ознакомиться здесь.
- Форкните проект, создайте новую ветку и начинайте работу.
- Когда работа будет готова — проверьте локально что сайт собирается и запушьте ветку в репозиторий.
- Создайте Pull Request в master.
Пошаговые инструкции:
- От GitHub, на английском: Creating a pull request
- На русском GitHub - Внесение собственного вклада в проекты
Для локальной сборки сайта необходимо установить:
- python 3+
- зависимости проекта
Для установки зависимостей проекта используйте команду
pip install -r requirements.txt
Запустить проект:
python -m mkdocs serve
Нужны:
- docker
- docker-compose
А дальше запускаете:
docker-compose up --build
Или можете просто установить Obsidian и в нём редактировать и сразу видеть отрендеренный Markdown.
,-. _,---._ __ / \
/ ) .-' `./ / \
( ( ,' `/ /|
\ `-" \'\ / |
`. , \ \ / |
/`. ,'-`----Y |
( ; | '
| ,-. ,-' | /
| | ( | | /
) | \ `.___________|/
`--' `--'