1. clone the [repository](https://git.fsmpi.rwth-aachen.de/protokollsystem/proto3)
2. create a python virtualenv and install the packages from `requirements.txt` there
3. create a database (tested with postgres and sqlite, but feel free to use whatever you like and [SQLAlchemy](http://docs.sqlalchemy.org/en/latest/dialects/index.html) supports
4. copy `config.py.example` to `config.py` and edit it
***do** change everything commented with `change this`
* do **not** change the lines commented with `do not change`
4. create `config.py` with `flask create_example_config config.py` and edit it
***do** change everything that is not commented out
* change commented out settings if they are wrong
***do** change the random keys `SECRET_KEY` and `SECURITY_KEY` to something random (although the generated config already uses random values generated with `os.urandom`)
* deactivate unwanted features with `SOMETHING_ACTIVE = False`
* if you want to use a feature, set the connection configuration lines accordingly
* define a list of authentication backends (usually one):
- use LdapManager for slapd
- use ADManager for Samba
- write your own for anything else (see `auth.py`, just the methods `authenticate` and `groups` are required)
* define the available printers (if wanted) with a list of options they should use (see lpoptions)
* if you do not know what a MediaWiki-domain is, you probably don't need it
- write your own for anything else (see `common/auth.py`, the methods `authenticate`, `groups` and `all_groups` are required)
**MAIL* requires an SMTP(S) server, optionally with STARTTLS or TLS
**PRINTING* requires a CUPS printserver
**ETHERPAD* requires an etherpad installation
**WIKI* requires a MediaWiki or DokuWiki installation
**CALENDAR* requires a CalDAV server
* fix the path to the fonts (and select which to use)
* most points should be documented in the example config
5. create the database schema with `./server.py db upgrade`
5. create the database schema with `flask db upgrade`
6. configure your server to run the wsgi-application and the celery-server
* if you use systemd, example service files are located in `example-config/` in this repository
7. configure your webserver to serve the wsgi-application
Das Versenden von E-Mails zu offenen Aufgaben ist hier bisher noch nicht vorgesehen. Um den automatischen E-Mailversand nutzen zu können, wende dich bitte an die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> und lasse die <ahref="/documentation/configuration/settings">Konfiguration</a> durch sie entsprechend anpassen.
Das Versenden von E-Mails zu offenen Aufgaben ist hier bisher noch nicht vorgesehen. Um den automatischen E-Mailversand nutzen zu können, wende dich bitte an die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> und lasse die <ahref="{{url_for("settings_configuration_documentation")}}">Konfiguration</a> durch sie entsprechend anpassen.
Damit Protokolle im Protokollsystem überhaupt <ahref="/documentation/sessionmanagement/write">geschrieben</a> und <ahref="/documentation/sessionmanagement/plan">Sitzungen verwaltet</a> werden können, ist es unerlässlich entsprechende Protokolltypen anzulegen. Auf der <ahref="{{url_for('list_types')}}">Protokolltypen-Übersichtsseite</a> werden die Typen aufgelistet, wobei nur die Typen angezeigt werden, deren Protokolle man sehen darf (weiteres hierzu unter <ahref="#rechte">Rechtekonfiguration</a>).
Damit Protokolle im Protokollsystem überhaupt <ahref="{{url_for("write_sessionmanagement_documentation")}}">geschrieben</a> und <ahref="{{url_for("plan_sessionmanagement_documentation")}}">Sitzungen verwaltet</a> werden können, ist es unerlässlich entsprechende Protokolltypen anzulegen. Auf der <ahref="{{url_for('list_types')}}">Protokolltypen-Übersichtsseite</a> werden die Typen aufgelistet, wobei nur die Typen angezeigt werden, deren Protokolle man sehen darf (weiteres hierzu unter <ahref="#rechte">Rechtekonfiguration</a>).
</p>
<divclass="panel panel-default">
<divclass="panel-heading">
...
...
@@ -455,7 +455,7 @@
</div>
</div>
<p>
Die Konfiguration eines Metadatenfeldes beinhaltet immer den Anzeigenamen (Name) und den beim <ahref="/documentation/syntax/meta">Protokollieren zu verwendenden Namen</a> des Feldes (Key). Des weiteren ist es möglich einen Standardwert für das Metadatenfelder zu hinterlegen, welcher beim Erstellen einer neuen Sitzung in das Feld geschrieben wird, so fern es als Planungsrelevant (vorher) markiert wurde. Zudem ist es möglich Metadaten nur in der internen Version eines Protokolls anzuzeigen, wenn das entsprechende Feld als intern festgelegt wurde.
Die Konfiguration eines Metadatenfeldes beinhaltet immer den Anzeigenamen (Name) und den beim <ahref="{{url_for("meta_syntax_documentation")}}">Protokollieren zu verwendenden Namen</a> des Feldes (Key). Des weiteren ist es möglich einen Standardwert für das Metadatenfelder zu hinterlegen, welcher beim Erstellen einer neuen Sitzung in das Feld geschrieben wird, so fern es als Planungsrelevant (vorher) markiert wurde. Zudem ist es möglich Metadaten nur in der internen Version eines Protokolls anzuzeigen, wenn das entsprechende Feld als intern festgelegt wurde.
Eine wichtige Eigenschaft des Protokollsystems ist die Konfigurierbarkeit. Das System lässt sich individuell auf die Bedürfnisse der eigenen Organisationseinheit anpassen. Einige Einstellungen können direkt über die Weboberfläche vorgenommen werden und stehen allen Benutzern zur Verfügung. Dazu gehören:
Andere Einstellungen werden direkt bei der Installation und Einrichtung des Protokollsystems durch die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> vorgenommen. Zu diesen <ahref="configuration/settings">Systemeinstellungen</a> zählen unter anderem Features wie das automatische Versenden von E-Mails oder die Nutzung eines Etherpads zum Schreiben von Protokollen.
Andere Einstellungen werden direkt bei der Installation und Einrichtung des Protokollsystems durch die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> vorgenommen. Zu diesen <ahref="{{url_for("settings_configuration_documentation")}}">Systemeinstellungen</a> zählen unter anderem Features wie das automatische Versenden von E-Mails oder die Nutzung eines Etherpads zum Schreiben von Protokollen.
Alle in den Protollen festgehaltenen Beschlüsse werden in der <ahref="{{url_for('list_decisions')}}">Beschlussübersicht</a> angezeigt. Neben dem Beschlusstext beinhaltet die Übersicht die zu den Beschlüssen gehörenden Protokoll sowie die <ahref="/documentation/configuration/types#decision_categories">Beschlusskategorie</a>. In den einzelnen Protokollen werdend die Beschlüsse ebenfalls zusammengefasst dargestellt, um einen Überbrlick über alle Beschlüsse der betrefenden Sitzung zu erhalten.
Alle in den Protollen festgehaltenen Beschlüsse werden in der <ahref="{{url_for('list_decisions')}}">Beschlussübersicht</a> angezeigt. Neben dem Beschlusstext beinhaltet die Übersicht die zu den Beschlüssen gehörenden Protokoll sowie die <ahref="{{url_for("types_configuration_documentation")}}#decision_categories">Beschlusskategorie</a>. In den einzelnen Protokollen werdend die Beschlüsse ebenfalls zusammengefasst dargestellt, um einen Überbrlick über alle Beschlüsse der betrefenden Sitzung zu erhalten.
</p>
{% if config.PRINTING_ACTIVE %}
<p>
Beschlüsse können direkt aus dem Protokollsystem an den im <ahref="/documentation/configuration/types">Protokolltyp</a> hinterlegten Drucker durch klicken auf „Drucken“ zum Drucken gesendet werden, so dass gedruckte Beschlüsse beispielsweise mit Kassenanweisungen abgeheftet werden können.
Beschlüsse können direkt aus dem Protokollsystem an den im <ahref="{{url_for("types_configuration_documentation")}}">Protokolltyp</a> hinterlegten Drucker durch klicken auf „Drucken“ zum Drucken gesendet werden, so dass gedruckte Beschlüsse beispielsweise mit Kassenanweisungen abgeheftet werden können.
</p>
{% endif %}
<divclass="panel panel-default">
...
...
@@ -79,7 +79,7 @@
<h4id="todos">Aufgaben (Todos)</h4>
<p>
Einzelne Aufgaben, die während oder außerhalb einer Sitzung vergeben werden, können mit dem Protokollsystem über mehrere Protokolle hinweg verwaltet werden. Offene Todos werden dabei automatisch in die Protokollvorlage eingefügt, falls diese einen <ahref="/documentation/configuration/types">Standard-TOP</a> „Todos“ beinhaltet. Darüberhinaus können alle Todos auf der entsprechenden <ahref="{{url_for('list_todos')}}">Übersichtsseite</a> eingesehen werden.
Einzelne Aufgaben, die während oder außerhalb einer Sitzung vergeben werden, können mit dem Protokollsystem über mehrere Protokolle hinweg verwaltet werden. Offene Todos werden dabei automatisch in die Protokollvorlage eingefügt, falls diese einen <ahref="{{url_for("types_configuration_documentation")}}">Standard-TOP</a> „Todos“ beinhaltet. Darüberhinaus können alle Todos auf der entsprechenden <ahref="{{url_for('list_todos')}}">Übersichtsseite</a> eingesehen werden.
</p>
<divclass="panel panel-default">
<divclass="panel-heading">
...
...
@@ -152,7 +152,7 @@
</div>
</div>
<p>
Aufgaben können im Protokollsystem auch außerhalb eines Protokolls direkt auf der <ahref="{{url_for('list_todos')}}">Übersichtsseite</a> über die Schaltfläche „neu“ angelegt werden. Zu jeder Aufgabe sollte mindestens eine Person zugeordnet werden, die das Todo erledigt. Werden mehrere Personen angegeben, so sind diese durch Kommata oder Leerzeichen zu trennen. In aller Regel wird für jede Person ein internes Personenkürzel für die Zuweisung einer Aufgabe genutzt. Damit diese Personen eine Benachrichtigung über das neue Todo erhalten, sollten zu jedem internen Personenkürzel eine <ahref="/documentation/configuration/todomails">E-Mailadresse</a> hinterlegt werden.
Aufgaben können im Protokollsystem auch außerhalb eines Protokolls direkt auf der <ahref="{{url_for('list_todos')}}">Übersichtsseite</a> über die Schaltfläche „neu“ angelegt werden. Zu jeder Aufgabe sollte mindestens eine Person zugeordnet werden, die das Todo erledigt. Werden mehrere Personen angegeben, so sind diese durch Kommata oder Leerzeichen zu trennen. In aller Regel wird für jede Person ein internes Personenkürzel für die Zuweisung einer Aufgabe genutzt. Damit diese Personen eine Benachrichtigung über das neue Todo erhalten, sollten zu jedem internen Personenkürzel eine <ahref="{{url_for("todomails_configuration_documentation")}}">E-Mailadresse</a> hinterlegt werden.
<h4id="session_start">Mit Beginn einer Sitzung</h4>
<p>
Kurz bevor die Sitzung los geht oder mit dem Beginn der Sitzung wird das Protokoll erzeugt und die offenen <ahref="/documentation/syntax/meta">Metadaten</a> ausgefüllt. Um dies zu erreichen werden die folgenden Schritte durchgeführt.
Kurz bevor die Sitzung los geht oder mit dem Beginn der Sitzung wird das Protokoll erzeugt und die offenen <ahref="{{url_for("meta_syntax_documentation")}}">Metadaten</a> ausgefüllt. Um dies zu erreichen werden die folgenden Schritte durchgeführt.
</p>
<ol>
<li>Stelle sicher, dass alle mit dem Vorprotokollieren fertig sind.</li>
...
...
@@ -58,10 +58,10 @@
{% if config.ETHERPAD_ACTIVE %}
<li>Schreibe das Protokoll im Etherpad.</li>
{% endif %}
<li>Fülle alle benötigten <ahref="/documentation/syntax/meta">Metadatenfelder</a>.</li>
<li>Falls <ahref="/documentation/syntax/tags#todo">Todos</a> erledigt sind, markiere diese als erledigt.</li>
<li>Erfasse Beschlüsse die während einer Sitzung getroffen werden mit dem <ahref="/documentation/syntax/tags#decision">Beschluss-Tag</a>.</li>
<li>Nutze auch die anderen <ahref="/documentation/syntax/tags">Tags</a>, wo diese erforderlich sind.</li>
<li>Fülle alle benötigten <ahref="{{url_for("meta_syntax_documentation")}}">Metadatenfelder</a>.</li>
<li>Falls <ahref="{{url_for("tags_syntax_documentation")}}#todo">Todos</a> erledigt sind, markiere diese als erledigt.</li>
<li>Erfasse Beschlüsse die während einer Sitzung getroffen werden mit dem <ahref="{{url_for("tags_syntax_documentation")}}#decision">Beschluss-Tag</a>.</li>
<li>Nutze auch die anderen <ahref="{{url_for("tags_syntax_documentation")}}">Tags</a>, wo diese erforderlich sind.</li>
Ein wesentlicher Bestandteil des Protokollsystems ist das Sitzungsmanagement. Neben dem <ahref="/documentation/sessionmanagement/plan">Planen und Anlegen</a> verschiedener Sitzungstermine kann zu jeder Sitzung ein <ahref="/documentation/sessionmanagement/write">Protokoll</a> verfasst und anschließend durch das System ausgegeben werden. Die <ahref="/documentation/sessionmanagement/tracking">Nachverfolgung</a> von Ergebnissen ist im System in Form von Beschlüssen und Todos möglich.
Ein wesentlicher Bestandteil des Protokollsystems ist das Sitzungsmanagement. Neben dem <ahref="{{url_for("plan_sessionmanagement_documentation")}}">Planen und Anlegen</a> verschiedener Sitzungstermine kann zu jeder Sitzung ein <ahref="{{url_for("write_sessionmanagement_documentation")}}">Protokoll</a> verfasst und anschließend durch das System ausgegeben werden. Die <ahref="{{url_for("tracking_sessionmanagement_documentation")}}">Nachverfolgung</a> von Ergebnissen ist im System in Form von Beschlüssen und Todos möglich.
</p>
<h4>Verwaltung im Detail</h4>
<p>
Die einzelnen Funktionen des Sitzungsmanagements werden jeweils auf Unterseiten erläutert. Auch werden die Arbeitsabläufe, wie sie im System vorgesehen sind, vorgestellt.
Sollten die genannten Arbeitsabläufe nicht nachvollziehbar oder fehlerhaft sein, dann kontaktiere bitte das Entwicklungsteam der Software. Als Tipp: Je genauer du ein Problem beschreiben kannst, desto einfacher machst du es den betroffenen Personen selbiges zu fixen und desto schneller hast du eine Lösung.
Die Verwendung von internen Abschnitte ist hier bisher noch nicht vorgesehen. Um interne Abschnitte nutzen zu können, wende dich bitte an die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> und lasse die <ahref="/documentation/configuration/settings">Konfiguration</a> durch sie entsprechend anpassen.
Die Verwendung von internen Abschnitte ist hier bisher noch nicht vorgesehen. Um interne Abschnitte nutzen zu können, wende dich bitte an die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a> und lasse die <ahref="{{url_for("settings_configuration_documentation")}}">Konfiguration</a> durch sie entsprechend anpassen.
In einem Protokoll repräsentieren die Metadaten allgemeine Informationen rund um eine Sitzung. Die Metadaten stehen immer am Anfang eines Protokolls. Zu den Metadaten zählen das Datum der Sitzung, der Beginn und das Ende sowie weitere pro <ahref="/documentation/configuration/types">Protokolltyp</a> konfigurierte <ahref="/documentation/configuration/types#meta">Metadatenfelder</a>, wie beispielsweise der Ort, die Anwesenden oder die Protokollführung. Alle <ahref="/documentation/configuration/types#meta">Metadatenfelder</a> werden beim Erzeugen der Protokollvorlage durch das System automatisch in das Protokoll übertragen. Dies schließt auch den Inhalt der Felder ein, so weit dieser vor <ahref="/documentation/sessionmanagement/plan">Beginn der Sitzung</a> eingegeben wurde.
In einem Protokoll repräsentieren die Metadaten allgemeine Informationen rund um eine Sitzung. Die Metadaten stehen immer am Anfang eines Protokolls. Zu den Metadaten zählen das Datum der Sitzung, der Beginn und das Ende sowie weitere pro <ahref="{{url_for("types_configuration_documentation")}}">Protokolltyp</a> konfigurierte <ahref="{{url_for("types_configuration_documentation")}}#meta">Metadatenfelder</a>, wie beispielsweise der Ort, die Anwesenden oder die Protokollführung. Alle <ahref="{{url_for("types_configuration_documentation")}}#meta">Metadatenfelder</a> werden beim Erzeugen der Protokollvorlage durch das System automatisch in das Protokoll übertragen. Dies schließt auch den Inhalt der Felder ein, so weit dieser vor <ahref="{{url_for("plan_sessionmanagement_documentation")}}">Beginn der Sitzung</a> eingegeben wurde.
</p>
<h4>Definition</h4>
<p>
...
...
@@ -17,6 +17,6 @@
<li><codeclass="highlight"style="color: inherit;"><spanclass="nc">#Ende</span>;<spanclass="mi">21:42</span></code> Ende der Sitzung</li>
</ul>
<p>
Wurden <ahref="/documentation/configuration/types#meta">Metadatenfelder</a> im <ahref="/documentation/configuration/types">Protokolltyp</a> konfigurierte so muss als <codeclass="highlight"style="color: inherit;"><spanclass="nc">Name</span></code> der festgelegte Key verwendet werden. Dabei muss die Groß- und Kleinschreibung beachtet werden.
Wurden <ahref="{{url_for("types_configuration_documentation")}}#meta">Metadatenfelder</a> im <ahref="{{url_for("types_configuration_documentation")}}">Protokolltyp</a> konfigurierte so muss als <codeclass="highlight"style="color: inherit;"><spanclass="nc">Name</span></code> der festgelegte Key verwendet werden. Dabei muss die Groß- und Kleinschreibung beachtet werden.
Ein Beschluss kann mit <ahref="/documentation/configuration/types#decision_categories">Beschlusskategorien</a> versehen werden, um Beschlüsse zu einzelnen Themen zusammenfassen zu können. Des Versehen mit Kategorien ist jedoch kein muss. <ahref="/documentation/configuration/types#decision_categories">Kategorien</a> müssen vor der Verwendung in den Einstellungen des Protokolltyps definiert werden. Danach können Beschlüsse durch die Angabe der Kategorie entsprechend zugeordnet werden, z.B. <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="sx">finanzwirksam</span>;…<spanclass="nt">]</span></code>.
Ein Beschluss kann mit <ahref="{{url_for("types_configuration_documentation")}}#decision_categories">Beschlusskategorien</a> versehen werden, um Beschlüsse zu einzelnen Themen zusammenfassen zu können. Des Versehen mit Kategorien ist jedoch kein muss. <ahref="{{url_for("types_configuration_documentation")}}#decision_categories">Kategorien</a> müssen vor der Verwendung in den Einstellungen des Protokolltyps definiert werden. Danach können Beschlüsse durch die Angabe der Kategorie entsprechend zugeordnet werden, z.B. <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="sx">finanzwirksam</span>;…<spanclass="nt">]</span></code>.
</p>
<p>
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.
...
...
@@ -88,7 +88,7 @@
<h4id="todo">Todo-Tag</h4>
<p>
Soll in einer Sitzung die Vergebene einer <ahref="/documentation/sessionmanagement/tracking#todos">Aufgabe</a> an eine oder mehrere Personen (oder AG, AK, …) festgehalten werden, so kann mittels des Tags <codeclass="highlight"style="color: inherit;"><spanclass="nt">todo</span></code> diese Aufgabe im Protokoll festgehalten werden. Neben dem Namen der Person, welche die Aufgabe erledigen möchte, wird die Aufgabe innerhalb des Tags festgehalten. Die Aufgabe ist nach der Sitzung in der <ahref="{{url_for('list_todos')}}">Todo-Übersicht</a> und nur im internen Protokoll einsehbar.
Soll in einer Sitzung die Vergabe einer <ahref="{{url_for("tracking_sessionmanagement_documentation")}}#todos">Aufgabe</a> an eine oder mehrere Personen (oder AG, AK, …) festgehalten werden, so kann mittels des Tags <codeclass="highlight"style="color: inherit;"><spanclass="nt">todo</span></code> diese Aufgabe im Protokoll festgehalten werden. Neben dem Namen der Person, welche die Aufgabe erledigen möchte, wird die Aufgabe innerhalb des Tags festgehalten. Die Aufgabe ist nach der Sitzung in der <ahref="{{url_for('list_todos')}}">Todo-Übersicht</a> und nur im internen Protokoll einsehbar.
Eine bereits bestehende und noch offene Aufgabe wird automatisch in ein neues Protokoll eingefügt, wenn der TOP „Todos“ auf der Tagesordnung steht (der TOP also im Protokoll enthalten ist). Zusätzlich erhält die Aufgabe dann als optionales Argument eine ID: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="kr">id</span><spanclass="mi">1338</span><spanclass="nt">]</span></code>. Wird dieser Todo dann während des Protokollierens geändert, passiert das auch im Protokollsystem.
</p>
<p>
In einem weiteren optionalen Argument kann außerdem der Status einer Aufgabe, z.B. <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="kr">done</span>;…<spanclass="nt">]</span></code> angegeben werden. Die Groß- und Kleinschreibung spielen bei der Verwendung keine Rolle. Wenn der Status ein Datum benötigt, muss dieser immer mit angegeben und hat die Form: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">dd.mm.yyyy</span>;…<spanclass="nt">]</span></code>. Bei der Angabe des Datums ist es unerheblich, an welcher Stelle innerhalb des Tags es auftacht. Eine Auflistung der verwendbaren Status-Begriffe und ob Status ein Datum benötigt, ist in der folgenden Tabelle angegeben.
In einem weiteren optionalen Argument kann außerdem der Status einer Aufgabe, z.B. <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="kr">done</span>;…<spanclass="nt">]</span></code> angegeben werden. Die Groß- und Kleinschreibung spielen bei der Verwendung keine Rolle. Wenn der Status ein Datum benötigt, muss dieses immer mit angegeben werden und hat die Form: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">dd.mm.yyyy</span>;…<spanclass="nt">]</span></code>. Bei der Angabe des Datums ist es unerheblich, an welcher Stelle innerhalb des Tags es auftaucht. Eine Auflistung der verwendbaren Status-Begriffe und ob Status ein Datum benötigt, ist in der folgenden Tabelle angegeben.
</p>
<tableclass="table table-striped">
<thead>
...
...
@@ -111,11 +111,11 @@
</tr>
</thead>
<tbody>
{% for state, posibilities in states.items() %}
{% for state, possibilities in states.items() %}
<tr>
<td>{{state.get_name()}}</td>
<td><spanclass="glyphicon glyphicon-{% if state.needs_date() %}ok{% else %}remove{% endif %}"aria-hidden="true"></span></td>
Werden während einer Sitzung bereits Termine für zukünfigt Sitzungen desselben Typs festgelegt, so können diese direkt aus dem Protokoll heraus angelegt und im Protokoll entsprechend hervorgehoben werden. Es wird der Tag des Types <codeclass="highlight"style="color: inherit;"><spanclass="nt">sitzung</span></code> genutzt. Als Argument muss mindestens das Datum übergeben werden und es hat die Form: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">dd.mm.yyyy</span>;…<spanclass="nt">]</span></code>. Optional kann zusätzlich eine Uhrzeit in folgender Form angegeben werden: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">h:mm</span><spanclass="nt">]</span></code>.
Werden während einer Sitzung bereits Termine für zukünfige Sitzungen desselben Typs festgelegt, so können diese direkt aus dem Protokoll heraus angelegt und im Protokoll entsprechend hervorgehoben werden. Es wird der Tag des Types <codeclass="highlight"style="color: inherit;"><spanclass="nt">sitzung</span></code> genutzt. Als Argument muss mindestens das Datum übergeben werden und es hat die Form: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">dd.mm.yyyy</span>;…<spanclass="nt">]</span></code>. Optional kann zusätzlich eine Uhrzeit in folgender Form angegeben werden: <codeclass="highlight"style="color: inherit;"><spanclass="nt">[</span>…;<spanclass="mi">h:mm</span><spanclass="nt">]</span></code>.
Ein wichtiges Elements in jedem Protokoll sind Tagesordnungspunkte. Sie sind in einem Protokoll stehts die oberste Gliederungsebene. In den meisten Fällen stehen diese Punkte bereits vor Beginn der Sitzung fest und wurden entsprechend vorher <ahref="/documentation/sessionmanagement/plan#prepare">eingepflegt</a>.
Ein wichtiges Elements in jedem Protokoll sind Tagesordnungspunkte. Sie sind in einem Protokoll stehts die oberste Gliederungsebene. In den meisten Fällen stehen diese Punkte bereits vor Beginn der Sitzung fest und wurden entsprechend vorher <ahref="{{url_for("plan_sessionmanagement_documentation")}}#prepare">eingepflegt</a>.
</p>
<p>
Beim Erstellen der Protokollvorlage durch das System werden die bereits <ahref="/documentation/sessionmanagement/plan#prepare">angelegten TOPs</a> mit dem vorprotokollierten Inhalt in der Tagesordnung festgelegten Reihenfolge übertragen. Während des Schreibens des Protokolls können jeder Zeit Tagesordnungspunkte hinzugefügt oder entfernt werden.
Beim Erstellen der Protokollvorlage durch das System werden die bereits <ahref="{{url_for("plan_sessionmanagement_documentation")}}#prepare">angelegten TOPs</a> mit dem vorprotokollierten Inhalt in der Tagesordnung festgelegten Reihenfolge übertragen. Während des Schreibens des Protokolls können jeder Zeit Tagesordnungspunkte hinzugefügt oder entfernt werden.
</p>
<h4>Definition</h4>
<divclass="row">
<divclass="col-sm-9">
<p>
In Protokollsystax wird ein Tagesordnungspunkt stets von geschweiften Klammern eingeschlossen. An die öffnende Klammer schließt sich das Schlüsselwort <code>TOP</code> an. Abgesetzt mit einem Leerzeichen folgt der Titel des TOPs. Nach einem Zeilenumbruach als in einer neuen Zeile beginnt dann der Inhalt des Tagesordnungspunkts. Durch die Verwendung von sogenannten <ahref="lists">Listen</a> kann die Mitschrift in einem Tagesordnungspunkt strukturiert werden.
In Protokollsystax wird ein Tagesordnungspunkt stets von geschweiften Klammern eingeschlossen. An die öffnende Klammer schließt sich das Schlüsselwort <code>TOP</code> an. Abgesetzt mit einem Leerzeichen folgt der Titel des TOPs. Nach einem Zeilenumbruch als in einer neuen Zeile beginnt dann der Inhalt des Tagesordnungspunkts. Durch die Verwendung von sogenannten <ahref="lists">Listen</a> kann die Mitschrift in einem Tagesordnungspunkt strukturiert werden.
Das Herz des Protokollsystems ist die eigentliche Protokollsyntax, aus dem systemintern ein druckbares Dokument und menschenlesbarer Webseiteninhalt erstellt wird. Die Systax sieht eine Strukturierung des Prokolls vor. Ein Dokument beginn mit einigen Metadaten, danach kommen nacheinander die Tagesordnungspunkte, die strukturiert diskuiterte Punkte enthalten. Darüberhinaus gibt es Tags, mit denen unter anderem URLs, Beschlüsse oder ToDos markiert werden können.
Das Herz des Protokollsystems ist die eigentliche Protokollsyntax, aus dem systemintern ein druckbares Dokument und menschenlesbarer Webseiteninhalt erstellt wird. Die Systax sieht eine Strukturierung des Protokolls vor. Ein Dokument beginn mit einigen Metadaten, danach kommen nacheinander die Tagesordnungspunkte, die strukturiert diskutierte Punkte enthalten. Darüberhinaus gibt es Tags, mit denen unter anderem URLs, Beschlüsse oder ToDos markiert werden können.
</p>
<h4>Allgemeine Grundsätze</h4>
<p>
...
...
@@ -14,17 +14,27 @@
<ul>
<li>Jede geschweifte oder eckige Klammer die aufgemacht wird, wird sofort wieder geschlossen und anschließend der Inhalt zwischen die Klammern geschrieben.</li>
<li>Jeder Zeilenumbruch erzeugt eine neue Zeile im Protokoll.</li>
{% for term in ["TOP", "private", "todo", "id", "beschluss", "url", "footnote", "sitzung"] %}
<codeclass="highlight"style="color: inherit;">
<spanclass="kr">{{term}}</span>
</code>
{% endfor %}
</ul>
<h4>Der Syntax im Detail</h4>
<p>
Um die Funktionsweise und das Verhalten des Protokollsystems bei der Umwandlung eines Protokolls zu verstehen, wird auf den Unterseiten auf die einzelnen Elemente der Protokollsyntax näher eingegangen.
Das Protokollsystem dient der Planung von Sitzungen und Verwaltung von Protokollen. Die anstehenden Sitzungen der nächsten Woche sind auf der <ahref="{{url_for('index')}}">Startseite</a>, alle Protokolle unter <ahref="{{url_for('list_protocols')}}">Protokolle</a> zu finden.
</p>
<p>
Des weiteren können die Sitzungen mittels Todos und einer Beschlussdatenbank nach verfolgt werden. Die eigenen offenen Todos werden auf der <ahref="{{url_for('index')}}">Startseite</a> angezeigt, alle Todos sind unter <ahref="{{url_for('list_todos')}}">Todos</a> zu finden. Die Beschlüsse finden sich in der <ahref="{{url_for('list_decisions')}}">Beschlussdatenbank</a>.
</p>
<h3>Dokumentation</h3>
Dieser Dokumentation können Beschreibungen zu nahezu allen wichtigen Systemfunktionen entnommen werden. Gegliedert sind die Themen wie folgt:
Sollten deine Fragen nach dem Studium der Dokumentation noch offen sein, wende dich an jemand erfahreneren oder die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a>. Offene Punkte innerhalb der Dokumentation können dann durch die Admins zur Behebung auch an die Entwickler der Software weitergegeben werden.
</p>
</p>
<p>
Des weiteren können die Sitzungen mittels Todos und einer Beschlussdatenbank nach verfolgt werden. Die eigenen offenen Todos werden auf der <ahref="{{url_for('index')}}">Startseite</a> angezeigt, alle Todos sind unter <ahref="{{url_for('list_todos')}}">Todos</a> zu finden. Die Beschlüsse finden sich in der <ahref="{{url_for('list_decisions')}}">Beschlussdatenbank</a>.
</p>
<h3>Dokumentation</h3>
Dieser Dokumentation können Beschreibungen zu nahezu allen wichtigen Systemfunktionen entnommen werden. Gegliedert sind die Themen wie folgt:
Sollten deine Fragen nach dem Studium der Dokumentation noch offen sein, wende dich an jemand erfahreneren oder die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a>. Offene Punkte innerhalb der Dokumentation können dann durch die Admins zur Behebung auch an die Entwickler der Software weitergegeben werden.
</p>
<h3id="fehler">Fehlerbehandlung</h3>
<ul>
<li>Typische Web-Fehler (404, 500, etc.) sollten nicht auftreten. Wenn sie es doch tun, wende dich bitte an die <ahref="mailto:{{config.ADMIN_MAIL}}">Admins</a></li>
...
...
@@ -43,9 +43,9 @@
{% if git_revision %}
<h3id="version">Version</h4>
<p>
<p>
Dieses Protokollsystem nutzt die Software <ahref="{{git_revision.url}}">„Protokollsystem 3“</a> in der Version vom <ahref="{{git_revision.url}}/commit/{{git_revision.hash}}">{{git_revision.date|datify}}</a>.<br/>
Alle Änderungen, die seitdem hinzugekommen sind, kannst du <ahref="{{git_revision.url}}/compare/{{git_revision.hash}}...master">hier</a> sehen.
