fmeulenk/hsd-os

Readme

Table of Contents

• Über dieses Repository
• Vorbereitungen für die Verarbeitung von Asciidoc
• Rendern von Asciidoc in PDF
• Rendern von Acciidoc+Reveal.js in HTML Slides

Über dieses Repository

Dieses Repository enthält die Materialien für Teile der Vorlesung Betriebssysteme WS2020/2021 an der Hochschule Düsseldorf (HSD).

Es steht unter der Creative Commons Attribution-ShareAlike 4.0 International License

Dokumente mit dem Suffix .adoc sind in Asciidoc geschrieben. Dateien mit dem suffix _slides.adoc sind Präsentationen mit reveal.js.

Die Folien enthalten teilweise auch Anmerkungen, die dann im PDF enthalten sind.

Vorbereitungen für die Verarbeitung von Asciidoc

Es ist sehr empfehlenswert alle Tools in einer extra Toolbox zu installieren. So beeinflussen die Abhängigkeiten das eigentlich System. Damit können auch ohne Root-Rechte Programme nachinstalliert werden. Siehe https://github.com/containers/toolbox .

[user@system hsd-os]$ toolbox create -r f33 -c hsd
[user@system hsd-os]$ toolbox enter hsd
⬢[user@toolbox hsd-os]$

Bundler installieren, falls nicht schon vorhanden. Dieser sorgt dafür, dass Ruby Gems nur lokal für dieses Projekt installiert werden.

Hierfür muss Ruby und Ruby-Gems installiert sein.

⬢[user@toolbox hsd-os]$ sudo dnf install -y rubygems
⬢[user@toolbox hsd-os]$ gem install bundler
⬢[user@toolbox hsd-os]$ bundle config --local github.https true
⬢[user@toolbox hsd-os]$ bundle config set --local path '.bundle/gems'

Die benötigten Gems sind in Gemfile aufgeführt und können mit dem Gem bundler installiert werden.

⬢[user@toolbox hsd-os]$ bundle --binstubs=.bundle/.bin

Rendern von Asciidoc in PDF

Siehe https://asciidoctor.org/docs/asciidoctor-pdf/

⬢[user@toolbox hsd-os]$ bundle exec asciidoctor-pdf  *.adoc

Rendern von Acciidoc+Reveal.js in HTML Slides

Siehe https://asciidoctor.org/docs/asciidoctor-revealjs/

⬢[user@toolbox hsd-os]$ bundle exec asciidoctor-revealjs \
  -a revealjsdir=https://cdn.jsdelivr.net/npm/[email protected] \
  *_slides.adoc