| Angabe | Wert |
|---|---|
| Thema | Editoren und Wiki-Funktionen |
| Kurzbeschreibung | AsciiDoc mit Vorschau schreiben, Formatierungen verwenden und die Grenzen der Einbindung kennen. |
| Zielgruppe | Autoren und Leser |
AsciiDoc ist ein Texteditor für strukturierte Dokumente. Du schreibst mit kurzen Formatzeichen und kontrollierst daneben die Vorschau. Das ist zum Beispiel für eine längere Regelübersicht oder eine mehrteilige Anleitung mit Hinweisen, Tabellen und Fußnoten nützlich. Für einen gewöhnlichen Wiki-Artikel sind unsere Artikelmuster im visuellen Editor meist der einfachere Einstieg.
Eine AsciiDoc-Seite beginnen
- Öffne zuerst eine Seite in einem Bereich, in dem du schreiben darfst. Nur dort erscheint das + / Erstellen-Menü.
- Wähle Neue AsciiDoc-Seite.
- Schreibe deinen Text im Quelltextbereich und prüfe die Vorschau.
- Ergänze Titel, Kurzbeschreibung und passende Tags. Beim ersten Speichern legst du Zielordner und Pfad fest. Prüfe auch, ob die Seite veröffentlicht oder ein Entwurf sein soll.
Die wichtigsten Schreibweisen
== Beschreibung
Ein *wichtiger Begriff* und eine _Hervorhebung_.
* Ein Listenpunkt
* Ein weiterer Listenpunkt
. Erster Schritt
. Zweiter Schritt
== Quellen
Werk, Ausgabe und genaue Fundstelle.
NOTE: Hier steht ein Hinweis.
Der Seitentitel wird in den Eigenschaften festgelegt. Beginne die Gliederung darunter mit == für die erste Abschnittsebene. AsciiDoc verwendet andere Zeichen als Markdown: Fett wird hier mit einzelnen Sternchen geschrieben.
Was du damit machen kannst
Die Werkzeugleisten helfen bei Überschriften, Formatierungen, Listen, Zitaten, Hinweisen, Links, Medien, Tabellen und Codeblöcken. Auch Fußnoten und Definitionslisten eignen sich für längere Erklärungen. Verwende die Link- und Medienauswahl, statt technische Dateipfade zu erraten.
Unsere Wiki-Blöcke können über die Blockwerkzeuge eingefügt werden. Prüfe ihre Vorschau; ihre Parameter sind nicht gewöhnlicher Fließtext. Die Blockhilfen erklären die vorhandenen Bausteine.
Darauf solltest du achten
- Die Vorschau speichert noch nichts. Erst das Speichern der Wiki-Seite übernimmt die Änderung.
- AsciiDoc-Anleitungen aus dem Internet können Funktionen zeigen, die hier nicht verfügbar sind. Das Einbinden anderer Dateien mit
include::ist in dieser Wiki deaktiviert. - Mathematische Formeln funktionieren nur mit einem dafür aktivierten Renderer.
- Eine vorhandene Markdown- oder visuelle Seite wird durch Öffnen dieser Hilfe nicht umgestellt. Beachte für Änderungen am Seitentyp die Hilfe zum Editorwechsel.
Zur allgemeinen Hilfe · Alle Anleitungen zum Schreiben und Bearbeiten