blip

Blip - генератор статического блога Swift/Markdown

Предварительные условия

Blip использует конкретную структуру каталогов для шаблонов и организации сайта. См example-site/ каталог для демонстрации или прочитайте для полного описания.

Шаблоны

Шаблоны - это руководства для макета для ваших сайтов индекса и публикации страниц. Ниже приведено в config/templates/ :

• index_template.html : основные страницы индекса вашего сайта.

• index_post_template.html : макет предварительного просмотра POST на страницах индекса.

• post_template.html : макет отдельной страницы поста.

Особые токены

Blip использует некоторые пользовательские «токены» для общих задач и замены текста. Используйте Config.swift для настройки строк замены.

Markdown (сообщения):

• [[MORE]] : разбивает пост на этой точке в index*.html страниц и вставляет ссылку Read More в полное сообщение.

Шаблоны:

• $(COPYRIGHT) : встает пользовательская строка авторского права в шаблон индекса.

• $(POSTS) : вставьте список пост -фрагментов в шаблон индекса.

• $(POSTS_OLDER) : встает ссылку «Старые сообщения» в шаблон индекса.

• $(POSTS_NEWER) : вставляет ссылку «новые сообщения» в шаблон индекса.

• $(POST_TITLE) : вставьте заголовок POST в шаблон POST или INDEX.

• $(POST_TIMESTAMP) : вставка Post TimeStamp в пост или шаблон индекса.

• $(POST_BODY) : вставка корпуса Post в шаблон Post или Index (шаблон индекса будет отображаться до любого токена [[MORE]] ).

• $(POST_PERMALINK) : вставьте почту постоянную ссылку в шаблон поста или индекса.

Посты

Имена файлов

Сообщения должны быть в формате Markdown, и должны следовать соглашению о именовании YYYYMMDD.md (также поддерживается расширение файла .markdown ).

Структура каталога

posts/ каталог должны содержать как минимум два субзаректория:

• drafts : Здесь вы должны разместить свои файлы Markdown (.md) для публикации.

• published : BLIP будет генерировать HTML index*.html и Pust Pages в этом каталоге. Вы должны использовать содержимое этого каталога для вашего сайта.

Опубликованные сообщения организованы в соответствии с датой в их имени файла. Так, например, пост с именем файла 20171220.md будет опубликована по следующему пути: posts/published/2017/12/20.md . В настоящее время Blip поддерживает только один пост в день, в основном потому, что я не часто блог ...

Стили -листы и изображения

• published/stylesheets/ : Шаблоны по умолчанию используют включенный index.css в качестве таблицы стилей. Вы можете оставить другие файлы CSS здесь и ссылаться на свои шаблоны, если это необходимо,

• published/images/ : Отбросьте свои изображения здесь, и вы можете ссылаться на них в Markdown следующим образом : ![image](/images/someimage.jpg)

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

Напишите свой пост в Markdown, с правильным соглашением о имени файла ( YYYYMMDD.md ), а затем бросьте его в drafts/ каталог.

Затем запустите следующую команду:

 ./blip /path/to/your/blog/ -r

Аргументы

-r перестроивает весь сайт, публикуя все файлы разметки в drafts/ каталоге.

-w смотрит ваши drafts/ каталог для новых файлов разметки и автоматически публикует их.

-i только перестроить index*.html страниц.

-h отображает помощь.

Зависимости

• Swiftfswatcher

Простая простая в использовании / расширение наблюдателя файловой системы с помощью Swift.

• Вниз

Пылающий быстрый рендеринг в Swift, построенный на Cmark.

Живой пример

Посетите мой личный сайт для примера использования Blip.