wortsammler 1.0.3 → 2.0.1

data/testproject.xx/30_Sources/001_Main/main.md

@@ -0,0 +1,273 @@
+---
+author:
+- Bernhard Weichel
+- and others
+date: '2013/05'
+title: Wortsammler sample document
+...
+
+# Introduction
+
+This is a sample document for Wortsammler
+
+# Anforderung an Dokumentenaufbereiter
+
+-   [RS_Comp_003] **Steuerung Dokumentenzusammenstellung**
+    {Dokumentenzusammenstellungen soll über ein
+    manifest ->[RS_Comp_007] gesteuert werden.
+
+    -   Die Manifeste sollen als Laufzeitparameter übergeben werden
+    -   Das Manifest enthält auch die Ausgabedatei
+
+    }(RS_DM_014, RS_DM_010, RS_DM_005)
+
+-   [RS_Comp_004] **Prozessierung Einzeldokument** {Soll Dokumente
+    verschiedenen Umfangs erzeugen können:
+
+    -   einzelnes Files
+    -   zu Prüfzwecken
+
+    Steuerung soll über Konfiguration (Manifest)
+    erfolgen ->[RS_Comp_007].
+
+    }()
+
+-   [RS_Comp_005] **Erstellung Loseblattsammlung** {Soll Dokumente
+    verschiedenen Umfangs erzeugen können:
+
+    -   kann aus dem Manifest errechnet werden ->[RS_Comp_007]
+
+    }()
+
+-   [RS_Comp_006] **Inkrementelle Verarbeitung** {Soll nur auf
+    geänderte Dokumente reagieren können:
+
+    -   ähnlich wie make/rake
+
+    }()
+
+-   [RS_Comp_007] **Anforderungen an Manifest** {Folgende
+    Anforderungen gelten für das Manifest
+    -   einfach bearbeiten - nur liste der Files
+    -   Markdown-lite
+    -   Yaml
+
+    Inhalte im Manifest sind
+
+    -   Name der Konfiguration
+    -   Ausgabeverzeichnis
+    -   Ausgabeformat
+    -   Name des generierten Dokumentes
+    -   Formate in denen das Dokument generiert wird. Werte hierfür
+        ergeben sich aus den Anforderungen an die Aufbereitet
+    -   zu verarbeitende Eingabedateien. Diese werden in der Reihenfolge
+        verarbeitet wie sie aufgeführt sind.
+    -   Optionen für die jeweiligen Formate.
+    -   zu bearbeitende Zielgruppen ->[RS_Comp_008]
+
+    <!-- -->
+    Beispiel für ein manifest
+
+         -
+           :name:  komplett
+           :outdir: ../ZGEN_Documents
+           :outname: RS_Requirements-Ngopm
+           :format:
+             - pdf
+             - html
+             - rtf
+             - docx
+             - latex
+
+           :lang: german  
+
+           :vars:
+               :lang: german
+
+           :editions:
+             :intern: 
+                 :title: Interne Ausgabe
+                 :filepart: _intern 
+             :extern: 
+                 :title: Externe Ausgabe
+                 :filepart: _extern
+             :mieter: 
+                 :title: Ausgabe für Mieter
+                 :filepart: _mieter
+             :ea: 
+                 :title: Ausgabe für ehrenamtliche Mitarbeiter
+                 :filepart: _ma-ehrenamtlich
+             :ha: 
+                 :title: Ausgabe für hauptamtliche Mitarbeiter
+                 :filepart: _ma-hauptamtlich
+             :1: 
+                 :title: Ausgabe für erste hauptamtliche Mitarbeiter
+                 :filepart: _ma-hauptamtlich-1
+
+           :input: 
+             - ../RS_Process/RS_Process.md 
+             - ../RS_Tooling/RS_Tooling.md 
+             - ../RS_Tooling/RS_MarkdownCleaner.md 
+             - ../RS_Tooling/RS_MarkdownEditor.md 
+             - ../RS_Tooling/RS_DocumentComposer.md  
+             - ../TPL_DirectoryStructure/TPL_DirectoryStructure.md
+             - ../TR_Installation/TR_Installation.md
+             - ../TR_Installation/TR_Proo-Handbuch.md
+             - ../ZGEN_RequirementsTracing/ZGEN_Reqtrace.md
+
+           :snippets:
+             - ../TS_Markdown/TS_Snippets.yaml
+             - ../TS_Markdown/TS_MoreSnippets.yaml
+
+    }(RS_Comp_003)
+
+## Zielgruppenspezifische Ausgaben
+
+Dieser Abschnitt behandelt speziell die Anforderungen an flexible
+Dokumentenausgabe
+
+-   [RS_Comp_001] **Flexibler Dokumentumfang** {Soll Dokumente
+    verschiedenen Umfangs erzeugen können:
+
+    -   einzelnes Files
+    -   Zusammengestelltes Dokument
+
+    }(RS_Comp_003)
+
+-   [RS_Comp_002] **Flexible Dokumentendarstellung** {Sollte Dokumente
+    in verschiedener Darstellung erzeugen können:
+    -   Seitenlayout
+    -   Detaillierungsgrad (z.B. RequirementsMarken ausblenden) }
+        (RS_Comp_003)
+-   [RS_Comp_008] **Zielgruppenspezifische Ausgaben (Editionen)** { Es
+    soll möglich sein Zielgruppenspezifische Ausgaben zu erstellen.
+
+    -   Dabei wird die Zielgruppe durch eine spezifische Zeichenkette
+        umgeschaltet (Durchstreichung), die auch in standard Markdown
+        Programmen eine sinnvolle Ausgabe liefert:
+
+        `~~ED intern extern~~` ab hier gilt: Text erscheint in Ausgabe
+        `intern` als auch in `extern`
+
+        Es handelt sich also um ein durchgestrichenes Muster als
+        regulärer Ausdruck
+
+            ~~ED((\s* \S+)*)~~
+
+    -   Die Umschaltung wirkt ab einschliesslich der Zeile, die die
+        Umschaltung enthält, bis zum Aufruf einer neuen Umschaltung.
+
+    -   Die möglichen Zielgruppen werden im Manifest
+        festgelegt ->[RS_Comp_007] daselbst Eintrag `:editions:`
+
+    -   Eine vorgegebene Zielgruppe `all` erzeugt keine spezifische
+        Ausgabe. Sie kennzeichnet vielmehr Inhalte, die in **allen**
+        Ausgaben gleichermassen enthalten sind.
+
+    -   Bei einer Aufteilung auf mehrere Dateien wird empfohlen am Ende
+        einer jeden Datei auf `all` zu schalten. Dadurch wird das System
+        einfache wartbar.
+
+    }(RS_Comp_003)
+
+    Alternativen für die Umschaltung sind:
+
+    \marginpar{intern}
+
+    -   ~~ED intern extern~~ und so geht es weiter
+
+    -   ^ZG intern extern^ und nun kommt der text der nur extern ist
+
+    \marginpar{extern}
+
+    -   ~ZG intern extern~ und hier ist der text der nur intern ist
+
+    -   <!-- ZG intern extern -->
+        und nun geht es weiter
+
+    \marginpar{intern}
+
+    -   und nun geht es intern weiter Gelaber und weiter
+-   [RS_Comp_009] **Gesamtausgabe mit allen Texten zur Prüfung**
+    {Sollte Dokumente Eine Gesamtausgabe mit allen Texten zur
+    Überprüfung soll erstellt werden. In diesem Fall werden die Ausgaben
+    am Rand notiert. }(RS_Comp_003)
+
+-   [RS_Comp_010] **Erstellung aller Ausgaben mit einem Befehl** {Es
+    sollen immer alle Ausgaben gleichermassen generiert werden. Dabei
+    gilt:
+
+    -   Der Dateiname für die generierten Dokumente bildet sich nach
+
+        `{:outname:}_{:edition:.:filepart:}.{format}`
+
+    -   In der Kopfzeile des Dokumentes wird `:edition:.:title:`
+        eingefügt, so dass die Ausgabe auf jeder Seite identifiziert
+        werden kann.
+
+    Ohne Angabe einer Zielgruppe bzw. mit der Angabe `all` soll
+    wortsammler alle Ausgaben erstellen.
+
+    Die Angabe einer einzelnen Zielgruppe erstellt dann auch nur die
+    gewählte Ausgabe.
+
+    }(RS_Comp_003)
+
+## Processing TODO - open issues
+
+Paragraphs like starting with
+
+    TODO: #13 do something are used to manage the open issues   
+
+## Processing the traceables
+
+## Including Files
+
+-   [RS_Comp_011] **including Plain pdf-Pages**{ PDF pages can be
+    included by
+
+    `~~PDF "lib/01234_particularPdf.pdf" "Das ist der Eintrag im Inhaltsverzeichnis" 1 2-4~~`
+
+    It is done in a markdown verbatim section. By this, Pandoc does not
+    add linebreaks in the command such that it can be processed with
+    regular expressions.
+
+    }(RS_Comp_003)
+
+-   [RS_Comp_014] **Including markdown files** {
+
+    `~~MD "lib/01234/xxxx/yyyy.md"~~`
+
+    will be replaced by the content of the argument. It should even work
+    inline.
+
+    }(RS_Comp_003)
+
+## Handling Text Snippets
+
+-   [RS_Comp_012] **Including text Snippets**{ Text Snippts can be
+    included by
+
+        `~~SN {symbol}~~`
+
+    The snippets are taken from one of the snippet databases declared in
+    the manifest ->[RS_Comp_007] according to the format
+    in ->[RS_Comp_013]. }()
+
+-   [RS_Conp_013] **Defining text Snippets** {
+
+    Text snippets are defined as a yaml file in the following format:
+
+        :Snippet1: Das ist Snippet 1
+
+        :Snippet2: |- Das ist snippet 2. Es enthält sogar eine Liste
+
+                *   Das ist item 1 in Snippet 2
+
+                *   Das ist item 2 in Snippet 2
+
+    }(RS_Comp_003)
+
+### this should not show up in toc
+
+This chapter should not show up in the toc

