Normdaten in Wikidata

Dieses git-Repository enthält alle Dateien des Handbuch "Normdaten in Wikidata".

Das Haupt-Repository liegt bei Penflip.com unter https://www.penflip.com/nichtich/normdaten-in-wikidata und kann über folgende URLs geklont werden:

https://www.penflip.com/nichtich/normdaten-in-wikidata.git
<git@www.penflip.com:nichtich/normdaten-in-wikidata.git>

Eine (ggf. nicht aktuelle) Kopie des Repository liegt bei GitHub unter https://github.com/hshdb/normdaten-in-wikidata.

Erstellung des Handbuchs aus den Quellen

Zum Erzeugen der verschiedenen Ausgabeformate werden make und pandoc benötigt, um mit make html bzw. make pdf auf der Kommandozeile die HTML- und PDF-Version zu erzeugen. Für die PDF-Erstellung wird zusätzlich LaTeX mit verschiedenen LaTeX-Paketen benötigt.

Struktur des Handbuch-Repository

Die eigentlichen Inhalte befinden sich in Markdown-Syntax in Dateien mit der Endung .txt.
In der der Datei Contents.txt ist festgelegt, welche Markdown-Dateien in welcher Reihenfolge letztendlich das Handbuch bilden. Pro Zeile ist ein Dateiname angegeben; Leerzeilen und Zeilen, die mit > beginnen, werden ignoriert.
Das Verzeichnis images/ enthält Bilder.
Das Verzeichnis layout/ enthält Template- und Stylesheet-Dateien.
Die Dateien About.txt und README.md enthalten kurze Projektbeschreibungen, die nicht im Handbuch auftauchen.
Die Datei Makefile enthält Anweisungen, um aus den Inhaltsdateien das Handbuch in verschiedenen Ausgabeformaten zu erzeugen.
Das Verzeichnis scripts/ enthält zusätzliche Programme zur Verwaltung und Erstellung von Übersichten.
Die Datei README.md enthält diese Übersicht.

Verwendete Markdown-Syntax

Die Texte sind in Markdown-Syntax verfasst, wobei sich die konkrete Markdown-Variante aus Anforderungen von Penflip und Pandoc ergibt. Eine Übersicht dieser beiden Markdown-Varianten gibt es unter:

https://www.penflip.com/Penflip/help/blob/master/Markdown.txt für Penflip
http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html für Pandoc

Verwendete Werkzeuge

https://penflip.com: Penflip zum gemeinsamen Schreiben
http://johnmacfarlane.net/pandoc/: Pandoc zur Erstellen von HTML und PDF
http://annotateit.org: Annotator zum Korrekturlesen
https://trello.com: Trello zum Projektmanagement
https://github.com: GitHub für Snapshots

Lizenz