menimal

Менимал?

Menimal — это минимальный генератор статических сайтов .

Сосредоточьтесь на контенте: просто пишите файлы разметки, стили CSS, а все остальное генерируется за вас.

Menimal минимален по дизайну:

• Нет javascript (нет package.json )
• Нет HTML-шаблонов
• Нет mdx
• Никакого SEO или метаданных

---

• Начиная
  • Развертывать
• Структура папок
  • pages
  • static
  • config.json
  • style.css
• Дорожная карта
• Лицензия
• Примечания
  • Другие генераторы статических сайтов
  • Разработка
  • Выполнение

Начиная

Menimal — это единственный скрипт npx , который можно запускать откуда угодно, не устанавливая какой-либо пакет.

Убедитесь, что на вашем компьютере установлен NodeJs.

Вам просто нужно запустить одну команду:

npx menimal

Это создаст папку build содержащую ваш статический веб-сайт.

Развертывать

Платформы хостинга позволяют определить команду сборки и папку вывода:

• Команда сборки: npx menimal
• Выходная папка: build

Вот и все. Вы можете использовать Menimal везде?

---

Структура папок

Menimal требует точной структуры папок:

• pages : содержит файлы уценки ( .md ).
• static : содержит статические файлы ( robots.txt , fonts , favicon.ico )
• config.json : содержит конфигурацию сайта (минимальная).
• style.css : содержит стили (один файл CSS)

См. полный и рабочий пример в папке с примерами.

pages

Каждый файл уценки будет соответствовать странице .html на веб-сайте.

Имя файла .md используется для создания как имени HTML-файла, так и заголовка страницы:

• HTML-файл: такой же, как .md со всеми строчными буквами.
• Заголовок: то же, что и .md - заменен пробелами.

Например, This-is-the-Title-of-the-article.md сгенерирует:

• HTML: this-is-the-title-of-the-article.html
• Название: Это заголовок статьи.

static

Все файлы внутри static будут скопированы в финальную сборку.

Здесь вы можете добавлять изображения, шрифты, robots.txt , favicon.ico , sitemap.xml или что-нибудь еще ??‍♂️

config.json

На данный момент для конфигурации требуется одно поле: имя веб-сайта, отображаемое в <header> :

{
  "name" : " Sandro Maglione "
}

style.css

Все стили определены в одном файле CSS .

Вы можете просмотреть сгенерированную структуру HTML каждого файла внутри шаблонов.

Этот файл будет минимизирован и импортирован на каждую сгенерированную страницу.

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

• Предварительная загрузка шрифтов в HTML

 < link rel =" preload " href =" font.woff2 " as =" font " crossorigin type =" font/woff2 " > 

Лицензия

Лицензия MIT, подробности см. в файле LICENSE.md.

---

Примечания

Этот проект является частью моего еженедельного информационного бюллетеня на сайте sandromaglione.com .

Другие генераторы статических сайтов

• Гексо
• Джекилл
• Хьюго

Разработка

• Используйте npx --loglevel silly .. из папки example для отладки команды npx

Выполнение

Все подробности реализации прочитать в полной статье ?