Дока — это добрая энциклопедия для веб-разработчиков. Наша цель — сделать документацию по веб-разработке практичной, понятной и не унылой.
Этот репозиторий содержит платформу для сайта «Дока». Платформа собирает статьи из отдельного репозитория.
Сайт «Доки» работает на базе Eleventy. При помощи Nunjucks-темплейтов Eleventy превращает статьи в формате Markdown в HTML-страницы.
Проект собирается с помощью GitHub Actions и хостится на Netlify, читайте подробнее про деплой.
Для работы с платформой вам потребуется Node.js v14 и NPM v6.
Чтобы запустить Доку локально, нужно:
- Скачать репозиторий.
- Установить зависимости командой
npm i
. - Запустить локальный веб-сервер командой
npm start
.
Больше вариантов локального запуска Доки — в руководстве по запуску.
Код распространяется по лицензии MIT, шрифты имеют собственные лицензии, подробнее читайте в документации.