static site generators

Разница между сайтом и блогом на Николе — два места в файле настроек conf.py.

1. Главное

PAGES = (
    ("pages/*.rst", "", "story.tmpl"),
    ("pages/*.txt", "", "story.tmpl"),
    ("pages/*.html", "", "story.tmpl"),
)

Здесь важно, что в середине в кавычках — пусто. Поэтому страницы сайта (создаваемые из того, что лежит в папке pages при таком конфиге) пойдут не в специальную папку (которая могла быть в этих кавычках указана), а в корень сайта. Страница index.html, будущая главная страница сайта — тоже.

1. Второстепенно, но если не сделать, будет ошибка.

INDEX_PATH = "blog"

Важно, что не index. Какое другое имя поставить, blog, abracadabra или insert-your-word-here — пофиг. Лишь бы не было одноименной страницы. Если будет, никола будет честно выдавать ошибку, и отказываться решать за вас, какую именно страницу тут показывать — сгенерированный им индекс вашего блога или вашими руками сделанную.

• https://getnikola.com/creating-a-site-not-a-blog-with-nikola.html
• https://getnikola.com и https://themes.getnikola.com, https://github.com/getnikola/nikola

• https://getnikola.com/documentation.html - документация.
• http://docs.makotemplates.org/en/latest/ - шаблоны на mako.

Темы не применяются. Полбеды, что remote_theme не работает, странно, когда не работают основные.

Совет про Customizing your theme's CSS со страницы https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll - не работает, выдаёт ошибку.

Заинтересовавшие темы.

• https://github.com/raghudotcc/simply-jekyll
• https://github.com/Jekyll-Garden/jekyll-garden.github.io

Использую на github (http://ladykosha.github.io/).

Похоже, что excerpt работает только с постами, кусок странички добыть не получается. Возможно, стоит всё писать как посты. Или наоборот.

Список таймзон - https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. Угадывать вредно.

Cтартовую тему обгрызла до состояния «теперь я знаю, что тут откуда». Ну, более-менее.

Одна из гениальных идей в основе Jekyll: что любой нормальный статический сайт - нормальный Jekyll project.

• jekyll new myblog - создать новый бложик в папке myblog
  • jekyll new myblog –blank - c особо чистого листа.
  • jekyll new –help - а какие у меня есть варианты?
• jekyll serve - предпросмотр существующего сайтика, вероятно на http://127.0.0.1:4000/, впрочем, об этом jekyll честно пишет в консольке.

Any file in /assets will be copied over to the user’s site upon build unless they have a file with the same relative path. You can ship any kind of asset here: SCSS, an image, a webfont, etc. These files behave like pages and static files in Jekyll:

If the file has YAML front matter at the top, it will be rendered. If the file does not have YAML front matter, it will simply be copied over into the resulting site. This allows theme creators to ship a default /assets/styles.scss file which their layouts can depend on as /assets/styles.css.

All files in /assets will be output into the compiled site in the /assets folder just as you’d expect from using Jekyll on your sites.

Your theme’s stylesheets should be placed in your theme’s _sass folder, again, just as you would when authoring a Jekyll site.

Your theme’s styles can be included in the user’s stylesheet using the @import directive.

• https://jekyllrb.com/docs/home/ - документация, в т.ч.
  • http://jekyllrb.com/docs/configuration/ - возможность устанавливать дефолтные настройки в конфиге
  • https://jekyllrb.com/docs/variables/ - переменные
• http://jekyllthemes.org - темы для jekyll, может, присмотрю что. А скорее источник для того, чтоб смотреть «как это сделать».
• http://mrskat.com/posts/jekyll/ - симпатичный блог на jekyll, мб стоит взять за образец
• https://docs.github.com/categories/customizing-github-pages - github-pages и jekyll.
• https://github.com/jekyll/jekyll/wiki/Liquid-Extensions
• https://github.com/Shopify/liquid/wiki/Liquid-for-Designers (Liquid - templating engine джекила)
• https://docs.github.com/articles/creating-a-custom-404-page-for-your-github-pages-site/
• https://docs.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
• https://docs.github.com/

• https://gist.github.com/WouterJ/4945964 - How to use Jekyll, Plugins and Sass on GitHub Pages. Вынырнуло из давнего текста, мб неактуальное.