jmmasw

Просто сделай меня статическим сайтом

Jmmasw - это простой инструмент для простой проблемы: статические сайты.

Операция

1. Загрузите все файлы с помощью расширения ".html" или ".tmpl"
2. Разобрать каждый файл в шаблон GO
3. Загрузите файл данных ("./data.json" по умолчанию)
4. Запустите все шаблоны с именем, которое заканчивается ".html"
5. Напишите вывод в файлы, если он не пуст

Использование

Jmmasw принимает следующие параметры командной линии:

• data - Расположение файла данных
• dir - расположение проекта, по умолчанию текущий каталог
• static-out -выходной каталог, по умолчанию ./jasw-out (для «просто статического веб-сайта»)
• ignore-no-data -по умолчанию к истине. Если установлено на False, то файл отсутствующего данных приводит к завершению программы

Здание

JMMASW строится с использованием GO1.8, поэтому вам следует с минимальной установкой GO1.8 для работы, но старые версии тоже могут работать (но без обещаний)

Для установки просто запустите следующие команды:

 go get go.rls.moe/jmmasw
go install go.rls.moe/jmmasw

Шаблоны

Для получения информации о формате шаблона см. Записи GODOC о html/template и text/template .

Шаблоны определяются их именем файла, но если вы определили вручную шаблоны, это не применяется.

Только шаблоны с именем, заканчиваемым в «.html», будут отображаться, файлы .tmpl будут анализироваться только и предназначены для общей функциональности.

Функции шаблона

• file принимает одну строку в качестве параметра и пытается прочитать указанную форму файла. Файл -система
• json анализирует данную строку в формат JSON, структура верхнего уровня должна быть картой, простые массивы не допускаются
• markdown рендерирует заданную строку в HTML с использованием процессоров Markdown без каких -либо дезинфекции (не используйте на пользовательских входах!)
• dict принимает любое количество пар клавишных значений с ключом типа строки и возвращает результат. Это позволяет объединить несколько переменных в один трубопровод

Дорожная карта

• Включите погрузчик Markdown и Markdown File Loader
• Функция для анализа дополнительных файлов .json из шаблонов
• Метод игнорировать конкретные каталоги
• Функция на выходные файлы, которые не присутствуют в виде шаблонов
  • Пример: index.html генерирует index-en.html и index-de.html вместо index.html

Подожди, что?

Если вам интересно, почему этот инструмент существует: я сделал это, чтобы я мог создать свой веб-сайт для нескольких языков, не копируя половину веб-сайта постоянно.

Я рассмотрел Hugo, который является отличным генератором статической страницы, но он также слишком сложный для этого приложения. Jmmasw работает с «RAW» HTML -шаблонами и не предполагает вашего веб -сайта.

Вы можете взять свой веб-сайт таким, какой он есть сейчас, и при условии, что он не содержит недействительного кода поездок, он выйдет на другой конец Jmmasw без изменений.