diff --git a/templates/documentation-base.html b/templates/documentation-base.html
new file mode 100644
index 0000000000000000000000000000000000000000..397368ad45a5fee5be9d389758ec3022a6caf404
--- /dev/null
+++ b/templates/documentation-base.html
@@ -0,0 +1,52 @@
+{% extends "layout.html" %}
+{% from "macros.html" import render_table %}
+{% set navigation_bar = [
+ ('documentation', 'Dokumentation', None),
+ ('sessionmanagement_documentation', 'Sitzungsverwaltung', [
+ ('plan_sessionmanagement_documentation', 'Planung'),
+ ('write_sessionmanagement_documentation', 'Protokollieren'),
+ ('tracking_sessionmanagement_documentation', 'Nachverfolgung')
+ ]),
+ ('syntax_documentation', 'Syntax', [
+ ('meta_syntax_documentation', 'Metadaten'),
+ ('top_syntax_documentation', 'Tagesordnungspunkte'),
+ ('lists_syntax_documentation', 'Listen'),
+ ('internal_syntax_documentation', 'Interne Abschnitte'),
+ ('tags_syntax_documentation', 'Tags')
+ ]),
+ ('configuration_documentation', 'Einrichtung' [
+ ('types_configuration_documentation', 'Typen'),
+ ('todomails_configuration_documentation', 'Todo Mails')
+ ])
+] -%}
+{% set active_page = active_page|default('documentation') -%}
+
+{% block title %}{{active_page}}{% endblock %}
+
+{% block content %}
+<div class="row">
+ <div id="left-column", class="col-lg-9">
+ {% block documentation_content %}
+ Diese Seite ist leer.
+ {% endblock %}
+ </div>
+ <div id="right-column", class="col-lg-3">
+ <ul id="right-column-navigation", class="nav nav-pills flex-column">
+ {% for id, caption, children in navigation_bar %}
+ <li class="nav-item">
+ <a {% if id == active_page %} class="nav-link active"{% else %} class="nav-link"{% endif %}" href="{{url_for(id|e)}}">{{caption|e}}</a>
+ {% if children is not None %}
+ <ul class="nav nav-pills flex-column">
+ {% for child_id, child_caption in children %}
+ <li class="nav-item">
+ <a {% if child_id == active_page %} class="nav-link active"{% else %} class="nav-link"{% endif %}" href="{{url_for(child_id|e)}}">{{child_caption|e}}</a>
+ </li>
+ {% endfor %}
+ </ul>
+ {% endif %}
+ </li>
+ {% endfor %}
+ </ul>
+ </div>
+</div>
+{% endblock %}
diff --git a/templates/documentation-configuration-todomails.html b/templates/documentation-configuration-todomails.html
new file mode 100644
index 0000000000000000000000000000000000000000..f19dc2be7c86afd7ef53e0311f5c914a52c921e5
--- /dev/null
+++ b/templates/documentation-configuration-todomails.html
@@ -0,0 +1,6 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "todomails_configuration_documentation" %}
+
+{% block documentation_content %}
+ <h3>Todo Mails</h3>
+{% endblock %}
diff --git a/templates/documentation-configuration-types.html b/templates/documentation-configuration-types.html
new file mode 100644
index 0000000000000000000000000000000000000000..6fe990a3bf7ba1ed64c9df2eb38bf17b924b4ee9
--- /dev/null
+++ b/templates/documentation-configuration-types.html
@@ -0,0 +1,38 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "types_configuration_documentation" %}
+
+{% block documentation_content %}
+ <h3>Typen</h3>
+ <h4 id="rechte">Rechteverwaltung</h4>
+ Das Protokollsystem hat ein Konzept von Rechteverwaltung, dass auf den Benutzergruppen im LDAP basiert.
+ Rechte werden pro Protokolltyp eingestellt.
+ Die vorhandenen Rechtestufen sind „Darf öffentliche Version einsehen“, „Darf interne Version einsehen“, „Darf Ändern“ und „Darf Protokolltyp bearbeiten“.
+ Jedes Protokoll hat eine öffentliche Gruppe, eine interne Gruppe, eine Bearbeitungsgruppe, eine Verwaltungsgruppe und eine Einstellung, ob es öffentlich ist.<br>
+
+ Die öffentliche Version einsehen dürfen:
+ <ul>
+ <li>
+ Nicht authentifizierte Nutzer, wenn für den Protokolltyp „Öffentlich“ eingestellt ist, sobald das Protokoll veröffentlicht ist.
+ <ul>
+ <li>Die Tagesordnung und Metadaten sind auch vor Veröffentlichung einsehbar.</li>
+ </ul>
+ </li>
+ <li>Authentifizierte Nutzer auch dann, wenn der Protokolltyp nicht „Öffentlich“ ist, aber sie die „Öffentliche Gruppe“ oder die „Interne Gruppe” des Protokolltyps haben. Wenn keine Gruppe eingestellt ist, kann auch kein Nutzer diese haben.</li>
+ </ul>
+ Die interne Version einsehen dürfen:
+ <ul>
+ <li>Authentifizierte Nutzer, wenn sie die „Interne Gruppe” des Protokolltyps haben.</li>
+ </ul>
+ Das Protokoll bearbeiten dürfen:
+ <ul>
+ <li>Authentifizierte Benutzer, wenn sie die „Bearbeitungsgruppe“ des Protokolltyps haben.</li>
+ </ul>
+ Die Einstellungen des Protokolltyps bearbeiten und das Protokoll veröffentlichen dürfen:
+ <ul>
+ <li>Authentifizierte Benutzer, wenn sie die „Verwaltungsgruppe“ des Protokolltyps haben.</li>
+ </ul>
+
+ Vom Protokoll wird eine interne und eine öffentliche Version generiert, falls es Inhalte gibt, die nur intern sind.
+ Todos sind generell intern, Beschlüsse sind generell öffentlich (d.h. einsehbar, wenn man das Recht „Darf öffentliche Version sehen“ hat).
+ Daher dürfen Beschlüsse nicht in einem internen Teil des Protokolls sein.
+{% endblock %}
diff --git a/templates/documentation-configuration.html b/templates/documentation-configuration.html
new file mode 100644
index 0000000000000000000000000000000000000000..0908718492279cb511b7ac83eacfe39834ee7051
--- /dev/null
+++ b/templates/documentation-configuration.html
@@ -0,0 +1,6 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "configuration_documentation" %}
+
+{% block documentation_content %}
+ <h3>Einrichtung</h3>
+{% endblock %}
diff --git a/templates/documentation-sessionmanagement-plan.html b/templates/documentation-sessionmanagement-plan.html
new file mode 100644
index 0000000000000000000000000000000000000000..ad8959ce8d788048cb811b9022a3d99caff62e95
--- /dev/null
+++ b/templates/documentation-sessionmanagement-plan.html
@@ -0,0 +1,28 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "plan_sessionmanagement_documentation" %}
+
+{% block documentation_content %}
+ <h3>Planung</h3>
+ <h4 id="planung">Sitzungsplanung</h4>
+ Sollte das Protokoll noch nicht existieren:
+ <ol>
+ <li>Gehe auf <a href="{{url_for("new_protocol")}}">Neu</a></li>
+ <li>Wähle bei „Typ“ den Typ der Sitzung aus.</li>
+ <li>Gib das Datum der Sitzung ein.</li>
+ <li>Anlegen</li>
+ </ol>
+ Wenn es existiert:
+ <ol>
+ <li>Gehe auf <a href="{{url_for("list_protocols")}}">Protokolle</a></li>
+ <li>Wähle die Sitzung aus. Noch ausstehende Sitzungen sind ganz oben.</a>
+ </ol>
+ Auf der Seite der Sitzung siehst du die Tagesordnung.
+ <ul>
+ <li>Die ersten und letztes TOPs sind Standard-TOPs, die jede Sitzung hat. Die kannst du nur über beim Protokolltyp ändern, nicht beim Protokoll selbst.</li>
+ <li>Die mittleren TOPs gehören nur zu dieser Sitzung. Du kannst welche hinzufügen oder sie umsortieren.</li>
+ <li>Möchtest du zu einem TOP vorprotokollieren, so klicke auf ändern und füge unter "Beschreibung" deinen Inhalt ein (hier gilt die gleiche Syntax, wie im normalen Protokoll).</li>
+ <li>Jedes selbstständige Thema oder jeder Antrag sollte in einen eigenen TOP geschrieben werden. Sammel-TOPs, oder TOPs mit allen finanzwirksamen Anträgen sorgen für wenig Übersichtlichkeit.</li>
+ <li>Wir wünschen uns, dass TOPs so früh wie möglich auf die Tagesordnung geschrieben werden und unter "Beschreibung" kurz erläutert weird, worum es gehen soll. Sollte es in dem TOP darum gehen, dass Geld beantragt wird, sollte der TOP im Namen durch ein "(€)" gekennzeichnet werden."</li>
+ <li>Solltest du die TOPs nicht bearbeiten können, handelt es sich um ein Protokoll, das du lesen, aber nicht bearbeiten kannst. Mehr dazu bei <a href="#rechte">Rechteverwaltung</a>.</li>
+ </ul>
+{% endblock %}
diff --git a/templates/documentation-sessionmanagement-tracking.html b/templates/documentation-sessionmanagement-tracking.html
new file mode 100644
index 0000000000000000000000000000000000000000..a6820e67d415bdc8158d40f0ad8d1c5b1639eb17
--- /dev/null
+++ b/templates/documentation-sessionmanagement-tracking.html
@@ -0,0 +1,26 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "tracking_sessionmanagement_documentation" %}
+
+{% block documentation_content %}
+ <h3>Nachverfolgung</h3>
+ <h4 id="todos">Todosystem</h4>
+ Das Protokollsystem verwaltet Todos über mehrere Protokolle hinweg. Offene Todos werden in die Protokollvorlage eingefügt, falls diese einen TOP „Todos“ beinhaltet.
+ <ul>
+ <li>Jedes Todo hat eine (oder durch Kommata oder Leerzeichen getrennt mehrere) Personen, die es erledigen sollen.</li>
+ <li>Todos haben auch einen Zustand, in dem sie sich befinden. Es gibt:
+ <ul>
+ <li>offen: Das Todo muss noch erledigt werden</li>
+ <li>wartet auf Rückmeldung: Jemand kümmert sich um das Todo, wartet allerdings gerade darauf, dass jemand anderes (intern oder extern) sich zurückmeldet.</li>
+ <li>in Bearbeitung: Jemand kümmert sich gerade um das Todo.</li>
+ <li>ab: Das Todo wird erst ab dem Datum relevant.</li>
+ <li>vor: Das Todo muss vor dem Datum erledigt werden.</li>
+ <li>verwaist: Das Todo hat niemanden, der es erledigen wird.</li>
+ <li>erledigt: Das Todo ist erledigt.</li>
+ <li>abgewiesen: Das Todo ist nicht und wird nicht mehr erledigt.</li>
+ <li>obsolet: Das Todo wurde nicht erledigt und nun ist es zu spät, das noch zu tun.</li>
+ </ul>
+ </li>
+ <li>Alle Todos findest du unter <a href="{{url_for("list_todos")}}">Todos</a>.</li>
+ </ul>
+ <h4 id="decisions">Beschlüsse</h4>
+{% endblock %}
diff --git a/templates/documentation-sessionmanagement-write.html b/templates/documentation-sessionmanagement-write.html
new file mode 100644
index 0000000000000000000000000000000000000000..e340e041c233d24f36b0f5c575cdd5ae856b1a62
--- /dev/null
+++ b/templates/documentation-sessionmanagement-write.html
@@ -0,0 +1,26 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "write_sessionmanagement_documentation" %}
+
+{% block documentation_content %}
+ <h3>Protokollieren</h3>
+ <h4 id="wie">Wie schreibe ich eine Protokoll?</h4>
+ Die folgenden Schritte werden erst ein paar Minuten vor der Sitzung ausgeführt. Vorher werden Inhalte und TOPs wie oben beschrieben vorprotokolliert.
+ <ol>
+ <li>Protokoll auswählen (s.o.)</li>
+ <li>mit „In Etherpad“ die Vorlage in das Etherpad schreiben.</li>
+ <li>mit „Etherpad“ das Etherpad öffnen</li>
+ <li>verlese Tagesordnung und Todos</li>
+ <li>falls Todo erledigt, markiere als erledigt (Details siehe <a href="#Todos">Todos</a></li>
+ <li>schreibe das Protokoll im Etherpad</li>
+ <li>Importiere das Protokoll am Ende mit „Aus Etherpad“</li>
+ <li>Falls Fehler auftreten, behebe sie (siehe <a href="#fehler">Fehler</a></li>
+ <li>Wenn keine Fehler mehr auftreten, drucke das Protokoll mit „Löschen” (unten beim Anhang) aus.</li>
+ <li>Korrekturlesen lassen und im Etherpad korrigieren, dann nochmal „aus Etherpad“</li>
+ <li>Drucken und abheften</li>
+ <li>Intern per Mail versenden</li>
+ <li>Korrekturen abwarten (z.B. die Genehmigung auf der nächsten Sitzung)</li>
+ <li>Veröffentlichen (und ggf. öffentlich versenden)</li>
+ </ol>
+ <h5>Höchst interne Protokolle</h5>
+ Falls das Protokoll Daten beinhaltet, die auf keinen Fall öffentlich sein sollten (z.B. personenbezogene Daten bei einem Sozialausschuss), kann anstelle des Editierens im Etherpad auch mit „Vorlage“ die leere Protokollvorlage heruntergeladen werden. Darin kann lokal mit einem beliebigen Texteditor die Sitzung protokolliert werden, um sie dann am Ende lokal zu speichern und mit „Quellcode hochladen“ hochzuladen.
+{% endblock %}
diff --git a/templates/documentation-sessionmanagement.html b/templates/documentation-sessionmanagement.html
new file mode 100644
index 0000000000000000000000000000000000000000..df38f73e4109e7207bacebcc124dc8eb3b723d02
--- /dev/null
+++ b/templates/documentation-sessionmanagement.html
@@ -0,0 +1,12 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "sessionmanagement_documentation" %}
+
+{% block documentation_content %}
+ <h3>Sitzungsverwaltung</h3>
+
+ <h4 id="suche">Suche</h4>
+ <a href="{{url_for("list_protocols")}}">Protokolle</a>, <a href="{{url_for("list_todos")}}">Todos</a> und <a href="{{url_for("list_decisions")}}">Beschlüsse</a> können durchsucht werden.
+ Im Suchfeld können mehrere durch Leerzeichen getrennte Suchbegriffe angegeben werden: <code>Begriff1 Begriff2</code>.
+ Angezeigt werden alle Ergebnisse, die jeden der Suchbegriffe (unabhängig von Groß- oder Kleinschreibung) enthalten.
+ Wenn ein Suchbegriff ein Leerzeichen beinhaltet, muss er mit Anführungszeichen umrandet werden: <code>"Begriff1 mit Leerzeichen" Begriff2</code>.
+{% endblock %}
diff --git a/templates/documentation-syntax-internal.html b/templates/documentation-syntax-internal.html
new file mode 100644
index 0000000000000000000000000000000000000000..31d0348c5f4cb76e6bc539d7611282ed15976487
--- /dev/null
+++ b/templates/documentation-syntax-internal.html
@@ -0,0 +1,27 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "internal_syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Interne Abschnitte</h3>
+ {% if config.PRIVATE_KEYWORDS|length > 0 %}
+ <h4 id="intern">Interne Abschnitte</h4>
+ Wenn der Name einer Liste (bis auf Leerzeichen und einen optionalen <code>:</code>) eins aus
+ {{config.PRIVATE_KEYWORDS|map("code")|join(" ")|safe}}
+ ist, ist diese Liste intern.
+ Daher wird sie nur in der internen Version des Protokolls angezeigt.
+ In der öffentlichen Version steht stattdessen nur ein Hinweis auf diese interne Stelle.
+ Es bietet sich beim Protokollieren an, wenn nach dem internen Bereich kurz dessen Inhalt zusammengefasst wird (natürlich nur sofern dies geht ohne die Interna zu verraten), oder begründet wird, warum dies intern ist.
+<pre>
+{TOP Tagesordnungspunkt
+ Dieser Punkt ist öffentlich.
+ {{config.PRIVATE_KEYWORDS[0]}}: {
+ Dieser Punkt ist intern.
+ Dieser auch, wir diskutieren Kritik an einem namentlich genannten Professor und seiner Vorlesung.
+ Hier entwickeln wir eine Strategie.
+ }
+ Dieser ist wieder öffentlich.
+ Es wurde die Krtik an einer Vorlesung kritsiert.
+}
+</pre>
+{% endif %}
+{% endblock %}
diff --git a/templates/documentation-syntax-lists.html b/templates/documentation-syntax-lists.html
new file mode 100644
index 0000000000000000000000000000000000000000..60cf7c4da881e1301e03a1d8285557faf9e05ab1
--- /dev/null
+++ b/templates/documentation-syntax-lists.html
@@ -0,0 +1,23 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "lists_syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Listen</h3>
+ <h4 id="liste">Liste</h4>
+ Die Liste ist das einzige strukturierende Element.
+ Listen können beliebig geschachtelt werden.
+ Die Elemente der Liste werden durch das Zeilenende getrennt.
+<pre>
+{TOP Tagesordnungspunkt
+ Zeile mit Text drin
+ Hier eine geschachtelte Liste: {
+ Details zu diesem Punkt.
+ Mehr Details zu diesen Punkt.
+ }
+}
+</pre>
+
+ Text, der vor der öffnenden Klammer <code>{</code> steht, wird als Name der Liste angesehen, nur TOPs können Text hinter der öffnenden Klammer haben.
+ Listen in der höchsten Ebene müssen TOPs sein.
+
+{% endblock %}
diff --git a/templates/documentation-syntax-meta.html b/templates/documentation-syntax-meta.html
new file mode 100644
index 0000000000000000000000000000000000000000..b26458292205c73d0323d0865f0ed5d074de242f
--- /dev/null
+++ b/templates/documentation-syntax-meta.html
@@ -0,0 +1,15 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "meta_syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Metadaten</h3>
+
+ <h4 id="metadaten">Metadaten</h4>
+ Die Syntax der Metadaten ist <code>#Name;Wert</code> und die einzelnen Einträge werden durch Zeilenumbrüche getrennt. Folgende Metadaten müssen immer in diesem Format angegeben werden:
+ <ul>
+ <li><code>#Datum;01.01.2017</code> Das Datum der Sitzung</li>
+ <li><code>#Beginn;19:00</code> Beginn der Sitzung</li>
+ <li><code>#Ende;21:42</code> Ende der Sitzung</li>
+ </ul>
+ Zusätzlich können pro Protokolltyp weitere Metadatenfelder konfiguriert werden, beispielsweise der Ort, die Anwesenden Teilnehmer, die Protokollführung, …. Diese haben als Wert beliebigen Text.
+{% endblock %}
diff --git a/templates/documentation-syntax-tags.html b/templates/documentation-syntax-tags.html
new file mode 100644
index 0000000000000000000000000000000000000000..e0cbdd6eae310b6caf3688a84e01ad9bbe6cbf34
--- /dev/null
+++ b/templates/documentation-syntax-tags.html
@@ -0,0 +1,47 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "tags_syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Tags</h3>
+ <h4 id="tag">Tags</h4>
+ Tags können Text besonders hervorheben oder bestimmte Aktionen ausführen.
+ Die grundsätzliche Syntax ist <code>[Name;Arg1;Arg2;…]</code>, wobei theoretisch beliebig viele Argumente angegeben werden können, allerdings je nach Typ nur endlich viele eine Bedeutung haben.
+ <h5>URL-Tag</h5>
+ Mittels <code>[url;https://protokolle.fsmpi.rwth-aachen.de ]</code> kann ein entsprechend formatierter Link eingebunden werden.
+ Das Leerzeichen am Ende ist nicht notwendig für das Protokollsystem, erleichtert aber das Anklicken im Etherpad.
+ <h5>Beschluss-Tag</h5>
+ <code>[beschluss;Wir beschließen etwas tolles.]</code> erzeugt einen Beschluss im Protokoll.
+ Ein Beschluss wird zusätzlich am Anfang des Protokoll angezeigt.
+ Die Beschlüsse sind online durchsuchbar.
+ Beschluss-Tags dürfen nicht in internen Abschnitten stehen.
+ Falls für den Protokolltyp <b>Beschlusskategorien</b> definiert sind, können Beschlüsse mit <code>[…;finanzwirksam;…]</code> diesen zugeordnet werden.
+ Beschlüsse können nach Beschlusskategorien gefiltert werden.
+ Es empfiehlt sich Beschlüsse klar, einfach, eindeutig und auch kontextlos verständlich zu formulieren.
+ Sind die Beschlüsse im Rahmen einer Abstimmung ergangen, so empfiehlt es sich das Abstimmungsergebnis am Ende des Beschlusses in der Form (JA/NEIN/ENTHALTUNG) anzugeben. <code>[beschluss;Wir beschaffen für bis zu 100,00 € einen Stuhl.(9/1/3);finanzwirksam;Inventar]</code>
+ <h5>Todo-Tag</h5>
+ In den Protokollen können <a href="#todos">Todos</a> verwaltet werden.
+ Ein neuer Todo wird mit <code>[todo;Name;Aufgabe]</code> angelegt.
+ Dieser ist dann online und in den Mails sichtbar.
+ Falls der Name einer Mail <a href="{{url_for("list_todomails")}}">zugeordnet</a> ist, wird diese Person (oder AG, AK, …) per Mail über ihre offenen Todos informiert.
+ Mehrere Personen können durch Leerzeichen oder Kommata getrennt angegeben werden.
+
+ Ein bereits bestehender Todo wird mit der zusätzlichen Option <code>[…;id 1338]</code> in ein neues Protokoll eingefügt, falls es den TOP „Todos“ beinhaltet.. Wird dieser Todo dann geändert, passiert das auch im Protokollsystem.
+ Außerdem kann der Status des Todos, z.B. <code>[…;done;…]</code> angegeben werden.
+ Wenn der Status ein Datum benötigt
+ ({{todostates|select("needs_date")|map("todo_get_name")|join(", ")}})
+ muss dies als <code>[…;dd.mm.yyyy;…]</code> angegeben werden.
+ <br>
+ Folgende Begriffe werden vom Protokollsystem verstanden (Groß- und Kleinschreibung spielt keine Rolle):
+ <ul>
+ {% for name in name_to_state %}
+ {% set state = name_to_state[name] %}
+ <li><code>{{name}}{% if state.needs_date() %};dd.mm.yyyy{% endif %}</code>: {{state.get_name()}}</li>
+ {% endfor %}
+ </ul>
+ <h5>Fußnoten-Tag</h5>
+ Fußnoten können im Protokoll mit <code>[footnote;Inhalt]</code> geschrieben werden.
+ <h5>Sitzungs-Tag</h5>
+ Aus dem Protokoll können neue Sitzungen desselben Typs mit dem Tag <code>[sitzung;Datum]</code>, z.B. <code>[sitzung;24.12.2017]</code> angelegt werden.
+ Optional kann zusätzlich eine Uhrzeit angegeben werden: <code>[sitzung;Datum;Uhrzeit]</code> (z.B. <code>[sitzung;01.01.2018;9:00]</code>).
+
+{% endblock %}
diff --git a/templates/documentation-syntax-top.html b/templates/documentation-syntax-top.html
new file mode 100644
index 0000000000000000000000000000000000000000..966fc84fe2ddc93882be6f75c567f68e51e53e0b
--- /dev/null
+++ b/templates/documentation-syntax-top.html
@@ -0,0 +1,15 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "top_syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Tagesordnungspunkte</h3>
+
+ <h4 id="tops">Tagesordnungspunkte</h4>
+ Ein TOP besteht aus einem Titel und beliebigem Inhalt.
+ Ein TOP ist eine besondere Liste (s.u.) und kann somit wie diese verwendet werden.
+<pre>
+{TOP Tagesordnungspunkt
+ Inhalt:
+}
+</pre>
+{% endblock %}
diff --git a/templates/documentation-syntax.html b/templates/documentation-syntax.html
new file mode 100644
index 0000000000000000000000000000000000000000..7c6c9432c779f544ed43a197ed856ae4923539a5
--- /dev/null
+++ b/templates/documentation-syntax.html
@@ -0,0 +1,10 @@
+{% extends "documentation-base.html" %}
+{% set active_page = "syntax_documentation" %}
+
+{% block documentation_content %}
+ <h3>Syntax</h3>
+
+ <h3 id="syntax">Syntax</h3>
+ Ein Dokument beginn mit einigen Metadaten, danach kommen nacheinander die Tagesordnungspunkte, die durch Listen strukturiert sind.
+ Darüberhinaus gibt es Tags, mit denen URLs, Beschlüsse oder ToDos markiert werden können.
+{% endblock %}
diff --git a/templates/documentation.html b/templates/documentation.html
index fd539659aa1c8805ff88fe6d9cd52dd0aadb4c60..0c777236263f0c361970d2881f8b9c65986cb0bd 100644
--- a/templates/documentation.html
+++ b/templates/documentation.html
@@ -1,224 +1,20 @@
-{% extends "layout.html" %}
-{% from "macros.html" import render_table %}
-{% block title %}Dokumentation{% endblock %}
+{% extends "documentation-base.html" %}
+{% set active_page = "documentation" %}
-{% block content %}
-<div class="row">
- <div id="left-column", class="col-lg-6">
+{% block documentation_content %}
<h3>Protokollsystem</h3>
Das Protokollsystem dient der Planung von Sitzungen und Verwaltung von Protokollen. Die anstehenden Sitzungen der nächsten Woche sind auf der <a href="{{url_for("index")}}">Startseite</a>, alle Protokolle unter <a href="{{url_for("list_protocols")}}">Protokolle</a> zu finden.
- <h4 id="planung">Sitzungsplanung</h4>
- Sollte das Protokoll noch nicht existieren:
- <ol>
- <li>Gehe auf <a href="{{url_for("new_protocol")}}">Neu</a></li>
- <li>Wähle bei „Typ“ den Typ der Sitzung aus.</li>
- <li>Gib das Datum der Sitzung ein.</li>
- <li>Anlegen</li>
- </ol>
- Wenn es existiert:
- <ol>
- <li>Gehe auf <a href="{{url_for("list_protocols")}}">Protokolle</a></li>
- <li>Wähle die Sitzung aus. Noch ausstehende Sitzungen sind ganz oben.</a>
- </ol>
- Auf der Seite der Sitzung siehst du die Tagesordnung.
- <ul>
- <li>Die ersten und letztes TOPs sind Standard-TOPs, die jede Sitzung hat. Die kannst du nur über beim Protokolltyp ändern, nicht beim Protokoll selbst.</li>
- <li>Die mittleren TOPs gehören nur zu dieser Sitzung. Du kannst welche hinzufügen oder sie umsortieren.</li>
- <li>Möchtest du zu einem TOP vorprotokollieren, so klicke auf ändern und füge unter "Beschreibung" deinen Inhalt ein (hier gilt die gleiche Syntax, wie im normalen Protokoll).</li>
- <li>Jedes selbstständige Thema oder jeder Antrag sollte in einen eigenen TOP geschrieben werden. Sammel-TOPs, oder TOPs mit allen finanzwirksamen Anträgen sorgen für wenig Übersichtlichkeit.</li>
- <li>Wir wünschen uns, dass TOPs so früh wie möglich auf die Tagesordnung geschrieben werden und unter "Beschreibung" kurz erläutert weird, worum es gehen soll. Sollte es in dem TOP darum gehen, dass Geld beantragt wird, sollte der TOP im Namen durch ein "(€)" gekennzeichnet werden."</li>
- <li>Solltest du die TOPs nicht bearbeiten können, handelt es sich um ein Protokoll, das du lesen, aber nicht bearbeiten kannst. Mehr dazu bei <a href="#rechte">Rechteverwaltung</a>.</li>
- </ul>
- <h4 id="wie">Wie schreibe ich eine Protokoll?</h4>
- Die folgenden Schritte werden erst ein paar Minuten vor der Sitzung ausgeführt. Vorher werden Inhalte und TOPs wie oben beschrieben vorprotokolliert.
- <ol>
- <li>Protokoll auswählen (s.o.)</li>
- <li>mit „In Etherpad“ die Vorlage in das Etherpad schreiben.</li>
- <li>mit „Etherpad“ das Etherpad öffnen</li>
- <li>verlese Tagesordnung und Todos</li>
- <li>falls Todo erledigt, markiere als erledigt (Details siehe <a href="#Todos">Todos</a></li>
- <li>schreibe das Protokoll im Etherpad</li>
- <li>Importiere das Protokoll am Ende mit „Aus Etherpad“</li>
- <li>Falls Fehler auftreten, behebe sie (siehe <a href="#fehler">Fehler</a></li>
- <li>Wenn keine Fehler mehr auftreten, drucke das Protokoll mit „Löschen” (unten beim Anhang) aus.</li>
- <li>Korrekturlesen lassen und im Etherpad korrigieren, dann nochmal „aus Etherpad“</li>
- <li>Drucken und abheften</li>
- <li>Intern per Mail versenden</li>
- <li>Korrekturen abwarten (z.B. die Genehmigung auf der nächsten Sitzung)</li>
- <li>Veröffentlichen (und ggf. öffentlich versenden)</li>
- </ol>
- <h5>Höchst interne Protokolle</h5>
- Falls das Protokoll Daten beinhaltet, die auf keinen Fall öffentlich sein sollten (z.B. personenbezogene Daten bei einem Sozialausschuss), kann anstelle des Editierens im Etherpad auch mit „Vorlage“ die leere Protokollvorlage heruntergeladen werden. Darin kann lokal mit einem beliebigen Texteditor die Sitzung protokolliert werden, um sie dann am Ende lokal zu speichern und mit „Quellcode hochladen“ hochzuladen.
- <h4 id="fehler">Was, wenn etwas nicht funktioniert?</h4>
+
+ <h3 id="fehler">Fehlerbehandlung</h3>
<ul>
<li>Typische Web-Fehler (404, 500, etc.) sollten nicht auftreten. Wenn sie es doch tun, wende dich bitte an die <a href="mailto:{{config.ADMIN_MAIL}}">Admins</a></li>
<li>Wenn beim Parsen, Kompilieren, versenden, hochladen, … Fehler auftreten, werden sie aufgelistet. Die Fehler aller Protokolle findest du unter <a href="{{url_for("list_errors")}}">Fehler</a>. Bei sehr langen Beschreibungen (z.B. LaTeX-Kompilierfehlern) solltest du den einzelnen Fehler anklicken, um die ganze Beschreibung zu erhalten.</li>
<li>Wenn die Fehlerbeschreibung dir nicht ausreicht, um den Fehler zu beheben, wende dich an jemand erfahreneren und lass dir helfen.</li>
</ul>
- <h4 id="todos">Todosystem</h4>
- Das Protokollsystem verwaltet Todos über mehrere Protokolle hinweg. Offene Todos werden in die Protokollvorlage eingefügt, falls diese einen TOP „Todos“ beinhaltet.
- <ul>
- <li>Jedes Todo hat eine (oder durch Kommata oder Leerzeichen getrennt mehrere) Personen, die es erledigen sollen.</li>
- <li>Todos haben auch einen Zustand, in dem sie sich befinden. Es gibt:
- <ul>
- <li>offen: Das Todo muss noch erledigt werden</li>
- <li>wartet auf Rückmeldung: Jemand kümmert sich um das Todo, wartet allerdings gerade darauf, dass jemand anderes (intern oder extern) sich zurückmeldet.</li>
- <li>in Bearbeitung: Jemand kümmert sich gerade um das Todo.</li>
- <li>ab: Das Todo wird erst ab dem Datum relevant.</li>
- <li>vor: Das Todo muss vor dem Datum erledigt werden.</li>
- <li>verwaist: Das Todo hat niemanden, der es erledigen wird.</li>
- <li>erledigt: Das Todo ist erledigt.</li>
- <li>abgewiesen: Das Todo ist nicht und wird nicht mehr erledigt.</li>
- <li>obsolet: Das Todo wurde nicht erledigt und nun ist es zu spät, das noch zu tun.</li>
- </ul>
- </li>
- <li>Alle Todos findest du unter <a href="{{url_for("list_todos")}}">Todos</a>.</li>
- </ul>
-
- <h4 id="suche">Suche</h4>
- <a href="{{url_for("list_protocols")}}">Protokolle</a>, <a href="{{url_for("list_todos")}}">Todos</a> und <a href="{{url_for("list_decisions")}}">Beschlüsse</a> können durchsucht werden.
- Im Suchfeld können mehrere durch Leerzeichen getrennte Suchbegriffe angegeben werden: <code>Begriff1 Begriff2</code>.
- Angezeigt werden alle Ergebnisse, die jeden der Suchbegriffe (unabhängig von Groß- oder Kleinschreibung) enthalten.
- Wenn ein Suchbegriff ein Leerzeichen beinhaltet, muss er mit Anführungszeichen umrandet werden: <code>"Begriff1 mit Leerzeichen" Begriff2</code>.
-
- <h4 id="rechte">Rechteverwaltung</h4>
- Das Protokollsystem hat ein Konzept von Rechteverwaltung, dass auf den Benutzergruppen im LDAP basiert.
- Rechte werden pro Protokolltyp eingestellt.
- Die vorhandenen Rechtestufen sind „Darf öffentliche Version einsehen“, „Darf interne Version einsehen“, „Darf Ändern“ und „Darf Protokolltyp bearbeiten“.
- Jedes Protokoll hat eine öffentliche Gruppe, eine interne Gruppe, eine Bearbeitungsgruppe, eine Verwaltungsgruppe und eine Einstellung, ob es öffentlich ist.<br>
-
- Die öffentliche Version einsehen dürfen:
- <ul>
- <li>
- Nicht authentifizierte Nutzer, wenn für den Protokolltyp „Öffentlich“ eingestellt ist, sobald das Protokoll veröffentlicht ist.
- <ul>
- <li>Die Tagesordnung und Metadaten sind auch vor Veröffentlichung einsehbar.</li>
- </ul>
- </li>
- <li>Authentifizierte Nutzer auch dann, wenn der Protokolltyp nicht „Öffentlich“ ist, aber sie die „Öffentliche Gruppe“ oder die „Interne Gruppe” des Protokolltyps haben. Wenn keine Gruppe eingestellt ist, kann auch kein Nutzer diese haben.</li>
- </ul>
- Die interne Version einsehen dürfen:
- <ul>
- <li>Authentifizierte Nutzer, wenn sie die „Interne Gruppe” des Protokolltyps haben.</li>
- </ul>
- Das Protokoll bearbeiten dürfen:
- <ul>
- <li>Authentifizierte Benutzer, wenn sie die „Bearbeitungsgruppe“ des Protokolltyps haben.</li>
- </ul>
- Die Einstellungen des Protokolltyps bearbeiten und das Protokoll veröffentlichen dürfen:
- <ul>
- <li>Authentifizierte Benutzer, wenn sie die „Verwaltungsgruppe“ des Protokolltyps haben.</li>
- </ul>
-
- Vom Protokoll wird eine interne und eine öffentliche Version generiert, falls es Inhalte gibt, die nur intern sind.
- Todos sind generell intern, Beschlüsse sind generell öffentlich (d.h. einsehbar, wenn man das Recht „Darf öffentliche Version sehen“ hat).
- Daher dürfen Beschlüsse nicht in einem internen Teil des Protokolls sein.
- </div>
- <div id="right-column", class="col-lg-6">
- <h3 id="syntax">Syntax</h3>
- Ein Dokument beginn mit einigen Metadaten, danach kommen nacheinander die Tagesordnungspunkte, die durch Listen strukturiert sind.
- Darüberhinaus gibt es Tags, mit denen URLs, Beschlüsse oder ToDos markiert werden können.
-
- <h4 id="metadaten">Metadaten</h4>
- Die Syntax der Metadaten ist <code>#Name;Wert</code> und die einzelnen Einträge werden durch Zeilenumbrüche getrennt. Folgende Metadaten müssen immer in diesem Format angegeben werden:
- <ul>
- <li><code>#Datum;01.01.2017</code> Das Datum der Sitzung</li>
- <li><code>#Beginn;19:00</code> Beginn der Sitzung</li>
- <li><code>#Ende;21:42</code> Ende der Sitzung</li>
- </ul>
- Zusätzlich können pro Protokolltyp weitere Metadatenfelder konfiguriert werden, beispielsweise der Ort, die Anwesenden Teilnehmer, die Protokollführung, …. Diese haben als Wert beliebigen Text.
- <h4 id="tops">Tagesordnungspunkte</h4>
- Ein TOP besteht aus einem Titel und beliebigem Inhalt.
- Ein TOP ist eine besondere Liste (s.u.) und kann somit wie diese verwendet werden.
-<pre>
-{TOP Tagesordnungspunkt
- Inhalt:
-}
-</pre>
- <h4 id="liste">Liste</h4>
- Die Liste ist das einzige strukturierende Element.
- Listen können beliebig geschachtelt werden.
- Die Elemente der Liste werden durch das Zeilenende getrennt.
-<pre>
-{TOP Tagesordnungspunkt
- Zeile mit Text drin
- Hier eine geschachtelte Liste: {
- Details zu diesem Punkt.
- Mehr Details zu diesen Punkt.
- }
-}
-</pre>
-
- Text, der vor der öffnenden Klammer <code>{</code> steht, wird als Name der Liste angesehen, nur TOPs können Text hinter der öffnenden Klammer haben.
- Listen in der höchsten Ebene müssen TOPs sein.
-{% if config.PRIVATE_KEYWORDS|length > 0 %}
- <h4 id="intern">Interne Abschnitte</h4>
- Wenn der Name einer Liste (bis auf Leerzeichen und einen optionalen <code>:</code>) eins aus
- {{config.PRIVATE_KEYWORDS|map("code")|join(" ")|safe}}
- ist, ist diese Liste intern.
- Daher wird sie nur in der internen Version des Protokolls angezeigt.
- In der öffentlichen Version steht stattdessen nur ein Hinweis auf diese interne Stelle.
- Es bietet sich beim Protokollieren an, wenn nach dem internen Bereich kurz dessen Inhalt zusammengefasst wird (natürlich nur sofern dies geht ohne die Interna zu verraten), oder begründet wird, warum dies intern ist.
-<pre>
-{TOP Tagesordnungspunkt
- Dieser Punkt ist öffentlich.
- {{config.PRIVATE_KEYWORDS[0]}}: {
- Dieser Punkt ist intern.
- Dieser auch, wir diskutieren Kritik an einem namentlich genannten Professor und seiner Vorlesung.
- Hier entwickeln wir eine Strategie.
- }
- Dieser ist wieder öffentlich.
- Es wurde die Krtik an einer Vorlesung kritsiert.
-}
-</pre>
- <h4 id="tag">Tags</h4>
- Tags können Text besonders hervorheben oder bestimmte Aktionen ausführen.
- Die grundsätzliche Syntax ist <code>[Name;Arg1;Arg2;…]</code>, wobei theoretisch beliebig viele Argumente angegeben werden können, allerdings je nach Typ nur endlich viele eine Bedeutung haben.
- <h5>URL-Tag</h5>
- Mittels <code>[url;https://protokolle.fsmpi.rwth-aachen.de ]</code> kann ein entsprechend formatierter Link eingebunden werden.
- Das Leerzeichen am Ende ist nicht notwendig für das Protokollsystem, erleichtert aber das Anklicken im Etherpad.
- <h5>Beschluss-Tag</h5>
- <code>[beschluss;Wir beschließen etwas tolles.]</code> erzeugt einen Beschluss im Protokoll.
- Ein Beschluss wird zusätzlich am Anfang des Protokoll angezeigt.
- Die Beschlüsse sind online durchsuchbar.
- Beschluss-Tags dürfen nicht in internen Abschnitten stehen.
- Falls für den Protokolltyp <b>Beschlusskategorien</b> definiert sind, können Beschlüsse mit <code>[…;finanzwirksam;…]</code> diesen zugeordnet werden.
- Beschlüsse können nach Beschlusskategorien gefiltert werden.
- Es empfiehlt sich Beschlüsse klar, einfach, eindeutig und auch kontextlos verständlich zu formulieren.
- Sind die Beschlüsse im Rahmen einer Abstimmung ergangen, so empfiehlt es sich das Abstimmungsergebnis am Ende des Beschlusses in der Form (JA/NEIN/ENTHALTUNG) anzugeben. <code>[beschluss;Wir beschaffen für bis zu 100,00 € einen Stuhl.(9/1/3);finanzwirksam;Inventar]</code>
- <h5>Todo-Tag</h5>
- In den Protokollen können <a href="#todos">Todos</a> verwaltet werden.
- Ein neuer Todo wird mit <code>[todo;Name;Aufgabe]</code> angelegt.
- Dieser ist dann online und in den Mails sichtbar.
- Falls der Name einer Mail <a href="{{url_for("list_todomails")}}">zugeordnet</a> ist, wird diese Person (oder AG, AK, …) per Mail über ihre offenen Todos informiert.
- Mehrere Personen können durch Leerzeichen oder Kommata getrennt angegeben werden.
-
- Ein bereits bestehender Todo wird mit der zusätzlichen Option <code>[…;id 1338]</code> in ein neues Protokoll eingefügt, falls es den TOP „Todos“ beinhaltet.. Wird dieser Todo dann geändert, passiert das auch im Protokollsystem.
- Außerdem kann der Status des Todos, z.B. <code>[…;done;…]</code> angegeben werden.
- Wenn der Status ein Datum benötigt
- ({{todostates|select("needs_date")|map("todo_get_name")|join(", ")}})
- muss dies als <code>[…;dd.mm.yyyy;…]</code> angegeben werden.
- <br>
- Folgende Begriffe werden vom Protokollsystem verstanden (Groß- und Kleinschreibung spielt keine Rolle):
- <ul>
- {% for name in name_to_state %}
- {% set state = name_to_state[name] %}
- <li><code>{{name}}{% if state.needs_date() %};dd.mm.yyyy{% endif %}</code>: {{state.get_name()}}</li>
- {% endfor %}
- </ul>
- <h5>Fußnoten-Tag</h5>
- Fußnoten können im Protokoll mit <code>[footnote;Inhalt]</code> geschrieben werden.
- <h5>Sitzungs-Tag</h5>
- Aus dem Protokoll können neue Sitzungen desselben Typs mit dem Tag <code>[sitzung;Datum]</code>, z.B. <code>[sitzung;24.12.2017]</code> angelegt werden.
- Optional kann zusätzlich eine Uhrzeit angegeben werden: <code>[sitzung;Datum;Uhrzeit]</code> (z.B. <code>[sitzung;01.01.2018;9:00]</code>).
-
-{% endif %}
{% if git_revision %}
<h3 id="version">Version</h4>
Dieses Protokollsystem nutzt die Software <a href="{{git_revision.url}}">„Protokollsystem 3“</a> in der Version vom <a href="{{git_revision.url}}/commit/{{git_revision.hash}}">{{git_revision.date|datify}}</a>.
Alle Änderungen, die seitdem hinzugekommen sind, kannst du <a href="{{git_revision.url}}/compare/{{git_revision.hash}}...master">hier</a> sehen.
{% endif %}
- </div>
-</div>
{% endblock %}