diff --git a/THANKS b/THANKS
index 2627879f3..403257ff4 100644
--- a/THANKS
+++ b/THANKS
@@ -28,3 +28,11 @@ OpenSlides uses parts of the following projects:
* Ubuntu TrueType Font
+
+* Sphinx
+
+ License: BSD
+
+* Sphinx Bootstrap Theme
+
+ License: MIT
diff --git a/docs/_static/logo.png b/docs/_static/logo.png
new file mode 100644
index 000000000..7248357cb
Binary files /dev/null and b/docs/_static/logo.png differ
diff --git a/docs/_static/openslides-logo_wide.pdf b/docs/_static/openslides-logo_wide.pdf
new file mode 100644
index 000000000..3fbc7e10b
Binary files /dev/null and b/docs/_static/openslides-logo_wide.pdf differ
diff --git a/docs/_static/openslides-logo_wide75.png b/docs/_static/openslides-logo_wide75.png
deleted file mode 100644
index 12d92692c..000000000
Binary files a/docs/_static/openslides-logo_wide75.png and /dev/null differ
diff --git a/docs/_static/openslidesdoc.css b/docs/_static/openslidesdoc.css
deleted file mode 100644
index f36f33c74..000000000
--- a/docs/_static/openslidesdoc.css
+++ /dev/null
@@ -1,6 +0,0 @@
-@import url('sphinxdoc.css');
-
-/* Specific stylesheet for OpenSlides Documentation */
-
-.screenshot {
- width:50%;}
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
deleted file mode 100644
index d398b67c7..000000000
--- a/docs/_templates/layout.html
+++ /dev/null
@@ -1,24 +0,0 @@
-{% extends "!layout.html" %}
-
-{% block extrahead %}
-{{ super() }}
-{%- if not embedded %}
-
-{%- endif %}
-{% endblock %}
-
-{% block header %}
-
-{% endblock %}
-
-{% block rootrellink %}
- OpenSlides Website |
- Inhaltsverzeichnis
-{% endblock %}
diff --git a/docs/conf.py b/docs/conf.py
index d00de9d83..992c20d41 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -12,7 +12,7 @@
# serve to show the default.
import sys, os
-
+import sphinx_bootstrap_theme
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -28,7 +28,7 @@ import sys, os
extensions = []
# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+# templates_path = ['_templates']
# The suffix of source filenames.
source_suffix = '.rst'
@@ -40,7 +40,7 @@ source_suffix = '.rst'
master_doc = 'index'
# General information about the project.
-project = u'OpenSlides'
+project = u'OpenSlides Handbuch'
copyright = u'2012–2013, OpenSlides Team'
# The version info for the project you're documenting, acts as replacement for
@@ -48,9 +48,9 @@ copyright = u'2012–2013, OpenSlides Team'
# built documents.
#
# The short X.Y version.
-version = '1.4'
+version = 'v1.4'
# The full version, including alpha/beta/rc tags.
-release = '1.4'
+release = 'v1.4'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
@@ -91,14 +91,19 @@ pygments_style = 'sphinx'
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
-html_theme = 'sphinxdoc'
-# Adeption for OpenSlides #
-html_style = 'openslidesdoc.css'
+html_theme = 'bootstrap'
+html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()
+# html_style = 'style.css'
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
# documentation.
-#html_theme_options = {}
+html_theme_options = {
+ 'navbar_site_name': "Inhalt",
+ 'globaltoc_depth': 2,
+ 'navbar_class': "navbar navbar-inverse",
+ 'source_link_position': "",
+}
# Add any paths that contain custom themes here, relative to this directory.
#html_theme_path = []
@@ -112,7 +117,7 @@ html_title = "OpenSlides Handbuch"
# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
-#html_logo = None
+html_logo = '_static/logo.png'
# The name of an image file (within the static path) to use as favicon of the
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
@@ -172,12 +177,11 @@ htmlhelp_basename = 'OpenSlidesdoc'
# -- Options for LaTeX output --------------------------------------------------
latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'a4',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
+'papersize': 'a4paper,oneside',
+'pointsize': '12pt',
+'babel': '\\usepackage[ngerman]{babel}',
+'fontpkg': '\\usepackage{lmodern}',
+'fncychap' : '\\usepackage[Sonny]{fncychap}',
# Additional stuff for the LaTeX preamble.
#'preamble': '',
}
@@ -185,13 +189,13 @@ latex_elements = {
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
- ('index', 'OpenSlides.tex', u'OpenSlides Handbuch',
+ ('index', 'OpenSlides-Handbuch.tex', u'OpenSlides Handbuch',
u'OpenSlides Team', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
# the title page.
-#latex_logo = None
+latex_logo = '_static/openslides-logo_wide.pdf'
# For "manual" documents, if this is true, then toplevel headings are parts,
# not chapters.
diff --git a/docs/de/About.rst b/docs/de/About.rst
index 21b5f7cfd..abf0ba3f6 100644
--- a/docs/de/About.rst
+++ b/docs/de/About.rst
@@ -1,6 +1,12 @@
Impressum
=========
-Copyright 2012–2013, OpenSlides Team
+Copyright 2012–2013
+
+OpenSlides-Autorenteam:
+ - Norman Jäckel
+ - Anja Hitziger
+ - Emanuel Schütze
+
Das OpenSlides-Handbuch ist unter der `Creative Commons CC BY-SA 3.0 `_ lizensiert.
diff --git a/docs/de/Agenda.rst b/docs/de/Agenda.rst
index 736d7b580..71bc3ce0a 100644
--- a/docs/de/Agenda.rst
+++ b/docs/de/Agenda.rst
@@ -26,7 +26,7 @@ einberechnet, ist für die Benutzer auf der Tagesordnung aber nicht sichtbar.
Bei der Projektion der gesamten Tagesordnung oder einzelner Unterpunkte
erscheint ein organisatorischer Eintrag ebenfalls nicht.
-Zusätzlich haben Sie die Möglichkeit unter dem „Titel“ einen „Text“
+Zusätzlich haben Sie die Möglichkeit, unter dem „Titel“ einen „Text“
einzufügen, der auf dem Projektor erscheinen soll. Einträge im Feld
„Kommentar“ sind nur für die Versammlungsleitung sichtbar.
@@ -117,11 +117,11 @@ Folie dargestellt.
.. |bell| image:: ../_images/bell.png
-Zusätzlich zu allen bereits genannten Anzeigemöglichkeiten, kann auf dem
+Zusätzlich zu allen bereits genannten Anzeigemöglichkeiten kann auf dem
Dashboard eine Einblendung der Rednerliste eingestellt werden. Aktivieren
Sie diese, wenn Sie auf den Kästchen-Button |checkbox| klicken. Die in einem
-grauen Rahmen, rechts unten auf der Folie, angezeigte Rednerliste
-visualisiert die letzten, hervorgehoben den aktuellen und die nächsten fünf
+grauen Rahmen, rechts unten auf der Folie angezeigte Rednerliste,
+visualisiert die letzten, den aktuellen (hervorgehoben) und die nächsten (fünf)
Redner. Die Einblendung erscheint nur auf Folien von Tagesordnungspunkten.
.. |checkbox| image:: ../_images/checkbox.png
diff --git a/docs/de/FirstSteps.rst b/docs/de/FirstSteps.rst
index ee4c2e2e5..0fed4e059 100644
--- a/docs/de/FirstSteps.rst
+++ b/docs/de/FirstSteps.rst
@@ -40,7 +40,10 @@ Start des Servers und Öffnen des Browsers
Verwendung der Windows-Version (Portable Version mit openslides.exe)
--------------------------------------------------------------------
-Wenn Sie die Windows-Version (Portable Version mit openslides.exe) verwenden, brauchen Sie nur die Datei ``openslides.exe`` ausführen. Mit dieser wird der Server gestartet und ihr Browser mit der richtigen URL geöffnet.
+Wenn Sie die Windows-Version (Portable Version mit openslides.exe)
+verwenden, brauchen Sie nur die Datei ``openslides.exe`` auszuführen.
+Mit dieser wird der Server gestartet und ihr Browser mit der richtigen
+URL geöffnet.
OpenSlides kann jederzeit im schwarzen Fenster der Kommandozeile mit der Tastenkombination ``Strg`` + ``Pause`` beendet werden. Alle eingegebenen Daten bleiben in der Datenbank gespeichert.
@@ -52,7 +55,7 @@ Starten Sie den Server, indem Sie in der Kommandozeile eingeben::
$ openslides
-Wenn Sie eine virtuellen Arbeitsumgebung (virtualenv) verwenden, müssen Sie diese zuvor aktivieren::
+Wenn Sie eine virtuelle Arbeitsumgebung (virtualenv) verwenden, müssen Sie diese zuvor aktivieren::
$ source .venv/bin/activate
@@ -88,7 +91,7 @@ Im Webinterface von OpenSlides können Sie über die verschiedenen Menüpunkte a
.. image:: ../_images/Platzhalter.png
:class: screenshot
-Im Menüunkt „Dashboard“ steuern Sie, welche Folien auf dem Beamer angezeigt werden. Dazu klicken Sie einfach auf das jeweilige Projektorsymbol. Im Menüpunkt „Tagesordnung“ können Sie die Tagesordnung der Veranstaltung im Vorfeld anlegen, entsprechende Folien vorbereiten und die Rednerliste verwalten. In den Menüpunkten „Anträge“ und „Wahlen“ verwalten Sie die gestellten Anträge und die Wahlämter mit den Kandidaten sowie die dazugehörigen Abstimmungen und Wahlen. Der Menüpunkt „Teilnehmer/innen“ ermöglicht einen Zugriff auf die Personenprofile. Unter dem Punkt „Medien“ können Sie eigene Dateien auf den Server laden und zum Download anbieten. Im Menüpunkt „Konfiguration“ können einige Einstellungen vorgenommen werden.
+Im Menüpunkt „Dashboard“ steuern Sie, welche Folien auf dem Beamer angezeigt werden. Dazu klicken Sie einfach auf das jeweilige Projektorsymbol. Im Menüpunkt „Tagesordnung“ können Sie die Tagesordnung der Veranstaltung im Vorfeld anlegen, entsprechende Folien vorbereiten und die Rednerliste verwalten. In den Menüpunkten „Anträge“ und „Wahlen“ verwalten Sie die gestellten Anträge und die Wahlämter mit den Kandidaten sowie die dazugehörigen Abstimmungen und Wahlen. Der Menüpunkt „Teilnehmer/innen“ ermöglicht einen Zugriff auf die Personenprofile. Unter dem Punkt „Medien“ können Sie eigene Dateien auf den Server laden und zum Download anbieten. Im Menüpunkt „Konfiguration“ können einige Einstellungen vorgenommen werden.
Das Beamerbild ist unter der URL ``/projector/`` zu finden. Sie können auch auf dem Dashboard auf die Projektor-Live-Ansicht klicken. Loggen Sie sich an dem Computer, an dem der Beamer angeschlossen ist, in OpenSlides ein und rufen Sie den Link oder die URL auf. Legen Sie die Anzeige in einem eigenen Browserfenster auf den Beamer und projizieren Sie sie so auf die Leinwand. In vielen Browsern kann mit der Taste ``F11`` in den Vollbildmodus gewechselt werden. Im *Präsentationsmodus Single* müssen Sie die Bildschirmanzeige auf Erweiterung/erweiterter Desktop stellen und das Browserfenster mit dem Beamerbild auf den Beamer schieben.
diff --git a/docs/de/LoginLogout.rst b/docs/de/LoginLogout.rst
index 152bfaf9d..2af73a252 100644
--- a/docs/de/LoginLogout.rst
+++ b/docs/de/LoginLogout.rst
@@ -10,7 +10,7 @@ Beim ersten Aufruf von OpenSlides erscheint die Login-Seite. Der erste Benutzern
Eigene Benutzereinstellungen (insbesondere Benutzername oder Passwort) ändern
-----------------------------------------------------------------------------
-Die eigenen Benutzereinstellungen wie Benutzername und Passwort können und über den Link ``Benutzereinstellungen`` oben rechts geändert werden. Klicken Sie auf den Link, wählen Sie im oberen rechten Menü aus, ob Sie Ihre persönlichen Einstellungen oder Ihr Passwort ändern möchten, und ändern Sie die jeweiligen Einstellungen. Klicken Sie abschließend auf ``Speichern``.
+Die eigenen Benutzereinstellungen wie Benutzername und Passwort können über den Link ``Benutzereinstellungen`` oben rechts geändert werden. Klicken Sie auf den Link, wählen Sie im oberen rechten Menü aus, ob Sie Ihre persönlichen Einstellungen oder Ihr Passwort ändern möchten, und ändern Sie die jeweiligen Einstellungen. Klicken Sie abschließend auf ``Speichern``.
Fremde Benutzereinstellungen (insbesondere Benutzername oder Passwort) ändern
diff --git a/docs/de/Motion.rst b/docs/de/Motion.rst
index 21adb5481..8dc5481df 100644
--- a/docs/de/Motion.rst
+++ b/docs/de/Motion.rst
@@ -48,7 +48,7 @@ werden:
zur Verfügung, bei denen zum Teil die `automatische Versionierung`__
aktiviert ist.
-* Um die Anträge im Vorfeld zu strukturieren besteht die Möglichkeit, sie
+* Um die Anträge im Vorfeld zu strukturieren, besteht die Möglichkeit, sie
pro Sachgebiet zu nummerieren, sie fortlaufend, das heißt über die
Sachgebiete hinweg, zu nummerieren oder manuell die Nummerierung für den
Bezeichner zu setzen.
@@ -184,7 +184,7 @@ Dialog mit „Ja“ bestätigen.
Wenn Sie (bei entsprechender Voreinstellung__) einen Antrag
bearbeiten, haben Sie mit dem Haken „Keine neue Version erzeugen“ die
-Möglichkeit die ansonsten erfolgende Versionierung im Einzelfall
+Möglichkeit, die ansonsten erfolgende Versionierung im Einzelfall
ausnahmsweise zu umgehen. Dies kann sinnvoll sein, wenn Sie einen Antrag
nur redaktionell (trivial) ändern wollen.
@@ -222,7 +222,7 @@ Sie diese mit dem Button „Neue Abstimmung“ auf der betreffenden
Antragsseite (im Kasten rechts) in OpenSlides aufnehmen. Tragen Sie die
entsprechenden Abstimmungsergebnisse in die Tabelle ein. Wenn Sie ``-1``
eintragen, wird das Wort „Mehrheit“ ausgegeben. ``-2`` steht für „Nicht
-erfasst“. Sollten Sie bei Abgegebene Stimmen einen Wert eintragen,
+erfasst“. Sollten Sie bei abgegebene Stimmen einen Wert eintragen,
berechnet OpenSlides automatisch die prozentualen Anteile der übrigen
Stimmzahlen. Klicken Sie am Ende auf ``Speichern`` oder ``Übernehmen``.
diff --git a/docs/de/Tutorial_1.rst b/docs/de/Tutorial_1.rst
index 79a60b0f5..9e8fbfb43 100644
--- a/docs/de/Tutorial_1.rst
+++ b/docs/de/Tutorial_1.rst
@@ -121,7 +121,7 @@ Auswahl der Beamerfolien
Testen Sie, ob auf dem Beamer die gewünschten Folien zu sehen sind, wenn
Sie bei OpenSlides im Menüpunkt „Dashboard“ verschiedene Folien auswählen.
-Sie können eine bestimmte Folien anwählen, indem Sie auf das jeweilige
+Sie können eine bestimmte Folie anwählen, indem Sie auf das jeweilige
Projektorsymbol |projector| klicken. Die jeweils aktive Folie zeigt ein
blaues Projektorsymbol.
diff --git a/docs/de/Tutorial_2.rst b/docs/de/Tutorial_2.rst
index ae870b5cd..0a8c5c47d 100644
--- a/docs/de/Tutorial_2.rst
+++ b/docs/de/Tutorial_2.rst
@@ -9,8 +9,7 @@ Konfiguration der Tagesordnung
------------------------------
Gehen Sie zunächst im Menüpunkt „Konfiguration“ links oben zum Unterpunkt
-„Tagesordnung“. Hier können stellen Sie als genauen Beginn der
-Veranstaltung ein:
+„Tagesordnung“. Hier können Sie den genauen Beginn der Veranstaltung einstellen:
02.03.2013 10:00
@@ -104,7 +103,7 @@ Organisationseinträgen und den Rednerlisten finden Sie hier__.
Auswahl der Beamerfolien
------------------------
-Wenn Sie in den Menüpunkt „Dashboard“ wechseln
+Wenn Sie in den Menüpunkt „Dashboard“ wechseln,
.. image:: ../_images/Platzhalter.png
:class: screenshot
diff --git a/docs/de/Tutorial_4.rst b/docs/de/Tutorial_4.rst
index d98ce3a04..0ef3ccdb8 100644
--- a/docs/de/Tutorial_4.rst
+++ b/docs/de/Tutorial_4.rst
@@ -29,7 +29,7 @@ Die übrigen Einstellungen können Sie erst einmal so belassen.
:class: screenshot
*Bei Anträgen und Wahlen kann es unter Umständen vorkommen, dass
-verschieden viele Stimmzettel benötigt werden, weshalb hierfür jeweils
+unterschiedlich viele Stimmzettel benötigt werden, weshalb hierfür jeweils
eigene Einstellungen vorzunehmen sind.*
@@ -96,7 +96,7 @@ Die Antragsansicht sieht dann wie folgt aus:
.. image:: ../_images/Platzhalter.png
:class: screenshot
-Nach Abschluss der Diskussion ruft der Vorsitzende zur Abstimmung. Klicken
+Nach Abschluss der Diskussion ruft der Vorsitzende zur Abstimmung auf. Klicken
Sie rechts auf „Neue Abstimmung“ und tragen Sie das Abstimmungsergebnis wie
folgt in das Formular ein:
diff --git a/docs/de/Tutorial_5.rst b/docs/de/Tutorial_5.rst
index f778b47e8..1741e34b3 100644
--- a/docs/de/Tutorial_5.rst
+++ b/docs/de/Tutorial_5.rst
@@ -22,7 +22,7 @@ Benutzerdefinierte Anzahl von Stimmzetteln:
:class: screenshot
*Bei Anträgen und Wahlen kann es unter Umständen vorkommen, dass
-verschieden viele Stimmzettel benötigt werden, weshalb hierfür jeweils
+unterschiedlich viele Stimmzettel benötigt werden, weshalb hierfür jeweils
eigene Einstellungen vorzunehmen sind.*
diff --git a/docs/de/Tutorial_6.rst b/docs/de/Tutorial_6.rst
index 3a8c21fb6..15def4fa1 100644
--- a/docs/de/Tutorial_6.rst
+++ b/docs/de/Tutorial_6.rst
@@ -36,10 +36,10 @@ benutzerdefinierten Folien auf dem Dashboard an. Wechseln Sie zum Menüpunkt
.. image:: ../_images/Platzhalter.png
:class: screenshot
-Gegen Sie Titel und Text wie folgt ein:
+Geben Sie Titel und Text wie folgt ein:
Titel:
- Schönster Garten des Anlage
+ Schönster Garten der Anlage
Text:
diff --git a/docs/de/index.rst b/docs/de/index.rst
index 64845f296..3a04d2f21 100644
--- a/docs/de/index.rst
+++ b/docs/de/index.rst
@@ -3,11 +3,9 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
-OpenSlides |version| Handbuch
+OpenSlides Handbuch |version|
=============================
-Inhalt:
-
.. toctree::
:maxdepth: 2
diff --git a/requirements.txt b/requirements.txt
index 831f58d33..192d18ffa 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,5 +7,9 @@ coverage==3.6
django-discover-runner==0.3
pep8==1.4.5
+# Requirements for OpenSlides handbook/documentation
+Sphinx==1.2b1
+sphinx-bootstrap-theme==0.2.3
+
# For Python 2.6 support
argparse==1.2.1