jekyll.md

layout	title
default	Jekyll

Jekyll Doku

Jekyll ist ein Ruby Programm und baut die Website, auch auf Github.

• Empfehlung: am MD-Dateianfang immer FrontMatter (2 Zeilen mit ---), sonst keine Verarbeitung von Liquid Template Variablen am besten, nach Erstellung von _layouts/default.html:

  ---
  layout: default
  title: Wasauchimmer
  ---
  

• Auch SCSS-Dateien brauchen ein leeres solches FrontMatter am Anfang zwecks Preprocessing.

• Troubleshoot: z.B. steht im FrontMatter statt title: Markdown nur Markdown, dann in Settings website compile problems
  siehe Troubleshoot Guide

• der Pfad / oder /about.html in _data/nav.yml bezieht sich leider auf https://herbbetz.github.io und nicht auf https://herbbetz.github.io/ct-mai-2020/.

In config.yml kann man das anpassen (https://jekyllrb.com/docs/configuration/):

baseurl: "/repository-name"

... was aber nur Effekt hat, wenn der Repository-Name per Liquid in _includes/_nav.html oder /blogs.html extra angehängt wird:

{% raw %}

 {% for item in site.data.nav %} 
    <a href="{{ site.baseurl |append: item.link }}" {% if page.url == item.link %}class="current"{% endif %}>
      {{ item.name }}
    </a>
  {% endfor %}

---

  {% for post in site.posts %}
    <li>
      <h2><a href="{{"/ct-mai-2020" |append: post.url }}">{{ post.title }}</a></h2>
      {{ post.excerpt }}
    </li>
  {% endfor %}

{% endraw %}

• Man kann in einem Markdown-Codeblock (3 Hochkommas) kein Liquid-Template-Code darstellen, ohne dass er ausgeführt wird. Verwende in {% raw %}{%...%}{% endraw %} die commands raw bzw. endraw.

• Plugins (.rb) sind nur im lokalen Jekyll zugelassen, also nicht auf Github mit diesen Ausnahmen: https://pages.github.com/versions/