Updated documentation for 1.5

- Updated all screenshots.
- Improved image handling with autoimage extension.
- Some minor content updates for 1.5 version.
- Fixed wrong list of speakers icon.

docs/Makefile

@@ -11,7 +11,7 @@ LANGUAGES     = de
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
 PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees/$$lang $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) -c . -A language=$$lang -A languages='$(LANGUAGES)'
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees/$$lang $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) -c . -A language=$$lang -A languages='$(LANGUAGES)' -E
 
 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
 

docs/_static/openslides_docs_style.css

@@ -2,13 +2,13 @@
  * Extra style for OpenSlides documentation
  */
 
-.screenshot {
-    width: 30%;
-    border: 1px solid;
+img.screenshot {
+    border: 1px solid lightgrey;
+    padding: 4px;
     margin-bottom: 10px;
 }
-.screenshot:hover{
-    width: 80%;
+h2  {
+    margin-top: 35px !important;
 }
 a.headerlink {
     visibility: hidden;

docs/conf.py

@@ -16,7 +16,7 @@ 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.
-#sys.path.insert(0, os.path.abspath('.'))
+sys.path.insert(0, os.path.abspath('extensions'))
 
 # -- General configuration -----------------------------------------------------
 
@@ -25,7 +25,7 @@ import sphinx_bootstrap_theme
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = []
+extensions = ['autoimage']
 
 # Add any paths that contain templates here, relative to this directory.
 # templates_path = ['_templates']

docs/de/Agenda.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Tagesordnung
 ++++++++++++
 
@@ -11,8 +15,11 @@ Einen neuen Tagesordnungspunkt erstellen
 Um einen neuen Punkt auf die Tagesordnung zu setzen, klicken Sie unter dem
 Menüpunkt „Tagesordnung“ auf den rechts oben befindlichen blauen Button „Neu“.
 
-.. image:: ../_images/Agenda_01.png
+.. autoimage:: Agenda_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: leere Tagesordnung
 
 Es öffnet sich eine Seite, auf der Sie den neuen Eintrag bearbeiten können.
 Erforderliche Angaben für die Erstellung eines neuen Tagesordnungspunktes
@@ -71,8 +78,11 @@ der Maus horizontal und vertikal an die gewünschte Position zu verschieben.
 Die geänderte Reihenfolge muss am Ende im oben erscheinenden Dialog
 bestätigt werden.
 
-.. image:: ../_images/Agenda_02.png
+.. autoimage:: Agenda_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Beispiel Tagesordung mit Meldung 'geänderte Reihenfolge'
 
 
 Projizierung
@@ -87,8 +97,11 @@ oder auf der Tagesordnungsseite auf den Projektor-Button in der oberen Zeile
 rechts. Projiziert werden nur die Haupttagesordnungspunkte, nicht die
 Unterpunkte.
 
-.. image:: ../_images/Agenda_03.png
+.. autoimage:: Agenda_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektor-Ansicht Tagesordnung
 
 Sie haben die Möglichkeit, auch einzelne Tagesordnungspunkte mit ihren
 dazugehörigen Texten anzeigen zu lassen. Nutzen Sie dafür den
@@ -109,8 +122,6 @@ Bei einem Klick auf den Glocken-Button |bell| auf dem Dashboard oder auf der
 Tagesordnungsseite wird die Rednerliste für den jeweiligen Eintrag auf der
 Folie dargestellt.
 
-.. |bell| image:: ../_images/bell.png
-
 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
@@ -120,8 +131,11 @@ Redner. Die Einblendung erscheint nur auf Folien von Tagesordnungspunkten.
 
 .. |checkbox| image:: ../_images/checkbox.png
 
-.. image:: ../_images/Agenda_04.png
+.. autoimage:: Agenda_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektor-Ansicht mit Rednerlisten-Overlay
 
 
 Die Rednerliste verwalten
@@ -150,14 +164,17 @@ setzen.
 Um die Reihenfolge von Rednern zu ändern, verschieben Sie sie mit der Maus
 an die gewünschte Position. Bestätigen Sie danach Ihre Änderungen.
 
-.. image:: ../_images/Agenda_05.png
+.. autoimage:: Agenda_05.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Rednerlistenverwaltung
 
 Wenn eine Person mit ihrem Redebeitrag beginnt, klicken Sie auf den Button
-„Rede beginnen“ |microphone|. Sie wird nun als aktueller Redner angezeigt.
+„Rede beginnen“ |bell|. Sie wird nun als aktueller Redner angezeigt.
 Ist der Redebeitrag zu Ende, können Sie dies mit dem Button „Rede beenden“
-|microphone| bestätigen oder direkt den nächsten Redner mit dem Button „Rede
-beginnen“ |microphone| aufrufen.
+|bell| bestätigen oder direkt den nächsten Redner mit dem Button „Rede
+beginnen“ |bell| aufrufen.
 
 Auf dem Dashboard finden Sie im Widget „Rednerliste“ zwei weitere Buttons,
 um den obersten Redner des aktuell ausgewählten Tagesordnungseintrags
@@ -167,16 +184,19 @@ beenden.
 Die Einstellung, wie viele letzte Redner projiziert werden sollen, finden
 Sie im Menüpunkt „Konfiguration“ in der oberen Leiste unter „Tagesordnung“.
 
-.. image:: ../_images/Agenda_06.png
+.. autoimage:: Agenda_06.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 60
+   :alt: Konfiguration Tagesordnung
 
 Schließlich können Sie in diesem Menüpunkt einstellen, dass die Rednerliste
-mit dem Countdown gekoppelt wird. Wenn Sie auf „Rede beginnen“ |microphone|
-oder Rede beenden“ |microphone| klicken, wird der Countdown automatisch
+mit dem Countdown gekoppelt wird. Wenn Sie auf „Rede beginnen“ |bell|
+oder „Rede beenden“ |bell| klicken, wird der Countdown automatisch
 gestartet beziehungsweise gestoppt und beim nächsten Redner zurückgesetzt.
 
 .. |microphone| image:: ../_images/microphone.png
-
+.. |bell| image:: ../_images/bell.png
 
 CSV-Export der Rednerlisten
 ---------------------------

docs/de/FirstSteps.rst

@@ -34,6 +34,9 @@ install openslides``) herunter. Die Installationsanleitung für diese
 Version finden Sie in der beiliegenden README.rst. Folgen Sie den
 Anweisungen der Anleitung.
 
+.. raw:: latex
+
+   \newpage
 
 Konfiguration
 +++++++++++++
@@ -118,23 +121,31 @@ Arbeiten mit OpenSlides
 Im Webinterface von OpenSlides können Sie über die verschiedenen Menüpunkte
 alle Inhalte in OpenSlides eingeben und verwalten.
 
-.. image:: ../_images/FirstSteps_01.png
+.. autoimage:: FirstSteps_01.png
    :class: screenshot
+   :scale-html: 100
+   :scale-latex: 75
+   :alt: Hauptmenü
 
-Im Menüpunkt „Dashboard“ steuern Sie, welche Folien auf dem Projektor
+
+* Im Menüpunkt **Dashboard** steuern Sie, welche Folien auf dem Projektor
   angezeigt werden. Dazu klicken Sie einfach auf das jeweilige
-Projektorsymbol. Im Menüpunkt „Tagesordnung“ können Sie die Tagesordnung
+  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 „Dateien“ können Sie eigene Dateien auf den Server laden und zum
-Download anbieten. PDF-Dateien können auch auf dem Projektor angezeigt
-werden. Im Menüpunkt „Konfiguration“ können einige Einstellungen
-vorgenommen werden.
+  die Rednerliste verwalten. 
+* Unter **Anträge** verwalten Sie die gestellten Anträge und die dazugehörigen
+  Abstimmungen.
+* Der Puntk **Wahlen** verwaltet die Wahlämter mit den Kandidaten
+  sowie die jeweiligen Wahlergebnisse.
+* Der Menüpunkt **Teilnehmer/innen** ermöglicht einen Zugriff auf die
+  Personenprofile.
+* Unter dem Punkt **Dateien** können Sie eigene Dateien auf den Server laden
+  und zum Download anbieten. PDF-Dateien können auch auf dem Projektor angezeigt
+  werden.
+* Im Menüpunkt **Konfiguration** können einige Einstellungen vorgenommen werden.
 
-Das Projektorbild ist unter der Url ``/projector/`` zu finden. Sie können
+Das Projektorbild 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 Projektor angeschlossen ist, in OpenSlides
 ein und rufen Sie den Link oder die URL auf. Legen Sie die Anzeige in einem

docs/de/Motion.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Anträge
 +++++++
 
@@ -60,8 +64,11 @@ werden:
 .. __: #arbeitsablauf-und-status
 .. __: #versionierung
 
-.. image:: ../_images/Motion_01.png
+.. autoimage:: Motion_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 75
+   :alt: Konfiguration Antrag
 
 
 Strukturierung von Anträgen
@@ -131,8 +138,11 @@ verwalten“ von einem bestimmten Status aus bestimmte andere Status
 ausgewählt und angeklickt werden. Mit dem roten Button „Status
 zurücksetzen“ können Sie auf den Ausgangsstatus zurückspringen.
 
-.. image:: ../_images/Motion_02.png
+.. autoimage:: Motion_02.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Antrag verwalten Buttons
 
 Beim einfachen Arbeitsablauf kann bei der Verwaltung eines eingereichten
 Antrags zwischen „angenommen“, „abgelehnt“ und „nicht entschieden“ gewählt
@@ -158,8 +168,11 @@ Es folgt eine Übersicht über die beiden Arbeitsabläufe mit allen Status.
 Einfacher Arbeitsablauf
 '''''''''''''''''''''''
 
-.. image:: ../_images/Motion_03_1.png
+.. autoimage:: Motion_03_1.png
    :class: screenshot
+   :scale-html: 60
+   :scale-latex: 80
+   :alt: Einfacher Arbeitsablauf
 
 .. table:: Einfacher Arbeitsablauf
    :class: workflow-table table-bordered table-striped
@@ -181,8 +194,11 @@ Einfacher Arbeitsablauf
 Komplexer Arbeitsablauf
 '''''''''''''''''''''''
 
-.. image:: ../_images/Motion_03_2.png
+.. autoimage:: Motion_03_2.png
    :class: screenshot
+   :scale-html: 60
+   :scale-latex: 80
+   :alt: Komplexer Arbeitsablauf
 
 .. table:: Komplexer Arbeitsablauf
    :class: workflow-table table-bordered table-striped
@@ -210,8 +226,11 @@ Antragsversion an. Sie können auf der Antragsseite mehrere Versionen
 miteinander vergleichen. Wählen Sie dazu je einen Knopf links und rechts
 aus und klicken Sie auf den Button „Unterschied“.
 
-.. image:: ../_images/Motion_04.png
+.. autoimage:: Motion_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Antrag mit Versionshistorie
 
 Nur eine der Versionen eines Antrags gilt in OpenSlides als zugelassene
 Version. Diese wird auf dem Projektor angezeigt und in der Antragsseite mit
@@ -239,8 +258,11 @@ Seite eines Antrags auf den Projektor-Button in der oberen Zeile rechts.
 
 .. |projector| image:: ../_images/projector.png
 
-.. image:: ../_images/Motion_05.png
+.. autoimage:: Motion_05.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektoransicht Antrag
 
 Zu jedem Antrag können Sie über einen Link („Neuer Tagesordnungseintrag“)
 in der oberen Leiste des betreffenden Antrags („Mehr Aktionen“) auch einen
@@ -262,8 +284,11 @@ erfasst“. Sollten Sie bei den abgegebenen Stimmen einen Wert eintragen,
 berechnet OpenSlides automatisch die prozentualen Anteile der übrigen
 Stimmzahlen. Klicken Sie am Ende auf ``Speichern`` oder ``Übernehmen``.
 
-.. image:: ../_images/Motion_06.png
+.. autoimage:: Motion_06.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Eingabe des Abstimmungsergebnisses
 
 In der Abstimmungsansicht können Sie außerdem eventuell benötigte
 Abstimmungszettel als PDF |printer| abrufen. Nachträglich können Sie
@@ -285,8 +310,11 @@ Person als Antragsteller eingetragen werden soll, falls die CSV-Datei in
 einer Zeile keinen gültigen Antragsteller enthält. Die weiteren Hinweise
 auf der Import-Seite müssen beachtet werden.
 
-.. image:: ../_images/Motion_07.png
+.. autoimage:: Motion_07.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: CSV-Import
 
 
 PDF

docs/de/Tutorial.rst

@@ -1,7 +1,8 @@
 Tutorial – Präsentationsmodus
 =============================
 
-Dieses Tutorial ist auf dem Stand von OpenSlides 1.4.x.
+Dieses Tutorial ist auf dem Stand von OpenSlides 1.4.x und weicht nur
+sehr gerinfügig von OpenSlides 1.5 ab.
 
 In diesem Tutorial sehen Sie am Beispiel der Mitgliederversammlung eines
 Kleingartenvereins, wie Sie OpenSlides im Präsentationsmodus bedienen.
@@ -18,7 +19,7 @@ Versammlung werden verschiedene Berichte gehalten und über eine
 Satzungsänderung abgestimmt. Außerdem finden Wahlen zum Vorstand (drei
 Personen) und zum Beirat (sieben Personen) statt.
 
-Die einzelen Tutorials:
+Auf den nächsten Seiten folgen die einzelen Tutorials.
 
 .. toctree::
  :maxdepth: 1

docs/de/Tutorial_1.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Einrichtung von OpenSlides
 ==========================
 
@@ -16,16 +20,22 @@ Sie sehen jetzt die Login-Seite von OpenSlides in Ihrem
 Browser. Loggen Sie sich als Administrator ein, indem Sie als Benutzernamen
 ``admin`` und als Passwort ``admin`` eingeben und auf ``Anmelden`` klicken.
 
-.. image:: ../_images/Tutorial_1_01.png
+.. autoimage:: Tutorial_1_01.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Loginmaske
 
 Anschließend sollten Sie sofort das Administrator-Passwort ändern. Geben
 Sie in die entsprechenden Felder Ihr altes Passwort ``admin`` und
 anschließend Ihr neues Passwort ein. Wiederholen Sie das neue Passwort im
 dritten Formularfeld. Bestätigen Sie die Eingabe mit ``Speichern``.
 
-.. image:: ../_images/Tutorial_1_02.png
+.. autoimage:: Tutorial_1_02.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Formular zum Passwort ändern
 
 .. __: FirstSteps.html#installation
 .. __: FirstSteps.html#start-des-servers-und-offnen-des-browsers
@@ -62,8 +72,11 @@ Startseite – Willkommenstext:
   Herzlich willkommen, liebe Gartenfreunde!
 
 
-.. image:: ../_images/Tutorial_1_03.png
+.. autoimage:: Tutorial_1_03.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Allgemeine Konfiguration
 
 Klicken Sie anschließend auf ``Speichern``. Auch bei allen folgenden
 Eingaben dieses Tutorials müssen Sie stets auf ``Speichern`` klicken, um
@@ -74,11 +87,14 @@ Einrichtung eigener Folien
 --------------------------
 
 Um erste benutzerdefinierte Folien hinzuzufügen, wechseln Sie zum Menüpunkt
-„Dashboard“. Klicken Sie in dem Fenster „Benutzerdefinierte Folien“ auf
+„Dashboard“. Klicken Sie in dem Widget „Benutzerdefinierte Folien“ auf
 ``Neu``
 
-.. image:: ../_images/Tutorial_1_04.png
+.. autoimage:: Tutorial_1_04.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Widget Benutzerdefinierte Folien
 
 und geben Sie eine Folie wie folgt ein:
 
@@ -88,13 +104,19 @@ Titel:
 Text:
   Bitte kommen Sie pünktlich um 16.00 Uhr zurück in den Saal.
 
-.. image:: ../_images/Tutorial_1_05.png
+.. autoimage:: Tutorial_1_05.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Bearbeitungsformular der Benutzerdefinierten Folie
 
 Die Ansicht im Menüpunkt „Dashboard“ müsste nun wie folgt aussehen:
 
-.. image:: ../_images/Tutorial_1_06.png
+.. autoimage:: Tutorial_1_06.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Dashboard mit neu angelegter benutzerdefinierter Folie
 
 
 Technische Einrichtung im Veranstaltungsraum
@@ -110,13 +132,19 @@ der Projektor-Live-Ansicht. Er lautet zum Beispiel
 ``http://192.168.x.y/projector/`` wobei x und y für je eine bestimmte Zahl
 mit ein bis drei Ziffern stehen.
 
-.. image:: ../_images/Tutorial_1_07.png
+.. autoimage:: Tutorial_1_07.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Widget Projektor-Live-Ansicht
 
 Das Projektorbild sieht zurzeit wie folgt aus:
 
-.. image:: ../_images/Tutorial_1_08.png
+.. autoimage:: Tutorial_1_08.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektor-Ansicht
 
 
 Auswahl der Projektorfolien
@@ -128,8 +156,11 @@ Sie können eine bestimmte Folie anwählen, indem Sie auf das jeweilige
 Projektorsymbol |projector| klicken. Die jeweils aktive Folie zeigt ein
 blaues Projektorsymbol.
 
-.. image:: ../_images/Tutorial_1_09.png
+.. autoimage:: Tutorial_1_09.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Ausgewählte Folie im Widget Benutzerdefinierte Folien
 
 .. |projector| image:: ../_images/projector.png
 
@@ -145,8 +176,11 @@ angelegt werden soll, können Sie die Mitteilungsfunktion im Fenster
 aktivieren schließlich die Einblendung, indem Sie auf das davor gestellte
 Kästchen klicken.
 
-.. image:: ../_images/Tutorial_1_10.png
+.. autoimage:: Tutorial_1_10.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Mitteilung projizieren im Widget Einblendungen
 
 Schalten Sie die Einblendung wieder aus, indem Sie erneut auf das (nunmehr
 blaue) Kästchen klicken.

docs/de/Tutorial_2.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Tagesordnung verwalten
 ======================
 
@@ -8,15 +12,18 @@ und verwalten.
 Konfiguration der Tagesordnung
 ------------------------------
 
-Gehen Sie zunächst im Menüpunkt „Konfiguration“ links oben zum Unterpunkt
+Gehen Sie zunächst im Menüpunkt „Konfiguration“ zum Unterpunkt
 ``Tagesordnung``. Hier können Sie den genauen Beginn der Veranstaltung
 einstellen.
 
 Beginn der Veranstaltung:
   02.03.2013 10:00
 
-.. image:: ../_images/Tutorial_2_01.png
+.. autoimage:: Tutorial_2_01.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Konfiguration der Tagesordnung
 
 
 Eingabe der Tagesordnung
@@ -27,8 +34,11 @@ zunächst einige Einträge an.
 
 Klicken Sie dazu im Menüpunkt „Tagesordnung“ oben rechts auf ``Neu``
 
-.. image:: ../_images/Tutorial_2_02.png
+.. autoimage:: Tutorial_2_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Tagesordnungseintrag erstellen
 
 und geben Sie den Eintrag wie folgt ein:
 
@@ -41,8 +51,11 @@ Text:
 Dauer:
   00:15
 
-.. image:: ../_images/Tutorial_2_03.png
+.. autoimage:: Tutorial_2_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Formular für neuen Tagesordnungseintrag
 
 Klicken Sie anschließend auf ``Speichern``.
 
@@ -51,8 +64,11 @@ Vorstands, Satzungsänderung, Gartenfest, Sonstiges, Wahlen der Vereinsämter.
 
 Die Übersicht über die Einträge müsste nun so aussehen:
 
-.. image:: ../_images/Tutorial_2_04.png
+.. autoimage:: Tutorial_2_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Tagesordnung Übericht
 
 Sie können nun nachträglich die Reihenfolge der Einträge verändern und auch
 Tagesordnungspunkte zu Unterpunkten verschieben. Ziehen Sie zum Beispiel
@@ -60,8 +76,11 @@ mit der Maus den Punkt „Sonstiges“, um seine Position zu verändern und ihn
 nach unten zu verschieben. Richten Sie die Tagesordnung durch Verschieben
 der übrigen Einträge so ein, dass sie wie folgt aussieht:
 
-.. image:: ../_images/Tutorial_2_05.png
+.. autoimage:: Tutorial_2_05.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Geänderte Tagesordnungs-Reihenfolge speichern
 
 Klicken Sie auf ``Ja``, um die geänderte Reihenfolge zu speichern. Solange
 Sie die veränderte Reihenfolge nicht gespeichert haben, wird die
@@ -94,14 +113,17 @@ Text:
   Der Vorstand berichtet über seine Arbeit, insbesondere die Entwicklung
   der Mitgliederzahlen und Finanzen.
 
-.. image:: ../_images/Tutorial_2_06.png
+.. autoimage:: Tutorial_2_06.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Tagesordnungseintrag bearbeiten
 
 .. |edit| image:: ../_images/pencil.png
 
 Mehr Informationen zur Verwaltung der Tagesordnung, insbesondere den
 Organisationseinträgen und den Rednerlisten finden Sie im Kapitel
-„Einzelne Funktionen", Abschnitt `Tagesordnung__.
+„Einzelne Funktionen", Abschnitt Tagesordnung__.
 
 .. __: Agenda.html
 
@@ -115,8 +137,11 @@ bestimmte Folie auswählen. Die jeweils aktive Folie zeigt ein blaues
 Projektorsymbol. Probieren Sie, verschiedene
 Tagesordnungspunkte auf dem Projektor anzuzeigen.
 
-.. image:: ../_images/Tutorial_2_07.png
+.. autoimage:: Tutorial_2_07.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Dashboard-Widget Tagesordnung
 
 
 Weiter geht es mit dem dritten Teil des Tutorials: `Teilnehmer/innen verwalten`__

docs/de/Tutorial_3.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Teilnehmer/innen verwalten
 ==========================
 
@@ -12,8 +16,7 @@ Eingabe der Teilnehmer und Teilnehmerinnen
 
 Sie können die Teilnehmer und Teilnehmerinnen einzeln eintragen oder, wie im
 Kapitel „Einzelne Funktionen“, Abschnitt `Teilnehmer/innen`__ beschrieben,
-importieren. Jedoch werden beim Import alle vorher eingetragenen Teilnehmer
-gelöscht. Eingetragenen Personen, die das System verwalten sollen, müssen
+importieren. Eingetragenen Personen, die das System verwalten sollen, müssen
 die entsprechenden Berechtigungen zugewiesen werden.
 
 .. __: Participant.html
@@ -21,8 +24,11 @@ die entsprechenden Berechtigungen zugewiesen werden.
 Wechseln Sie zum Menüpunkt „Teilnehmer/innen“. Klicken Sie oben rechts auf
 ``Neu``
 
-.. image:: ../_images/Tutorial_3_01.png
+.. autoimage:: Tutorial_3_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Teilnehmer/in anlegen
 
 und geben Sie einen neuen Teilnehmer wie folgt ein:
 
@@ -41,8 +47,11 @@ Geschlecht:
 Gruppen:
   Delegierter
 
-.. image:: ../_images/Tutorial_3_02.png
+.. autoimage:: Tutorial_3_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Formular Teilnehmer anlegen
 
 Wiederholen Sie diese Schritte und geben Sie folgende weitere Teilnehmer
 und Teilnehmerinnen ein: Peter Müller, Prof. Dr. Franziska Meyer, Luise Schmidt und Dr. Hans Schulze.
@@ -50,8 +59,11 @@ und Teilnehmerinnen ein: Peter Müller, Prof. Dr. Franziska Meyer, Luise Schmidt
 Wenn Sie auf der Übersichtsseite „Teilnehmer/innen“ sind,
 sehen Sie die folgende Übersicht:
 
-.. image:: ../_images/Tutorial_3_03.png
+.. autoimage:: Tutorial_3_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Übersicht aller Teilnehmer/innen
 
 
 Bearbeiten eines Teilnehmers
@@ -60,11 +72,13 @@ Bearbeiten eines Teilnehmers
 Sie können die Angaben zu einem Teilnehmer jederzeit bearbeiten. Klicken
 Sie zum Beispiel beim Teilnehmer „Max Mustermann“ unter der Rubrik
 „Aktionen“ auf das Bearbeiten-Symbol |edit| und weisen Sie der Person die
-Gruppen „Delegierter“ und „Mitarbeiter“ zu. Um mehrere
-Einträge auszuwählen, halten Sie beim Anklicken die Taste ``Strg`` gedrückt.
+Gruppen „Delegierter“ und „Mitarbeiter“ zu.
 
-.. image:: ../_images/Tutorial_3_04.png
+.. autoimage:: Tutorial_3_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Teilnehmer bearbeiten
 
 
 Passwort eines Teilnehmers
@@ -86,8 +100,11 @@ müssen Sie auf den Link ``Auf Erst-Passwort zurücksetzen`` klicken, um das im
 System gespeicherte Passwort mit Ihrem neu Eingegebenen zu ersetzen.
 Bestätigen Sie den oben auf der Seite erscheinenden Dialog mit ``Ja``.
 
-.. image:: ../_images/Tutorial_3_05.png
+.. autoimage:: Tutorial_3_05.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 55
+   :alt: Passwort zurücksetzen
 
 .. |edit| image:: ../_images/pencil.png
 

docs/de/Tutorial_4.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Anträge verwalten und behandeln
 ===============================
 
@@ -25,8 +29,11 @@ Benutzerdefinierte Anzahl von Stimmzetteln:
 
 Die übrigen Einstellungen können Sie erst einmal so belassen.
 
-.. image:: ../_images/Tutorial_4_01.png
+.. autoimage:: Tutorial_4_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Konfiguration Anträge
 
 *Bei Anträgen und Wahlen kann es unter Umständen vorkommen, dass
 unterschiedlich viele Stimmzettel benötigt werden, weshalb hierfür jeweils
@@ -41,8 +48,11 @@ vor, welche ins System gebracht werden sollen.
 
 Wechseln Sie zum Menüpunkt „Anträge“ und klicken Sie rechts oben auf ``Neu``.
 
-.. image:: ../_images/Tutorial_4_02.png
+.. autoimage:: Tutorial_4_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Antrag anlegen
 
 Geben Sie einen Antrag, mit dem die Vereinssatzung geändert und die Zahl
 der Mitglieder des Beirats erhöht werden soll, wie folgt ein:
@@ -61,13 +71,19 @@ Begründung:
 Antragsteller:
   Dr. Hans Schulze
 
-.. image:: ../_images/Tutorial_4_03.png
+.. autoimage:: Tutorial_4_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Formular Neuer Antrag
 
 Die Antragsseite sieht nun wie folgt aus:
 
-.. image:: ../_images/Tutorial_4_04.png
+.. autoimage:: Tutorial_4_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Antrag im Detail
 
 Auf die gleiche Weise können Sie vor und während der Veranstaltung alle
 gestellten Anträge eingeben. Mehr Informationen zur Antragsverwaltung
@@ -83,15 +99,21 @@ Wenn der Vorsitzende während der Veranstaltung den Antrag zur
 Satzungsänderung aufruft, klicken Sie zunächst im Menüpunkt „Dashboard“ auf
 das entsprechende Projektorsymbol |projector| vor dem Antrag.
 
-.. image:: ../_images/Tutorial_4_05.png
+.. autoimage:: Tutorial_4_05.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Dashboard Widget Antrag
 
 .. |projector| image:: ../_images/projector.png
 
 Die Projektoransicht sieht dann wie folgt aus:
 
-.. image:: ../_images/Tutorial_4_06.png
+.. autoimage:: Tutorial_4_06.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 75
+   :alt: Projektoransicht Antrag
 
 Um schnell zur Antragsverwaltung zu wechseln, können Sie auf den Titel des
 Antrags klicken.
@@ -100,16 +122,22 @@ Nach Abschluss der Diskussion ruft der Vorsitzende zur Abstimmung auf. Klicken
 Sie im rechten Kasten auf ``Neue Abstimmung`` und tragen Sie das Abstimmungsergebnis wie
 folgt in das Formular ein:
 
-.. image:: ../_images/Tutorial_4_07.png
+.. autoimage:: Tutorial_4_07.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Dashboard Widget Antrag
 
 Der Vorsitzende stellt fest, dass der Antrag angenommen ist. Klicken Sie
 deshalb auf der im rechten unteren Kasten unter „Antrag verwalten“ auf ``Annehmen``.
 
 Das Projektorbild sieht nun wie folgt aus:
 
-.. image:: ../_images/Tutorial_4_08.png
+.. autoimage:: Tutorial_4_08.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektoransicht mit Abstimmungsergebnis
 
 
 Weiter geht es mit dem fünften Teil des Tutorials: `Wahlen durchführen`__

docs/de/Tutorial_5.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Wahlen durchführen
 ==================
 
@@ -18,8 +22,11 @@ Anzahl der Stimmzettel (Vorauswahl):
 Benutzerdefinierte Anzahl von Stimmzetteln:
   40
 
-.. image:: ../_images/Tutorial_5_01.png
+.. autoimage:: Tutorial_5_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Konfiguration Wahlen
 
 *Bei Anträgen und Wahlen kann es unter Umständen vorkommen, dass
 unterschiedlich viele Stimmzettel benötigt werden, weshalb hierfür jeweils
@@ -32,8 +39,11 @@ Eingabe der anstehenden Wahlen/Wahlämter
 Vor Veranstaltungsbeginn sind die anstehenden Wahlen vorzubereiten. Geben
 Sie dazu im Menüpunkt „Wahlen“ rechts oben unter ``Neu``
 
-.. image:: ../_images/Tutorial_5_02.png
+.. autoimage:: Tutorial_5_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Wahl anlegen
 
 ein Wahlamt wie folgt ein:
 
@@ -46,8 +56,11 @@ Beschreibung:
 Anzahl der zur Wahl stehenden Posten:
   3
 
-.. image:: ../_images/Tutorial_5_03.png
+.. autoimage:: Tutorial_5_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Formular Neue Wahl
 
 Geben Sie auf die gleiche Weise ein weiteres Wahlamt wie folgt ein:
 
@@ -65,8 +78,11 @@ Kommentar für den Stimmzettel:
 
 Die Wahlübersicht (Menüpunkt „Wahlen“) müsste nun so aussehen:
 
-.. image:: ../_images/Tutorial_5_04.png
+.. autoimage:: Tutorial_5_04.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Übersicht Wahlen
 
 
 Durchführung einer Wahl während der Veranstaltung
@@ -76,23 +92,32 @@ Wenn der Vorsitzende während der Veranstaltung die Wahlen zum neuen
 Vorstand aufruft, klicken Sie zunächst im Menüpunkt „Dashboard“ auf das
 entsprechende Projektorsymbol vor der ersten Wahl.
 
-.. image:: ../_images/Tutorial_5_05.png
+.. autoimage:: Tutorial_5_05.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Widget Wahl
 
 Wechseln Sie dann zur Wahlansicht, indem Sie auf den Titel der Wahl klicken.
 
 Die Wahlansicht sieht dann wie folgt aus:
 
-.. image:: ../_images/Tutorial_5_06.png
+.. autoimage:: Tutorial_5_06.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Wahl im Detail
 
 Es werden nun verschiedene Kandidaten vorgeschlagen, die Sie durch Auswahl
 eines Teilnehmers und Klick auf den blauen Haken auf die Kandidatenliste
 setzen können. Sie können nur Kandidaten auswählen, die auch im System
 gespeichert sind.
 
-.. image:: ../_images/Tutorial_5_07.png
+.. autoimage:: Tutorial_5_07.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Wahl mit Kandidatenliste
 
 *Das kleine Symbol neben dem Auswahlformular ist ein direkter Link zur
 Eingabe eines neuen Teilnehmers. Dieser kann sehr nützlich sein, wenn
@@ -102,58 +127,82 @@ eingetragen wurde.*
 Steht die Kandidatenauswahl fest, ändern Sie rechts den Status der Wahl auf
 „Im Wahlvorgang“. 
 
-.. image:: ../_images/Tutorial_5_08.png
+.. autoimage:: Tutorial_5_08.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Wahl im Wahlvorgang
 
 Klicken Sie anschließend unten auf ``Neuer Wahlgang``, um einen ersten
 Wahlgang anzulegen. Da es eine geheime Wahl ist und die Stimmzettel erst
 ausgeteilt werden müssen, können Sie jetzt noch keine Wahlergebnisse
 eintragen. Klicken Sie stattdessen auf ``Stimmzettel als PDF``.
 
-.. image:: ../_images/Tutorial_5_09.png
+.. autoimage:: Tutorial_5_09.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Stimmzettel als PDF drücken
 
 OpenSlides liefert Ihnen daraufhin eine PDF-Datei, die Sie direkt
 ausdrucken können. Die Stimmzettel können anschließend auseinander
 geschnitten und verteilt werden.
 
-.. image:: ../_images/Tutorial_5_10.png
+.. autoimage:: Tutorial_5_10.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Wahlstimmzettel als PDF
 
 *Bei mehrfachen Wahlen bietet sich der Einsatz einer Hebelschere an.*
 
 Nach Auszählung der Stimmzettel tragen Sie die Ergebnisse des ersten
 Wahlgangs in eben dieses Formular ein:
 
-.. image:: ../_images/Tutorial_5_11.png
+.. autoimage:: Tutorial_5_11.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Eingabe der Wahlergebnisse
 
 Klicken Sie anschließend auf den roten Knopf bei dem ersten Wahlgang, um
 die Wahlergebnisse auf dem Projektor zu veröffentlichen. Der Knopf erhält
 einen weißen Haken.
 
-.. image:: ../_images/Tutorial_5_12.png
+.. autoimage:: Tutorial_5_12.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Wahlergebnisse veröffentlichen
 
 Klicken Sie nun auf die grauen Haken vor Prof. Dr. Franziska Meyer, Luise Schmidt und
 Dr. Hans Schulze, um diese als gewählt zu markieren.
 
-.. image:: ../_images/Tutorial_5_13.png
+.. autoimage:: Tutorial_5_13.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Wahlsieger festlegen
 
 Ändern Sie rechts den Status der Wahl auf „Abgeschlossen“. Das Projektorbild
 sieht nun wie folgt aus:
 
-.. image:: ../_images/Tutorial_5_14.png
+.. autoimage:: Tutorial_5_14.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektoransicht Wahl
 
 Auf die gleiche Weise können Sie nun auch die zweite Wahl durchführen. Sie
 werden feststellen, dass als Wahlmethode automatisch eine
 Ja-Nein-Enthaltungs-Wahl bezüglich eines jeden Kandidaten ausgewählt wird,
 wenn es weniger oder gleich viele Kandidaten wie Plätze gibt.
 
-.. image:: ../_images/Tutorial_5_15.png
+.. autoimage:: Tutorial_5_15.png
    :class: screenshot
+   :scale-html: 75
+   :scale-latex: 45
+   :alt: Ja-Nein-Enthaltungs-Wahl
 
 *Falls Sie nicht im Präsentationsmodus Single arbeiten, kann es sinnvoll
 sein, den Drucker und die Hebelschere an der Seite oder am hinteren Ende

docs/de/Tutorial_6.rst

@@ -1,3 +1,7 @@
+.. raw:: latex
+
+   \newpage
+
 Dateien hochladen und verwalten
 ===============================
 
@@ -15,8 +19,11 @@ Dateisystem ihres Computers auswählen. Wir unterstellen, dass der Dateiname
 ``bild.jpg`` lautet. Außerdem können Sie noch einen ergänzenden Titel
 angeben.
 
-.. image:: ../_images/Tutorial_6_01.png
+.. autoimage:: Tutorial_6_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Formular Neue Datei
 
 Die Datei ist nun auf den Server geladen und unter ihrem Namen auf der
 Übersichtsseite des Menüpunkts „Dateien“ verlinkt. Um den Link kurzzeitig
@@ -44,18 +51,23 @@ Text:
 Beachten Sie die richtige Schreibweise des Links im verwendeten HTML-Tag.
 Der Link entspricht dem zuvor kopierten.
 
-.. image:: ../_images/Tutorial_6_02.png
+.. autoimage:: Tutorial_6_02.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 60
+   :alt: Benutzerdefinierte Folie
 
 Wenn Sie nun die benutzerdefinierte Folie mit Hilfe des Projektorsymbols
 |projector| auswählen, wird das Bild auf dem Projektor angezeigt. Weitere
 Feineinstellungen können Sie im HTML-Tag mit Style-Attributen vornehmen.
 Falls beispielsweise das Bild nicht die passende Größe hat, können Sie
-``style="width:80%;"`` verwenden. Das Anzeigen von PDF-Dateien wird derzeit
-noch nicht unterstützt.
+``style="width:80%;"`` verwenden.
 
-.. image:: ../_images/Tutorial_6_03.png
+.. autoimage:: Tutorial_6_03.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: Projektor mit benutzerdefinierter Folie
 
 .. |projector| image:: ../_images/projector.png
 

docs/de/Tutorial_7.rst

@@ -6,8 +6,11 @@ direkt aus OpenSlides holen. Klicken Sie jeweils im Menüpunkt
 „Tagesordnung“, „Anträge“, „Wahlen“ und „Teilnehmer“ auf die Links ``PDF``,
 die sich jeweils rechts oben befinden.
 
-.. image:: ../_images/Tutorial_7_01.png
+.. autoimage:: Tutorial_7_01.png
    :class: screenshot
+   :scale-html: 45
+   :scale-latex: 80
+   :alt: PDF-Button in der Tagesordnung
 
 Alle weiteren Funktionen von OpenSlides finden Sie in der im Aufbau
 befindlichen Dokumentation im Kapitel `Einzelne Funktionen`__. Wie Sie

docs/extensions/autoimage.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+#
+# Extension for Sphinx to add new directive 'autoimage' which works as subclass
+# of the internal Image directive.
+# Author: Pedro Kroger
+# see http://pedrokroger.net/using-sphinx-write-technical-books/
+# Code snippet from https://gist.github.com/kroger/3856821 with some
+# modifications for OpenSlides.
+#
+
+import os
+
+from docutils import nodes
+from docutils.parsers.rst import directives
+from docutils.parsers.rst.directives.images import Image
+
+
+class Autoimage(Image):
+
+    align_h_values = ('left', 'center', 'right')
+    align_v_values = ('top', 'middle', 'bottom')
+    align_values = align_v_values + align_h_values
+
+    def align(argument):
+        # This is not callable as self.align.  We cannot make it a
+        # staticmethod because we're saving an unbound method in
+        # option_spec below.
+        return directives.choice(argument, Image.align_values)
+
+    option_spec = {'scale-html': directives.percentage,
+                   'scale-latex': directives.percentage,
+                   'scale-epub2': directives.percentage,
+                   'scale-mobi': directives.percentage,
+                   'scale': directives.percentage,
+                   'class': directives.class_option,
+                   'alt': directives.unchanged,
+                   'name': directives.unchanged,
+                   'target': directives.unchanged_required,
+                   'align': align,
+                   }
+
+    def run(self):
+        old_filename = self.arguments[0]
+        env = self.state.document.settings.env
+        builder_name = env.app.builder.name
+
+        self.arguments[0] = os.path.join(env.config.image_dir, old_filename)
+
+        # this doesn't quite work because sphinx stores the previous
+        # values and share among builds. If I do a make clean between
+        # each run it works. Yuck.
+        # I need to run sphinx-build with -E
+        self.options['scale'] = self.options.get('scale-' + builder_name, 100)
+        return super(Autoimage, self).run()
+
+
+def setup(app):
+    app.add_directive('autoimage', Autoimage)
+    app.add_config_value('image_dir', '../_images', False)

openslides/agenda/templates/agenda/overlay_speaker_projector.html

@@ -26,6 +26,7 @@
     #overlay_list_of_speaker_box .old_speaker {
         color: #777777;}
     #overlay_list_of_speaker_box .actual_speaker {
+        font-weight: bold;
         margin-bottom: 0em;}
 </style>