Welcome to Ranke.2

visit the website. You can use the editor on GitHub to maintain and preview the content for your website in Markdown files.

Whenever you commit to this repository, GitHub Pages will run Jekyll to rebuild the pages in your site, from the content in your Markdown files.

Installation

Ranke.2 uses the docker image of Jekyll 4.2

Install and update gems:

  docker-compose run --rm bundle-install

then run the website locally

  docker-compose up

How to create a new page

in pages, create the default md file, in English, e.g. tutorials.md then create one md file per language, e.g. 'tutorials.de.md' and 'tutorials.fr.md'. It's Jekyll default way to build up pages. Pay attention to each file frontmatter, esp permalink, which is responsible for the generation of the corresponding html page. Always prepend the laguage in the permalink for non default language. The presence of permalink avoid to modify the TEMPLATE url of the config (error: The URL template doesn't have lang keys. Check your permalink template! (NoMethodError))

---
layout: collection
lang: fr
permalink: /fr/tutorials/
link: /tutorials/
title: Tutorials
collection: tutorials
---

Jekyll Cheatsheet

Published by @rstacruz, a clear insight on how jekyll works. https://devhints.io/jekyll

Jekyll Themes

This website uses the layout and styles from the Jekyll theme selected in the repository settings. The name of this theme is saved in the Jekyll _config.yml configuration file.

Markdown

Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for

Syntax highlighted code block

# Header 1

## Header 2

### Header 3

- Bulleted
- List

1. Numbered
2. List

**Bold** and _Italic_ and `Code` text

[Link](url) and ![Image](src)

For more details see GitHub Flavored Markdown.