Hilfe zur Hilfe: DocWiki
Inhaltsverzeichnis |
Erste Schritte
Um die Seite Diskussion bearbeiten zu können, müssen Sie sich anmelden. Wenden Sie sich wegen einer Berechtigung zum Bearbeiten von Hauptseiten an documentation@embarcadero.com.
- Klicken Sie auf die Registerkarte Diskussion, um Fragen zum Thema zu stellen oder zu beantworten.
- Klicken Sie auf die Registerkarte Bearbeiten, um den Wiki-Quelltext anzuzeigen und optional das angezeigte Thema zu bearbeiten.
Wichtige Wiki-Tags zum Bearbeiten oder Schreiben von Beiträgen
Aufzählungszeichen
Zum Erstellen eines Absatzes mit Aufzählungszeichen geben Sie ein Sternchen (*) in die erste Spalte ein. Verwenden Sie für verschachtelte Ebenen mehrere Sternchen wie folgt:
- * (ein Sternchen) erstellt ein Aufzählungszeichen auf der obersten Ebene, wie dieses.
- ** (zwei Sternchen) erstellen ein Aufzählungszeichen auf der zweiten Ebene, wie dieses.
- *** (drei Sternchen) erstellen ein Aufzählungszeichen auf der dritten Ebene, wie dieses.
- ** (zwei Sternchen) erstellen ein Aufzählungszeichen auf der zweiten Ebene, wie dieses.
Hyperlinks
Zum Erstellen eines Hyperlinks zu einem anderen Thema im DocWiki schließen Sie den Titel des Themas in doppelte, eckige Klammern ein:
[[Objektinspektor]] = Objektinspektor
Verknüpfen zwischen Wikis
Das DocWiki ist in drei einzelne DocWikis unterteilt: Themen, Bibliotheken und Codebeispiele. Sie können diese DocWikis untereinander verknüpfen.
- Fügen Sie zum Erstellen eines Hyperlinks zur Bibliotheksreferenz das Präfix "lib_de:" hinzu. Für andere Sprachen verwenden Sie "lib_en" (Englisch), "lib_fr" (Französisch) und "lib_ja" (Japanisch). Zum Entfernen des Präfixes aus dem Link fügen Sie im Titel das Zeichen "|" ein:
- [[lib_de:Vcl.Forms.TForm|Vcl.Forms.TForm]] = Vcl.Forms.TForm
- Zum Verknüpfen von einem anderen DocWiki mit dem Themen-DocWiki fügen Sie das Präfix "rad_de:" hinzu:
- [[rad_de:Objektinspektor|Objektinspektor]] = Objektinspektor
- Zum Verknüpfen mit dem DocWiki mit den Codebeispielen verwenden Sie das Präfix samp::
- [[samp:TrySystemTimeToDateTime (Delphi)|TrySystemTimeToDateTime (Delphi)]] = TrySystemTimeToDateTime (Delphi)
Überschriften
Um Überschriften verschiedener Gliederungsstufen zu erstellen, beginnen und beenden Sie die betreffende Zeile mit einem oder mehreren Gleichheitszeichen (=). Für eine Überschrift der obersten Ebene wird ein Gleichheitszeichen, für untergeordnete Überschriften werden mehrere Gleichheitszeichen verwendet:
== Sample Heading 2 ==
erstellt eine Überschrift 2, wie die folgende:
Überschrift 2
=== Sample Heading 3 ===
erstellt eine Überschrift 3, wie die folgende:
Überschrift 3
Hinzufügen einer Seite zum DocWiki
- Fügen Sie in einem zugehörigen Thema (ein Thema, das einen Link zu dem zu erstellenden Thema enthalten soll) einen Link zu dem neuen Thema hinzu:
- [[Neues Thema]]
- Speichern Sie die Seite.
- Klicken Sie auf den (roten) Link zu Ihrer neuen Seite.
- Nun können Sie mit dem Schreiben des neuen Themas beginnen.
- Fügen Sie oben ein übergeordnetes Tag hinzu (für den Link "Nach oben zu" in der H2-Hilfe):
- {{parent|Übergeordnetes Thema}}
- Dieses Tag muss auf das Thema zeigen, das in der Hilfehierarchie (Inhaltsverzeichnis) Ihrem Thema übergeordnet ist.
- Hinweis: Wenn Sie nicht sicher sind, welches Thema das übergeordnete ist, wenden Sie sich an khouser@embarcadero.com.
- Fügen Sie unten optional die Rubrik Siehe auch hinzu:
- ==Siehe auch==
Hinzufügen von Wiki-Kategorien-Tags
Kategorien-Tags ermöglichen das Gruppieren zusammengehöriger Themen. Eine Liste der aktuell in dem DocWiki verwendeten Kategorien finden Sie unter http://docwiki.embarcadero.com/RADStudio/de/Spezial:Kategorien.
Auf jeder Seite sollte mindestens eines der folgenden Tags enthalten sein:
- Sprach-Tag, Delphi oder C++ oder beide
- Versions-Tag
- Optionales Technologie-Tag
- Organisatorisches Tag (wie "Delphi-Sprachreferenz" oder "RAD Studio – Referenz")
Dazu einige Beispiele:
Nur Delphi:
[[Category: Delphi]]
Nur C++:
[[Category: C++]]
Beide:
[[Category: C++]][[Category: Delphi]]
Jede Seite sollte ein Tag für die Version enthalten, in der sie zuerst erschienen ist, oder in der sie aktualisiert und für die neuere Version getestet wurde: 2010, XE, XE2 usw.:
[[Category: XE2]]
2010:
[[Category:2010]]
Mehrere:
[[Category:XE]][[Category:2010]]
Weitere Kategorien betreffen die Technologie; hier einige Vorschläge dazu.
FireMonkey-Bibliothek:
[[Category:FMX]]
RTTI-Bibliothek:
[[Category:RTTI]]