Yet Another Static Site Generator Генератор статичных сайтов из Markdown. Цель — максимальная совместимость с Obsidian
| .gitverse/workflows | ||
| cmd | ||
| internal | ||
| scripts | ||
| templates | ||
| .dockerignore | ||
| .gitignore | ||
| .golangci.yml | ||
| .goreleaser.yaml | ||
| config_example.yaml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| Makefile | ||
| README.md | ||
YASSG
Yet Another Static Site Generator
Простой генератор статических сайтов. Основная цель — совместимость с форматом Obsidian.
Установка
go install gitrepo.ru/neonxp/yassg@latest
Конфигурация
YASSG поддерживает несколько способов конфигурации с различными приоритетами:
- Флаги командной строки (наивысший приоритет)
- Переменные окружения
- Конфигурационный файл
- Значения по умолчанию (низший приоритет)
Флаги командной строки
--config- путь к конфигурационному файлу--log-level- уровень логирования (debug, info, warn, error)
Переменные окружения
Переменные окружения должны начинаться с префикса YASSG_. Например:
YASSG_VAULT=./dataYASSG_OUTPUT=./publicYASSG_SERVER_LISTEN=:8000YASSG_LOGGING_LEVEL=debug
Конфигурационный файл
Конфигурационный файл может быть расположен в следующих местах (в порядке приоритета):
- Текущая директория (
./config.yaml) - Пользовательская директория (
~/.config/yassg/config.yaml) - Системная директория (
/etc/yassg/config.yaml)
Пример конфигурационного файла смотрите в config_example.yaml.
Использование
Создание конфигурационного файла
# Интерактивное создание конфигурационного файла
yassg init
Генерация сайта
# Генерация с конфигурацией по умолчанию
yassg generate
# Генерация с указанным конфигурационным файлом
yassg generate --config ./my-config.yaml
# Генерация с уровнем логирования debug
yassg generate --log-level debug
Запуск веб-сервера
# Запуск сервера с конфигурацией по умолчанию
yassg serve
# Запуск сервера с указанным конфигурационным файлом
yassg serve --config ./my-config.yaml
# Запуск сервера с уровнем логирования debug
yassg serve --log-level debug
После генерации появится директория public, которую можно загрузить на веб-сервер.
Лицензия
Этот проект распространяется под лицензией GNU General Public License v3.0. Смотрите файл LICENSE для подробной информации.