Source code for https://www.nicolabs.net
sudo apt install ruby
sudo gem install jekyll jekyll-feed jekyll-gist jekyll-paginate jekyll-sass-converter jekyll-coffeescript
plantuml
command in the PATH (requirement of jekyll-plantuml) (and probably dot : sudo apt install graphviz
for Debian systems)make setup
(or look into Makefile
for the underlying commands)The assets/blog folder gathers asset files used in articles.
It keeps the same layout as the previous website located from http://www.nicobo.net/sites/default/files in order to ease migration of URLs, but the pictures
subfolder may not be used for new assets.
The new layout is :
3rdparty/ # local copy of remote pictures, some modified (e.g. resized)
\_ logos/ # icons & logos of third party products
\_ images/ # photos & pictures taken from external sources
screenshots/ # screen captures or alike used to illustrate some articles
Run the following to update Ruby gems & and start a local server with automatic reload and drafts preview :
make serve
Jekyll drafts (articles in _drafts/
) are absolutely not ready for publication. Some of them are still old documents I've never finished...
On the other hand, articles tagged with draft (in _posts/
) 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 :
index.html
, tags.html
)Drafts don't appear in the RSS feed, as this would trigger false updates until the article is ready for release (the publication date would change all the time). The current workaround is to put those articles in a preposts collection until ready.
I found it to be necessary to better display PlantUML diagrams.
This is implemented with :
<svg>
inside <object>
, which is not fullscreen-compatible OOTB => I replaced with <img>
using the generated SVG as source\
`plantuml
rather than Jekyll-specific {% plantuml %}
syntax should be foundBased on :
make build
docs
directory (same as Jekyll's _site
directory, but renamed for github pages)See Bypassing GitHub's Jekyll limitations for more informations.