навигация выше

Как создается сайт на Github Pages. Простой сложный Jekyll

Здесь краткая инфа по markdown - упрощенному языку разметки документов. Он компилится в HTML. Но в нескомпилированном виде сохраняет человекочитаемость.

Общее

Здесь немножко о переменных и других програмных фишках, которые использует компилятор страниц на GitHub Pages.

При публикации страниц на Github Pages - HTML так и остается в исходном формате, а вот Markdown-файлы преобразовываются в HTML.
Преобразование происходит с помощью Jekyll - это генератор статических сайтов. Широко используется там где не нужно динамически менять контент. Позволяет сэкономить тонну ресурсов на поддержание сервера.

Существуют аналоги: Например Hugo. (больше можете нагуглить)
Все они как и Jekyll могут быть установлены на локальную машину для преобразования локальных файлов в HTML пригодный для публдикации. Но я считаю что Markdown уже пригоден для публикации, это его основная фишка - сохранение читаемости в нескомпилированном виде. А поэтому предпочитаю предоставить процесс сборки страниц серверам ГитХаба. Тем более это бесплатно и дает преимущество в виде возможности исполшьзовать сам GitHub в качестве CMS для ручного редактирования контента на сайте с любого устройства где есть браузер.

В Jekyll и на Github Pages можно менять предпочтительный метод компиляции файлов markdown путем изменения конфигурации в файле _config.yml. Я оставил kramdown, поскольку лень.

Шпаргалка Markdown

Markdown — это облегченный язык разметки, призванный облегчить подготовку текстов для публикации в Интернете. Был создан для удобства чтения и написания размеченных текстов. Движок markdown генерирует валидный XHTML. Авторы - John Gruber и Aaron Swartz. Собственно, Markdown — это простой текст.

Jekyll использует markdown нативно, вообще данный язык разметки очень любят на GitHub, используют его везде, где только можно (и в комментариях, и в отчетах, и в readme файлах). Данный блог использует jekyll, потому этот пост - это маленькая шпаргалка по Markdown.

Синтаксис

Оригинальное описание синтаксиса находится здесь (англ.): http://daringfireball.net/projects/markdown/syntax

Ниже следует краткое описание синтаксиса.

Таблицы:

    | First Header  | Second Header |
    | ------------- | ------------- |
    | Row1 Cell1    | Row1 Cell2    |
    | Row2 Cell1    | Row2 Cell2    |  

Результат:

First Header Second Header
Row1 Cell1 Row1 Cell2
Row2 Cell1 Row2 Cell2

Наглядная визуальная шпаргалка: image_picker4286818869274656233

Полезные ссылки