data/testproject.xx/30_Sources/ZGEN_Documents/RS_Main_compact.html

@@ -0,0 +1,145 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="german" xml:lang="german">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <meta http-equiv="Content-Style-Type" content="text/css" />
+  <meta name="generator" content="pandoc" />
+  <meta name="author" content="Bernhard Weichel" />
+  <meta name="author" content="and others" />
+  <title>Wortsammler sample document</title>
+  <style type="text/css">code{white-space: pre;}</style>
+</head>
+<body>
+<div id="header">
+<h1 class="title">Main requirements (compact)</h1>
+<h2 class="author">Bernhard Weichel</h2>
+<h2 class="author">and others</h2>
+<h3 class="date">2013/05</h3>
+</div>
+<div id="TOC">
+<ul>
+<li><a href="#introduction"><span class="toc-section-number">1</span> Introduction</a></li>
+<li><a href="#anforderung-an-dokumentenaufbereiter"><span class="toc-section-number">2</span> Anforderung an Dokumentenaufbereiter</a><ul>
+<li><a href="#zielgruppenspezifische-ausgaben"><span class="toc-section-number">2.1</span> Zielgruppenspezifische Ausgaben</a></li>
+</ul></li>
+</ul>
+</div>
+<h1 id="introduction"><span class="header-section-number">1</span> Introduction</h1>
+<p>This is a sample document for Wortsammler</p>
+<h1 id="anforderung-an-dokumentenaufbereiter"><span class="header-section-number">2</span> Anforderung an Dokumentenaufbereiter</h1>
+<ul>
+<li><p><a id="RS-Comp-003">[RS_Comp_003]</a> <strong>Steuerung Dokumentenzusammenstellung</strong> {Dokumentenzusammenstellungen soll &#252;ber ein manifest [<a href="#RS-Comp-007">RS_Comp_007</a>] gesteuert werden.</p>
+<ul>
+<li>Die Manifeste sollen als Laufzeitparameter &#252;bergeben werden</li>
+<li>Das Manifest enth&#228;lt auch die Ausgabedatei</li>
+</ul>
+<p>}(<a href="#RS-DM-014">RS_DM_014</a>, <a href="#RS-DM-010">RS_DM_010</a>, <a href="#RS-DM-005">RS_DM_005</a>)</p></li>
+<li><p><a id="RS-Comp-004">[RS_Comp_004]</a> <strong>Prozessierung Einzeldokument</strong> {Soll Dokumente verschiedenen Umfangs erzeugen k&#246;nnen:</p>
+<ul>
+<li>einzelnes Files</li>
+<li>zu Pr&#252;fzwecken</li>
+</ul>
+<p>Steuerung soll &#252;ber Konfiguration (Manifest) erfolgen [<a href="#RS-Comp-007">RS_Comp_007</a>].</p>
+<p>}()</p></li>
+<li><p><a id="RS-Comp-005">[RS_Comp_005]</a> <strong>Erstellung Loseblattsammlung</strong> {Soll Dokumente verschiedenen Umfangs erzeugen k&#246;nnen:</p>
+<ul>
+<li>kann aus dem Manifest errechnet werden [<a href="#RS-Comp-007">RS_Comp_007</a>]</li>
+</ul>
+<p>}()</p></li>
+<li><p><a id="RS-Comp-006">[RS_Comp_006]</a> <strong>Inkrementelle Verarbeitung</strong> {Soll nur auf ge&#228;nderte Dokumente reagieren k&#246;nnen:</p>
+<ul>
+<li>&#228;hnlich wie make/rake</li>
+</ul>
+<p>}()</p></li>
+<li><a id="RS-Comp-007">[RS_Comp_007]</a> <strong>Anforderungen an Manifest</strong> {Folgende Anforderungen gelten f&#252;r das Manifest
+<ul>
+<li>einfach bearbeiten - nur liste der Files</li>
+<li>Markdown-lite</li>
+<li>Yaml</li>
+</ul>
+<p>Inhalte im Manifest sind</p>
+<ul>
+<li>Name der Konfiguration</li>
+<li>Ausgabeverzeichnis</li>
+<li>Ausgabeformat</li>
+<li>Name des generierten Dokumentes</li>
+<li>Formate in denen das Dokument generiert wird. Werte hierf&#252;r ergeben sich aus den Anforderungen an die Aufbereitet</li>
+<li>zu verarbeitende Eingabedateien. Diese werden in der Reihenfolge verarbeitet wie sie aufgef&#252;hrt sind.</li>
+<li>Optionen f&#252;r die jeweiligen Formate.</li>
+<li>zu bearbeitende Zielgruppen [<a href="#RS-Comp-008">RS_Comp_008</a>]</li>
+</ul>
+<!-- -->
+<p>Beispiel f&#252;r ein manifest</p>
+<pre><code> -
+   :name:  komplett
+   :outdir: ../ZGEN_Documents
+   :outname: RS_Requirements-Ngopm
+   :format:
+     - pdf
+     - html
+     - rtf
+     - docx
+     - latex
+
+   :lang: german  
+
+   :vars:
+       :lang: german
+
+   :editions:
+     :intern: 
+         :title: Interne Ausgabe
+         :filepart: _intern 
+     :extern: 
+         :title: Externe Ausgabe
+         :filepart: _extern
+     :mieter: 
+         :title: Ausgabe f&#252;r Mieter
+         :filepart: _mieter
+     :ea: 
+         :title: Ausgabe f&#252;r ehrenamtliche Mitarbeiter
+         :filepart: _ma-ehrenamtlich
+     :ha: 
+         :title: Ausgabe f&#252;r hauptamtliche Mitarbeiter
+         :filepart: _ma-hauptamtlich
+     :1: 
+         :title: Ausgabe f&#252;r erste hauptamtliche Mitarbeiter
+         :filepart: _ma-hauptamtlich-1
+
+   :input: 
+     - ../RS_Process/RS_Process.md 
+     - ../RS_Tooling/RS_Tooling.md 
+     - ../RS_Tooling/RS_MarkdownCleaner.md 
+     - ../RS_Tooling/RS_MarkdownEditor.md 
+     - ../RS_Tooling/RS_DocumentComposer.md  
+     - ../TPL_DirectoryStructure/TPL_DirectoryStructure.md
+     - ../TR_Installation/TR_Installation.md
+     - ../TR_Installation/TR_Proo-Handbuch.md
+     - ../ZGEN_RequirementsTracing/ZGEN_Reqtrace.md
+
+   :snippets:
+     - ../TS_Markdown/TS_Snippets.yaml
+     - ../TS_Markdown/TS_MoreSnippets.yaml</code></pre>
+<p>}(<a href="#RS-Comp-003">RS_Comp_003</a>)</p></li>
+</ul>
+<h2 id="zielgruppenspezifische-ausgaben"><span class="header-section-number">2.1</span> Zielgruppenspezifische Ausgaben</h2>
+<p>Dieser Abschnitt behandelt speziell die Anforderungen an flexible Dokumentenausgabe</p>
+<ul>
+<li><p><a id="RS-Comp-001">[RS_Comp_001]</a> <strong>Flexibler Dokumentumfang</strong> {Soll Dokumente verschiedenen Umfangs erzeugen k&#246;nnen:</p>
+<ul>
+<li>einzelnes Files</li>
+<li>Zusammengestelltes Dokument</li>
+</ul>
+<p>}(<a href="#RS-Comp-003">RS_Comp_003</a>)</p></li>
+<li><a id="RS-Comp-002">[RS_Comp_002]</a> <strong>Flexible Dokumentendarstellung</strong> {Sollte Dokumente in verschiedener Darstellung erzeugen k&#246;nnen:
+<ul>
+<li>Seitenlayout</li>
+<li>Detaillierungsgrad (z.B. RequirementsMarken ausblenden) } (RS_Comp_003)</li>
+</ul></li>
+<li><p><a id="RS-Comp-008">[RS_Comp_008]</a> <strong>Zielgruppenspezifische Ausgaben (Editionen)</strong> { Es soll m&#246;glich sein Zielgruppenspezifische Ausgaben zu erstellen.</p>
+<ul>
+<li>Dabei wird die Zielgruppe durch eine spezifische Zeichenkette umgeschaltet (Durchstreichung), die auch in standard Markdown Programmen eine sinnvolle Ausgabe liefert:</li>
+</ul></li>
+</ul>
+</body>
+</html>

data/testproject.xx/30_Sources/ZGEN_Documents/RS_Main_compact.latex

@@ -0,0 +1,416 @@
+\documentclass[twoside,a4paper,12pt,german,]{article}
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{amssymb,amsmath}
+\usepackage{ifxetex,ifluatex}
+\usepackage{fixltx2e} % provides \textsubscript
+% use microtype if available
+\IfFileExists{microtype.sty}{\usepackage{microtype}}{}
+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \usepackage[utf8]{inputenc}
+\else % if luatex or xelatex
+  \usepackage{fontspec}
+  \ifxetex
+    \usepackage{xltxtra,xunicode}
+  \fi
+  \defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
+  \newcommand{\euro}{€}
+    \setmainfont{Calibri}
+    \setsansfont{Calibri}
+\fi
+\usepackage[a4paper]{geometry}
+\usepackage{longtable}
+\usepackage{float} % provides the H option for float placement
+\usepackage{graphicx}
+% We will generate all images so they have a width \maxwidth. This means
+% that they will get their normal width if they fit onto the page, but
+% are scaled down if they would overflow the margins.
+\makeatletter
+\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth
+\else\Gin@nat@width\fi}
+\makeatother
+\let\Oldincludegraphics\includegraphics
+\makeatletter
+\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth
+\else\Gin@nat@width\fi}
+\makeatother
+\let\Oldincludegraphics\includegraphics
+%\renewcommand{\includegraphics}[1]{\Oldincludegraphics[width=\maxwidth]{#1}}
+% Determine if the image is too wide for the page.
+%
+{%
+ \catcode`\@=11\relax%
+ \gdef\includegraphics{\@ifnextchar[{\Oldincludegraphics}{\Oldincludegraphics[width=\maxwidth]}}%
+}%
+%
+
+\ifxetex
+  \usepackage[setpagesize=false, % page size defined by xetex
+              unicode=false, % unicode breaks when used with xetex
+              bookmarksdepth=3, %
+              xetex]{hyperref}
+\else
+  \usepackage[unicode=true]{hyperref}
+\fi
+\hypersetup{breaklinks=true,
+            bookmarks=true,
+            pdfauthor={Bernhard Weichel; and others},
+            pdftitle={Wortsammler sample document},
+            colorlinks=true,
+            urlcolor=blue,
+            linkcolor=magenta,
+            pdfborder={0 0 0}}
+\urlstyle{same}  % don't use monospace font for urls
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{6pt plus 2pt minus 1pt}
+\setlength{\emergencystretch}{3em}  % prevent overfull lines
+\setcounter{secnumdepth}{5}
+\ifxetex
+  \usepackage{polyglossia}
+  \setmainlanguage{german}
+\else
+  \usepackage[german]{babel}
+\fi
+
+\title{Main requirements (compact)}
+\author{Bernhard Weichel \and and others}
+\date{2013/05}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% Wortsammler specific settings
+%
+%list environment by reinhard Jahraus
+{\catcode`\@=11\relax%
+\gdef\itemize{%
+  \ifnum \@itemdepth >\thr@@\@toodeep\else
+    \advance\@itemdepth\@ne
+    \edef\@itemitem{labelitem\romannumeral\the\@itemdepth}%
+    \expandafter
+    \list
+      \csname\@itemitem\endcsname
+      {\def\makelabel##1{\hss\llap{##1}}%
+       \addtolength{\leftmargin}{-10pt}% 29.37pt
+       \addtolength{\rightmargin}{0.0pt}% 0.0pt
+       \addtolength{\labelsep}{0pt}% 23.50pt
+       \addtolength{\itemsep}{-3.0pt}% 5.0pt
+       \addtolength{\parsep}{-1pt}% 5.0pt
+       \addtolength{\topsep}{-5pt}% 10.0pt
+       \addtolength{\partopsep}{0pt}% 3.0pt
+      }%
+  \fi}
+}%
+
+%
+% improve nesting of lists
+% %http://stackoverflow.com/questions/1935952/maximum-nesting-level-of-lists-in-latex
+%
+\usepackage{enumitem}
+\setlistdepth{9}
+\setlist[itemize,1]{label=$\bullet$}
+\setlist[itemize,2]{label=$\bullet$}
+\setlist[itemize,3]{label=$\bullet$}
+\setlist[itemize,4]{label=$\bullet$}
+\setlist[itemize,5]{label=$\bullet$}
+\setlist[itemize,6]{label=$\bullet$}
+\setlist[itemize,7]{label=$\bullet$}
+\setlist[itemize,8]{label=$\bullet$}
+\setlist[itemize,9]{label=$\bullet$}
+\renewlist{itemize}{itemize}{9}
+%
+% multicol
+%
+\usepackage{multicol}
+\newcommand{\wsbegintwocol}{\begin{multicols}{2}}
+\newcommand{\wsendtwocol}{\end{multicols}}
+
+%
+% embed an image in the text
+%
+% usage: \wsembedimage{file}{r|l}{width}{height}
+\usepackage{wrapfig}
+\usepackage{needspace}
+\newcommand{\wsembedimage}[4]{\needspace{#4}\begin{wrapfigure}{#2}{#3}\centering%
+\vspace{-5mm}\includegraphics{#1}\vspace{-1cm}\end{wrapfigure}}
+%
+% adjust page layout
+%
+\setlength{\oddsidemargin}{-0.5cm}
+\setlength{\evensidemargin}{-0.5cm}
+\setlength{\textwidth}{17cm}
+\setlength{\topmargin}{-2.0cm}
+\setlength{\headheight}{1cm}
+\setlength{\headsep}{1.5cm}
+\setlength{\textheight}{25cm}
+\setlength{\footskip}{1cm}
+
+% adjust the toc layout
+\makeatletter
+% \renewcommand*\l@section{\@dottedtocline{2}{1.8em}{4em}}
+ \renewcommand*\l@subsection{\@dottedtocline{2}{1.5em}{4em}}
+ \renewcommand*\l@subsubsection{\@dottedtocline{2}{5.5em}{4em}}
+\makeatother
+
+\usepackage{pdfpages}
+\usepackage{bookmark}
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\chead{\begin{center}\textbf{Main requirements (compact)} \end{center}}
+\lhead{\includegraphics{../ZSUPP_Styles/logo.jpg}}
+\rhead{\leftmark}
+\lfoot{Bernhard Weichel}
+\rfoot{\today~2013/05}
+\renewcommand{\footrulewidth}{0.4pt}
+%
+\renewcommand{\familydefault}{\sfdefault}
+%
+% Marginpars shall always be right
+\makeatletter
+   \def\marginparright{\@mparswitchfalse}
+   \def\marginparoutside{\@mparswitchtrue}
+\makeatother
+\marginparright
+%
+%
+\raggedbottom
+%
+
+
+\usepackage{makeidx}
+\makeindex
+
+%
+%\renewcommand{Befehl der Gliederungsebene z.B. \chapter}{\@startsection{Name z.B. chapter}{Ebene z.B. 0}{Einrückung z.B. 0pt}{Abstand zum vorigen Text z.B. 3.5ex plus 1ex minus 0pt\relax}{Abstand zum nachfolgenden Text z.B. 2.5ex plus 0.5ex minus 0pt\relax}{Schrift z.B. \normalfont\Large\bfseries}}
+%
+% \makeatletter%
+% \renewcommand{\chapter}{\@startsection{chapter}{0}{0pt}{3.5ex plus 1ex minus 0pt\relax}{2.5ex plus 0.5ex minus 0pt\relax}{\normalfont\Large\bfseries}}%
+% \makeatother%
+%
+%
+% Wortsammler extensions end here
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{document}
+\maketitle
+
+\clearpage
+
+{
+\hypersetup{linkcolor=black}
+\setcounter{tocdepth}{1}
+\tableofcontents
+\newpage
+}
+
+\section{Introduction}\label{introduction}
+
+This is a sample document for Wortsammler
+
+\section{Anforderung an
+Dokumentenaufbereiter}\label{anforderung-an-dokumentenaufbereiter}
+
+\begin{itemize}
+\item
+  {[}RS\_Comp\_003{]} \textbf{\hypertarget{RS-Comp-003}{}Steuerung
+  Dokumentenzusammenstellung} \{Dokumentenzusammenstellungen soll über
+  ein manifest {[}\hyperlink{RS-Comp-007}{RS\_Comp\_007}{]} gesteuert
+  werden.
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    Die Manifeste sollen als Laufzeitparameter übergeben werden
+  \item
+    Das Manifest enthält auch die Ausgabedatei
+  \end{itemize}
+
+  \}(\hyperlink{RS-DM-014}{RS\_DM\_014},
+  \hyperlink{RS-DM-010}{RS\_DM\_010},
+  \hyperlink{RS-DM-005}{RS\_DM\_005})
+\item
+  {[}RS\_Comp\_004{]} \textbf{\hypertarget{RS-Comp-004}{}Prozessierung
+  Einzeldokument} \{Soll Dokumente verschiedenen Umfangs erzeugen
+  können:
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    einzelnes Files
+  \item
+    zu Prüfzwecken
+  \end{itemize}
+
+  Steuerung soll über Konfiguration (Manifest) erfolgen
+  {[}\hyperlink{RS-Comp-007}{RS\_Comp\_007}{]}.
+
+  \}()
+\item
+  {[}RS\_Comp\_005{]} \textbf{\hypertarget{RS-Comp-005}{}Erstellung
+  Loseblattsammlung} \{Soll Dokumente verschiedenen Umfangs erzeugen
+  können:
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    kann aus dem Manifest errechnet werden
+    {[}\hyperlink{RS-Comp-007}{RS\_Comp\_007}{]}
+  \end{itemize}
+
+  \}()
+\item
+  {[}RS\_Comp\_006{]} \textbf{\hypertarget{RS-Comp-006}{}Inkrementelle
+  Verarbeitung} \{Soll nur auf geänderte Dokumente reagieren können:
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    ähnlich wie make/rake
+  \end{itemize}
+
+  \}()
+\item
+  {[}RS\_Comp\_007{]} \textbf{\hypertarget{RS-Comp-007}{}Anforderungen
+  an Manifest} \{Folgende Anforderungen gelten für das Manifest
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    einfach bearbeiten - nur liste der Files
+  \item
+    Markdown-lite
+  \item
+    Yaml
+  \end{itemize}
+
+  Inhalte im Manifest sind
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    Name der Konfiguration
+  \item
+    Ausgabeverzeichnis
+  \item
+    Ausgabeformat
+  \item
+    Name des generierten Dokumentes
+  \item
+    Formate in denen das Dokument generiert wird. Werte hierfür ergeben
+    sich aus den Anforderungen an die Aufbereitet
+  \item
+    zu verarbeitende Eingabedateien. Diese werden in der Reihenfolge
+    verarbeitet wie sie aufgeführt sind.
+  \item
+    Optionen für die jeweiligen Formate.
+  \item
+    zu bearbeitende Zielgruppen
+    {[}\hyperlink{RS-Comp-008}{RS\_Comp\_008}{]}
+  \end{itemize}
+
+  Beispiel für ein manifest
+
+\begin{verbatim}
+ -
+   :name:  komplett
+   :outdir: ../ZGEN_Documents
+   :outname: RS_Requirements-Ngopm
+   :format:
+     - pdf
+     - html
+     - rtf
+     - docx
+     - latex
+
+   :lang: german  
+
+   :vars:
+       :lang: german
+
+   :editions:
+     :intern: 
+         :title: Interne Ausgabe
+         :filepart: _intern 
+     :extern: 
+         :title: Externe Ausgabe
+         :filepart: _extern
+     :mieter: 
+         :title: Ausgabe für Mieter
+         :filepart: _mieter
+     :ea: 
+         :title: Ausgabe für ehrenamtliche Mitarbeiter
+         :filepart: _ma-ehrenamtlich
+     :ha: 
+         :title: Ausgabe für hauptamtliche Mitarbeiter
+         :filepart: _ma-hauptamtlich
+     :1: 
+         :title: Ausgabe für erste hauptamtliche Mitarbeiter
+         :filepart: _ma-hauptamtlich-1
+
+   :input: 
+     - ../RS_Process/RS_Process.md 
+     - ../RS_Tooling/RS_Tooling.md 
+     - ../RS_Tooling/RS_MarkdownCleaner.md 
+     - ../RS_Tooling/RS_MarkdownEditor.md 
+     - ../RS_Tooling/RS_DocumentComposer.md  
+     - ../TPL_DirectoryStructure/TPL_DirectoryStructure.md
+     - ../TR_Installation/TR_Installation.md
+     - ../TR_Installation/TR_Proo-Handbuch.md
+     - ../ZGEN_RequirementsTracing/ZGEN_Reqtrace.md
+
+   :snippets:
+     - ../TS_Markdown/TS_Snippets.yaml
+     - ../TS_Markdown/TS_MoreSnippets.yaml
+\end{verbatim}
+
+  \}(\hyperlink{RS-Comp-003}{RS\_Comp\_003})
+\end{itemize}
+
+\subsection{Zielgruppenspezifische
+Ausgaben}\label{zielgruppenspezifische-ausgaben}
+
+Dieser Abschnitt behandelt speziell die Anforderungen an flexible
+Dokumentenausgabe
+
+\begin{itemize}
+\item
+  {[}RS\_Comp\_001{]} \textbf{\hypertarget{RS-Comp-001}{}Flexibler
+  Dokumentumfang} \{Soll Dokumente verschiedenen Umfangs erzeugen
+  können:
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    einzelnes Files
+  \item
+    Zusammengestelltes Dokument
+  \end{itemize}
+
+  \}(\hyperlink{RS-Comp-003}{RS\_Comp\_003})
+\item
+  {[}RS\_Comp\_002{]} \textbf{\hypertarget{RS-Comp-002}{}Flexible
+  Dokumentendarstellung} \{Sollte Dokumente in verschiedener Darstellung
+  erzeugen können:
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    Seitenlayout
+  \item
+    Detaillierungsgrad (z.B. RequirementsMarken ausblenden) \}
+    (RS\_Comp\_003)
+  \end{itemize}
+\item
+  {[}RS\_Comp\_008{]}
+  \textbf{\hypertarget{RS-Comp-008}{}Zielgruppenspezifische Ausgaben
+  (Editionen)} \{ Es soll möglich sein Zielgruppenspezifische Ausgaben
+  zu erstellen.
+
+  \begin{itemize}
+  \itemsep1pt\parskip0pt\parsep0pt
+  \item
+    Dabei wird die Zielgruppe durch eine spezifische Zeichenkette
+    umgeschaltet (Durchstreichung), die auch in standard Markdown
+    Programmen eine sinnvolle Ausgabe liefert:
+  \end{itemize}
+\end{itemize}
+
+\end{document}