Go to file
2020-04-13 08:08:17 +02:00
_drafts
_includes
_layouts
_posts ~ fully reverted to jekyll-paginate for now 2020-04-11 23:12:24 +02:00
_sass
assets
docs ~ updated repo link (not .github.io anymore) 2020-04-13 08:08:17 +02:00
.editorconfig
.gitignore ~ finalizing merge 2020-04-12 09:10:05 +02:00
.gitmodules
.nojekyll ~ finalizing merge 2020-04-12 09:10:05 +02:00
_config.yml ~ config now has the setting for the 'docs/' output by default 2020-04-13 08:07:35 +02:00
about.md ~ updated repo link (not .github.io anymore) 2020-04-13 08:08:17 +02:00
articles.html
Gemfile ~ fully reverted to jekyll-paginate for now 2020-04-11 23:12:24 +02:00
index.html ~ finalizing merge 2020-04-12 09:10:05 +02:00
LICENSE
README.md ~ config now has the setting for the 'docs/' output by default 2020-04-13 08:07:35 +02:00
tags.html

Source code for https://www.nicolabs.net

Previewing locally

Run bundle exec jekyll serve --livereload --drafts to start a local server with live reload and drafts preview.

Drafts

Jekyll drafts (articles in _drafts/) are absolutely not ready for publication. Some of them in _drafts/ are still old documents I've never finished... On the other hand, articles tagged with draft are published with a special mention so that they hopefully can be useful to anybody : old drafts are slowly being published with this draft mention. There are other mentions (unpublished, draft, good, stable, deprecated) to indicate articles' maturity.

See Migrating from Drupal to Jekyll for the explanation. Most of the code lies in _includes/maturity.html and _sass/nicolabs/*.scss in order to :

  • display the maturity label in each article's header
  • advertise unstable articles in indexes (index.html, tags.html)
  • remove drafts from the default feed

Publishing

  1. Update Ruby gems & build the final site without drafts :

    sudo bundle update bundle exec jekyll serve

  2. Add, commit & push files into the master git branch, including the docs directory (same as Jekyll's _site directory, but renamed for github pages)

See Bypassing GitHub's Jekyll limitations for more informations.