shackspace/shackspace-glossar

Name: shackspace-glossar

Owner: stuttgart hackerspace

Description: Glossar über `shackspace.de`, den Hackerspace in Stuttgart. Kann als 'Howto' für neue Mitglieder und als 'Einführung' für Besucher dienen.

Created: 2015-07-01 20:48:33.0

Updated: 2015-07-04 01:19:47.0

Pushed: 2015-07-05 23:09:16.0

Homepage: null

Size: 11752

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

shackspace-Glossar

Hier entsteht das shackspace-Glossar. Es dient der Einführung neuer Mitglieder in die Abläufe und Gepflogenheiten des “shack” (Hackerspace in Stuttgart).

Jedes Stichwort erhält einen Kurztext, geschrieben in Markdown. Daraus kann später ein komplettes Dokument als HTML, Wiki, PDF, EPUB oder was-auch-immer entstehen.

Manche Stichworte sind noch leer. Regelmässige Besucher und Nutzer des shack sind herzlich eingeladen, beim weiteren Befüllen der Lücken mitzuhelfen.

Vorschau

Wie das fertige Produkt mal aussehen könnte, ist anhand der verfügbaren Vorschau-Dokumente zu erahnen:

Aktueller Stand

Derzeitiger Stand des Projekts: ca. 19% fertig.

*Das shackspace-Glossar ist zu ca. 19% fertig.*

Pandoc-Installation

Die finalen Dokumente werden wir mit Hilfe von pandoc erzeugen.

Empfehlung: Installation von Pandoc über cabal (das Haskell-System zur distributions-unabhängigen Paket-Verwaltung).

l update
l install cabal-install
rt PATH=${HOME}/.cabal/bin:${PATH}
l install pandoc pandoc-citeproc pandoc-csv2table

Obige Vorgehensweise installiert die neuesten Versionen nach ${HOME}/.cabal/. Sie lässt die System-eigenen Pakete in Ruhe und fasst sie nicht an.

Kommandos zum Erzeugen von EPUB, HTML, PDF und DokuWiki

Dies ist der erste “quick'n'dirty” Wurf. Später wird das ein Makefile erledigen.

arkdown

UB3 erzeugen (noch ohne spezifisches CSS-Stylsheet) 
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar.epub          \
--to=epub3                                                      \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
--epub-chapter-level=1                                          \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

ML5 erzeugen (noch ohne spezifisches CSS-Stylsheet) 
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar.html          \
--to=html5                                                      \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
--standalone                                                    \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

ML5 erzeugen (mit "ein wenig" CSS) 
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar-mit-css.html  \
--to=html5                                                      \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
--standalone                                                    \
--css=../resources/symlink.css                                  \
--css=../resources/table.css                                    \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

kuWiki erzeugen
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar.dokuwiki      \
--to=dokuwiki                                                   \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

F erzeugen (A4, Porträt)
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar-A4.pdf        \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
--chapters                                                      \
--highlight-style=espresso                                      \
--latex-engine=xelatex                                          \
-H ../resources/setmainfont-sourcesansprolight.tex              \
-V geometry:"margin=2cm, paperwidth=595pt, paperheight=842pt"   \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

F erzeugen (A5, Landscape)
oc                                                              \
--output=../vorschau-beispiele/shackspace-glossar-A5q.pdf       \
--toc                                                           \
--base-header-level=1                                           \
--indented-code-classes=bash                                    \
--chapters                                                      \
--highlight-style=espresso                                      \
--latex-engine=xelatex                                          \
-V geometry:"margin=1cm, paperwidth=595pt, paperheight=421pt"   \
-V fontsize:10pt                                                \
-V classoption=onecolumn                                        \
-V linkcolor=blue                                               \
  00-titel-shack.md                                             \
  01-index.md                                                   \
  02-index-mit.md                                               \
  03-index-ohne.md                                              \
  *.mmd

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.