blog.keiruaprod.fr

This repositoy hosts my technical blog hosted on blog.keiruaprod.fr.

WIP articles

Pretty much many things in the messy _draft directory.

Edition process

jekyll-compose helps to streamline the editing process

$ make serve
# Create a new draft
$ make draft title="test"
# Publish
$ make publish file="_drafts/test.md"
# Deploy
$ make deploy

Todo:

• integrate social cards
• add contribution link
• generate code social cards from code
• generating blog post file (eg http://www.guyroutledge.co.uk/blog/automate-jekyll-post-creation-with-thor)
• generate empty social cards from site title
• html-proofer
• fix issues ;)
• add author card
• better i18n (https://github.com/untra/polyglot ?)
• add sitemap (https://github.com/jekyll/jekyll-sitemap ?)
• see SEO tags https://github.com/jekyll/jekyll-seo-tag/blob/master/docs/usage.md ?
• add/write a linter (https://github.com/plainionist/Plainion.JekyllLint)

Tools

The blog uses Jekyll The theme is Contrast.

Validation

html-proofer helps to ensure the generated HTML is valid. It is available as a rake task.

bundle exec rake test

Social cards

Code samples are generated with carbon-now. You need yarn, and node.

$ yarn global add carbon-now-cli

When you have it, you can run a script that will generate all the missing

python generate-social-cards.py