Ottmar Gobrecht, Markus Dötsch
DOAG Konferenz 2017, Nürnberg
Oder zumindest bewahren :-)
Hürden minimieren
Context Switches vermeiden
Nicht als extra Teil ansehen
wie GitHubDesktop oder Editoren wie Atom
Genauer: Ein Ruby Skript
Geschwindigkeit dynamisch - DSL
87 Requests - 1,3 MB - 2,7 s Ladezeit
Geschwindigkeit statisch - DSL
2 Requests - 5 KB - 0,1 s Ladezeit
Geschwindigkeit dynamisch - mobil 3G
86 Requests - 1,3 MB - 36,3 s Ladezeit
Geschwindigkeit statisch - mobil 3G
2 Requests - 5 KB - 4,2 s Ladezeit
Ein DokuWiki, das längerer Zeit nicht aktualisiert wurde...
Vornehmlich zur HTML Erstellung
Ohne Konvertierung leicht les- und schreibbar
# Eine Überschrift der ersten Ordnung
## Eine Überschrift zweiter Ordnung
Ein Absatz mit *kursivem Text* , **fettem Text** und
einer ***Kombination aus fett und kursiv***.
- Ein Aufzählungspunkt
- Noch einer
- Ein Unterpunkt
[Ein Link](https://daringfireball.net/projects/markdown/syntax)
![Ein Bild](./assets/john-gruber.png)
HTML = Publikations-Format
Markdown = Schreib-Format
Beispiel: Editor Atom mit Plugin Markdown-Writer
_data/authors
_config.yml
/posts/:year-:month-:day-:title
Für Neugierige und "Selbermacher"
gem install bundler
Im (übergeordneten) Projektverzeichnis:
git clone yourForkedRepoURL.git
Das lokale Verzeichnis wird automatisch angelegt
cd yourForkedRepoName
bundle install
"bundle install" installiert alle Abhängigkeiten für Jekyll, die im
"Gemfile" konfiguriert sind - siehe Projektverzeichnis
Automatischer Refresh bei Änderungen
bundle exec jekyll serve
Server ist unter http://127.0.0.1:4000 aufrufbar
Einmaliger Refresh
bundle exec jekyll build
git push yourForkedRepoURL.git
bundle update
_posts
yyyy-mm-dd-post-titel.md
---
title: Dr. Jekyll and Mr. Markdown - Bloggen für Entwickler
subtitle: DOAG Konferenz 2017, Nürnberg
categories: [slides]
tags: [jekyll, markdown]
author: [ogobrecht, madtsch]
lang: de
last_modified_at: 2017-11-12
---
Hier kommt dann der eigentliche Artikel...
.
├── _config.yml
├── _data
| └── members.yml
├── _drafts
| ├── begin-with-the-crazy-ideas.md
| └── on-simplicity-in-technology.md
├── _includes
| ├── footer.html
| └── header.html
├── _layouts
| ├── default.html
| └── post.html
├── _posts
| ├── 2007-10-29-why-every-programmer-should-play-nethack.md
| └── 2009-04-26-barcamp-boston-4-roundup.md
├── _sass
| ├── _base.scss
| └── _layout.scss
├── _site
├── .jekyll-metadata
└── index.html # can also be an 'index.md' with valid YAML Frontmatter
Markdown Link Syntax & Liquid Tag "link"{{ site.baseurl }}
ist je nach Konfiguration optional
[Link to a post]({% link _posts/2016-07-26-name-of-post.md %})
[Link to a page]({{ site.baseurl }}{% link news/index.html %})
[Link to a file]({% link /assets/doc.pdf %})
Nur mit Markdown...
[Link to a post](/posts/2016-07-26-name-of-post.html)
[Link to a page]({{ site.baseurl }}/news/index.html)
[Link to a file](/assets/doc.pdf)
Wo ist der Unterschied?
"link" Tag sorgt für korrekte Permalinks! Jekyll Doku: Links
Beispiel: Reveal.js Integration
Was uns hilft: Jekylls Übersichtlichkeit und Anpassbarkeit
Jekylls Template Engine
index.md
für Reveal.jsslides.md
für Folieninhalte (ohne Front Matter)/assets/reveal.js
path