Aktionen im Dokumentationssystem

Im Abschnitt Aktionen fügen Sie Elemente in Ihre Dokumentation an der Stelle ein, an der aktuell Ihr Mauszeiger platziert ist.

Sie können diese Elemente einfügen:

• Bild
• Video
• Video (YouTube)
• Video (Vimeo)
• Code Block
• Tabelle
• Hinweisbox
• Link zu anderer Dokumentation
• agorum-Link
• Externer Link
• Handlungsanweisung

Ein Bild einfügen

---

Sie können diese Bildformate einfügen:

• jpg
• jpeg
• gif
• png

1. Wählen Sie Einfügen beim Cursor > Bild.
2. Wählen Sie ein vorhandenes Bild über oder laden Sie ein Bild über  in einen Ordner.
3. Geben Sie optional einen Untertitel für das Bild ein.
4. Fügen Sie das Bild in die Dokumentation ein.

Ein Video einfügen

---

Sie können das Videoformat mp4 einfügen.

1. Wählen Sie Einfügen beim Cursor > Video.
2. Wählen Sie ein vorhandenes Video über oder laden Sie ein Video über  in einen Ordner.
3. Fügen Sie das Video in die Dokumentation ein.

Ein Video (YouTube) einfügen

---

• Für die Einbettung von YouTube-Links verwendet das System automatisch eine No-Cookie-Variante, um den aktuell gültigen Datenschutzbestimmungen zu entsprechen.
• Das System zeigt die YouTube-Videos im Editor nur als Platzhalter an. Wechseln Sie über die Schaltfläche Anschauen oben im Dokumentationseditor zur Dokumentationsansicht, um das eingefügte Video zu sehen.

1. Wählen Sie Einfügen über Cursor > Video (Youtube).
2. Geben Sie einen Link zum YouTube-Video ein.
3. Fügen Sie das YouTube-Video in die Dokumentation ein.

Ein Video (Vimeo) einfügen

---

Das System zeigt die Vimeo-Videos im Editor nur als Platzhalter an. Wechseln Sie über die Schaltfläche Anschauen oben im Dokumentationseditor zur Dokumentationsansicht, um das eingefügte Video zu sehen.

1. Wählen Sie Einfügen beim Cursor > Video (Vimeo).
2. Geben Sie die URL zum Video oder die ID des Videos an.
3. Fügen Sie das Vimeo-Video in die Dokumentation ein.

Einen Code Block einfügen

---

Mit einem Code Block fügen Sie etwa einen Ausschnitt eines JavaScripts (oder jede andere Art von Code) in das Dokument ein.

• Das System stellt den Code Block im Dokumentationseditor und in der Dokumentationsansicht in unterschiedlichen Farben dar. So hat etwa eine Kommentarzeile eine andere Farbe als ein Statement.
• Das System erkennt automatisch, um welchen Code es sich handelt.
• Erkennt das System keinen speziellen Code, stellt es den Code schwarz dar.

1. Wählen Sie Einfügen beim Cursor > Code Block.
2. Geben Sie Code ein.
3. Fügen Sie den Code Block in die Dokumentation ein.

Eine Tabelle einfügen

---

• Das System formatiert die Tabelle immer auf die gesamte Breite der Dokumentation.
• Sie können zwischen verschiedenen Tabellentypen wählen.
• Jeder Typ ist unterschiedlich formatiert.

1. Wählen Sie Einfügen beim Cursor > Tabelle.
2. Wählen Sie die Anzahl an Zeilen für die Tabelle.
3. Wählen Sie einen Typ.
4. Fügen Sie die Tabelle in die Dokumentation ein.

Eine Hinweisbox einfügen

---

• Sie können zwischen verschiedenen Hinweisboxtypen wählen.
• Jeder Typ ist unterschiedlich formatiert.

1. Wählen Sie Einfügen beim Cursor > Hinweisbox.
2. Geben Sie optional einen Titel sowie Text ein.
   
   Das System füllt den Titel automatisch mit dem Namen des Typs, wenn Sie den Titel leer lassen.
3. Wählen Sie einen Typ.
4. Fügen Sie die Hinweisbox in die Dokumentation ein.

Einen Link zu anderer Dokumentation einfügen

---

Mit dieser Aktion fügen Sie einen Link zu einer anderen Dokumentation ein. Optional können Sie auch eine Überschrift innerhalb der anderen Dokumentation wählen. Klickt der Leser diesen Link zur anderen Dokumentation an, landet er automatisch in dieser Dokumentation oder in einer der dortigen Überschriften, sofern Sie eine solche ausgewählt haben.

1. Wählen Sie Einfügen beim Cursor > Dokumentations-Dokument.
2. Suchen Sie ein Dokument über  .
3. Wählen Sie optional eine Überschrift aus dem gesuchten Dokument, um eine Sprungmarke zu setzen.
4. Vergeben Sie einen Titel für den Link.
   
   Das System schlägt automatisch anhand des verlinkten Dokuments und der Überschrift einen Titel vor.
5. Entfernen Sie den Haken bei der Einstellung Der eingefügten Dokumentation folgen und eine Baumstruktur erstellen oder lassen Sie ihn gesetzt.
   
   Wenn Sie diese Einstellung gesetzt lassen, erstellt das System nachts automatisch einen Link zu dieser anderen Dokumentation in der Baumstruktur.
6. Fügen Sie den Link zur anderen Dokumentation in die Dokumentation ein.

Einen agorum-Link einfügen

---

Mit dieser Aktion fügen Sie einen Link auf ein agorum-Objekt in die Dokumentation ein.

• Als Objekte dienen etwa Dateien wie ZIP-Archive.
• Eingefügte Dateien lassen sich über den Link in der Dokumentation herunterladen.

1. Wählen Sie Einfügen beim Cursor > agorum Link
2. Suchen Sie ein Objekt über  oder laden Sie ein Objekt über  in einen Ordner.
3. Vergeben Sie einen Titel.
4. Fügen Sie den agorum-Link in das Dokument ein.

Einen externen Link einfügen

---

Mit dieser Aktion fügen Sie einen Link auf eine externe Seite außerhalb von agorum core ein.

1. Wählen Sie Einfügen beim Cursor > externer Link
2. Vergeben Sie optional einen Titel.
3. Geben Sie den Link ein.
4. Fügen Sie den externen Link in das Dokument ein.

Eine Handlungsanweisung einfügen

---

Mit dieser Aktion fügen Sie speziell formatierte Handlungsanweisungen in die Dokumentation ein.

Sie können jederzeit manuell Schritte in der Handlungsanweisung hinzufügen, indem Sie eine neue Zeile mit der Enter-Taste erzeugen.

1. Wählen Sie Einfügen beim Cursor > Handlungsanweisungen.
2. Geben Sie die Anzahl an Handlungsschritten ein.
3. Fügen Sie die Handlungsanweisung in die Dokumentation ein.