Hilfreiche Informationen zur Bearbeitung
Inhalt |
[bearbeiten] Übersicht
Der Großteil des Inhalts dieses Wikis ist in Wiki-Vorlagen gekapselt, einige davon sind einfach, andere... weniger so. Sie erledigen den Großteil der Formatierung und helfen dabei, wiederholende Elemente an einem Ort zu sammeln, sodass Änderungen nicht mehrmals vorgenommen werden müssen.
Sie können die Textformatierungs-Syntax verwenden, die auf der Cheatsheet von Wikipedia zu finden ist (siehe auch: Help:Editing), jedoch stehen auch Vorlagen zur Verfügung, die im Allgemeinen bevorzugt werden, wie auf der Seite Help:Templates aufgelistet.
Im Allgemeinen können Sie sehen, wie Vorlagen und Markup verwendet werden, indem Sie eine vorhandene Seite auswählen und in den Bearbeiten-Modus wechseln, um zu sehen, wie sie erstellt wurde.
[bearbeiten] Weitere Hilfe
Wenn Sie zusätzliche Hilfe benötigen, können Sie eines der folgenden tun:
- Fragen Sie, indem Sie Text zur Diskussionsseite Cppreference talk:FAQ hinzufügen.
- Treten Sie cpplang auf Slack bei, treten Sie dann dem Kanal cppreference bei und fragen Sie dort.
[bearbeiten] Textformatierung
Siehe die Vorlagenhilfe für Formatierung.
Die gebräuchlichste Monospace-Schriftart (Teletype)-Vorlage ist beispielsweise {{tlc|tt| {{tt|Text}}.
[bearbeiten] Links
Für externe Links verwenden Sie die Syntax von Wikipedia.
Für interne Links siehe die Vorlagenhilfe für Links.
Eine häufig verwendete automatische Verknüpfungsvorlage ist lc, die für bekannte Bezeichner verwendet wird. Zum Beispiel erstellt {{lc|std::vector}} einen Link zur Seite und zeigt ihn in Teletype-Schriftart an, wie: std::vector.
[bearbeiten] Code
Siehe die Vorlagenhilfe für Syntaxhervorhebung.
Die Vorlage {{c|1=Code}} wird häufig für Inline-Code verwendet, und wenn der Code kein "=" enthält, kann das "1=" weggelassen werden. Zum Beispiel werden {{c|true}} und {{c|false}} häufig für Rückgabewerte true und false verwendet.
[bearbeiten] Fallstricke und Eigenheiten
- Innerhalb von Wiki-Vorlagen-Klammerabschnitten kann die Wiki-Engine manchmal durch das Symbol "
=" verwirrt werden; verwenden Sie{{=}}, um dieses Problem zu umgehen. - Die Vorlage
{{!=}}zeigt nicht "!=" an, sondern "|=", und ebenso zeigt{{!}}"|" an. Verwenden Sie stattdessen!{{=.
[bearbeiten] Wiederholender Inhalt
Einige Klassen/Typen haben gemeinsame Unterseiten, da sie die gleiche (oder fast die gleiche) API haben. Zum Beispiel haben std::condition_variable und std::condition_variable_any fast identische APIs mit denselben Beschreibungen und Erklärungen für die meisten Funktionen.
Um die Wiederholung desselben Textes zu vermeiden und zu vermeiden, Dinge an mehreren Stellen korrigieren zu müssen, werden benutzerdefinierte Vorlagen für ihre Unterseiten verwendet. Wenn Sie beispielsweise zur Seite für condition_variable::notify_one() gehen, sehen Sie eine vollständige Informationsseite, aber wenn Sie auf Bearbeiten klicken, sehen Sie nur eine include-Vorlage. Der eigentliche Inhalt wurde von seiner Vorlage generiert.
Die Verwendung solcher Vorlagen für Unterseiten kann knifflig sein und ist hier zu kompliziert zu erklären. Wenn Sie es aus den aktuellen Anwendungsfällen nicht herausfinden können, fragen Sie um Hilfe - siehe den Abschnitt "Weitere Hilfe" oben.
