kicad website
1.0.0
Это источник нового веб -сайта Kicad, Anno 2015.
Репозиторий Kicad-Website имеет двойную лицензию. Вы можете распространять его и/или изменить его в соответствии с условиями общей публичной лицензии GNU (http://www.gnu.org/licenses/gpl.html), версии 3 или более поздней лицензии, либо лицензии на атрибуцию Creative Commons (http://creativecommons.org/licenses/by/3.0/), версия 3.0 или позже.
Вам понадобятся эти пакеты:
Hugo версия 0.69.0 (вы должны использовать эту версию!)
Руби (чтобы использовать Asciidoctor)
Asciidoctor версия 2.0.10
Использование Asciidoctor является требованием, потому что оригинальный Asciidoc использует проблемы с проблемами, проведя файлы ADOC с заголовками TOML в них. Asciidoctor также имеет несколько дополнительных функций для веб -страниц.
Выполните команду Hugo в корне репозитория для создания и обслуживания файлов для разработки:
Hugo Server -w -v
Соблюдайте вывод консоли, так как он сообщит вам адрес, где страница доступна в браузере. Флаг -W говорит ему, чтобы посмотреть файловую систему для изменений для автоматической восстановления. Кроме того, страница в браузере будет AutoreFresh после успешного завершения восстановления.
Пожалуйста, прочитайте рекомендации по внесению вклад
Включен DockerFile, который создает и пакетов на веб -сайте с помощью экземпляра nginx
Чтобы иконки появлялись в блоках предостережения, вы должны добавить
:icons:
:iconsdir: /img/icons/В верхней части файла Asciidoc, но под заголовком шаблона Hugo.
Пожалуйста, назовите любые многоразовые файлы asciidoc с ведущим подчеркиванием в имени файла и заканчивая. Хьюго настроен на то, чтобы игнорировать такие файлы специально.
Чтобы немного повысить безопасность, мы внедряем заголовки с политикой контента-безопасность, которые установлены Nginx. Они диктуют браузеру, какие пути ресурса допустимы для сценариев, видео, изображений и т. Д., И хотя мы используем HTTPS, CSP - это просто еще один инструмент для потенциального остановки стороны браузера и других атак.
Это означает: 1. Пожалуйста, добавьте любые изображения, JS и CSS непосредственно в это репо. Для нас гораздо лучше отразить их, чтобы не поступить в будущее. Особенно сторонние изображения 2. Пожалуйста, приложите наилучшие усилия, чтобы использовать существующие «утвержденные» удаленные ресурсы в качестве Visibile в /.docker/default.conf 3. Если вы заметите, что ресурс не загружает то, что вы редактируете, проверьте вывод инструментов разработчика для вашего браузера, если он заблокирован из -за CSP, это скажет об этом.
