Wiki Editing Hints/de: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
m (Translation)
m (added translation for code inline)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}
{{LangSwitch}}
{{LangSwitch}}
 
[[Category:Help]]
[[Category:German]]


== Die ersten Schritte ==
== Die ersten Schritte ==
Line 60: Line 59:
* Kategorien <nowiki>[[Category:...]]</nowiki> sollten genutzt werden, um Seiten thematisch zu gruppieren
* Kategorien <nowiki>[[Category:...]]</nowiki> sollten genutzt werden, um Seiten thematisch zu gruppieren


== Category pages ==
== Kategorieseiten ==


Whenever you create a new category for your page the wiki software will create a landing page for it. This page is editable just like any other page. Just click on the link displayed on your page and edit away. All pages within the respective category will be displayed on this page. Why not start it with an introduction to the topic?
Sobald eine neue Kategorie auf einer Seite verwendet und damit erstellt wird, generiert die Wiki-Software auch eine Einstiegsseite für diese Kategorie. Diese Seite kann genauso bearbeitet werden wie jede andere Seite des Wikis auch. Dafür muss der angezeigte Link für die Kategorie nur angeklickt werden und die Kategorieseite kann direkt bearbeitet werden. Alle Seiten dieser Kategorie werden auf der Kategorieseite angezeigt. Warum also nicht eine Einleitung zum Thema auf der Kategorieseite verfassen?


== Templates ==
== Templates ==


One can make use of the MediaWiki Templates. This page summarizes the current state of available Templates:
Es können auch MediaWiki-Templates im Wiki genutzt werden. Dieser Abschnitt fasst den aktuellen Stand der verfügbaren Templates zusammen:


{| class="wikitable" width="100%"
{| class="wikitable" width="100%"
! Template Name
! Name des Templates
! You type
! Befehl
! You get
! Ergebnis
|-
|-
| [[Template:DocLink]] creates a link to the doc.qt.io reference documentation
| [[Template:DocLink]] erstellt einen Link zur Qt-Referenz (doc.qt.io)
|style="white-space:nowrap;"|
|style="white-space:nowrap;"|
* <nowiki>{{DocLink|QWidget}}</nowiki>
* <nowiki>{{DocLink|QWidget}}</nowiki>
Line 83: Line 82:
* {{DocLink|QWidget|properties}}
* {{DocLink|QWidget|properties}}
* {{DocLink|QWidget|size-prop|size()}}
* {{DocLink|QWidget|size-prop|size()}}
* {{DocLink|QtWidgets-Index||Qt Widgets}} (note the empty anchor parameter)
* {{DocLink|QtWidgets-Index||Qt Widgets}} (ein leerer Ankerparameter ist ebenfalls möglich)
|-
|-
| [[Template:LangLinks]] creates a list of predefined language links so that you can easily see what languages are available for the page specified
| [[Template:LangLinks]] erstellt eine Liste der zuvor erstellten Sprachlinks, sodass schnell gesehen werden kann, welche Sprachen für die angegebene Seite verfügbar sind
| <nowiki>{{LangLinks|base=Download Data from URL}}</nowiki>
| <nowiki>{{LangLinks|base=Download Data from URL}}</nowiki>
| {{LangLinks|base=Download Data from URL}}
| {{LangLinks|base=Download Data from URL}}
|-
|-
| [[Template:LangSwitch]] does the same as LangLinks but for the same page the template is inserted. It checks all available language subpages and inserts a link. For this template you don't need to specify any parameters.
| [[Template:LangSwitch]] hat die gleiche Funktion wie LangLinks, aber es führt das Template für die Seite aus, auf der es eingefügt worden ist. Es überprüft alle verfügbaren Sprach-Unterseiten und fügt die Links ein. Für dieses Template muss kein Parameter angegeben werden.
| <nowiki>{{LangSwitch}}</nowiki>
| <nowiki>{{LangSwitch}}</nowiki>
| {{LangSwitch}}
| {{LangSwitch}}
|-
|-
| [[Template:Ambox]] inserts a notification box
| [[Template:Ambox]] fügt eine Box mit einem Hinweis hinzu
| <nowiki>{{Ambox|text=Some notification text}}</nowiki>
| <nowiki>{{Ambox|text=Some notification text}}</nowiki>
| {{Ambox|text=Some notification text}}
| {{Ambox|text=Some notification text}}
|-
|-
| [[Template:WarningBox]] inserts a warning box
| [[Template:WarningBox]] fügt eine Box mit einer Warnung hinzu
| <nowiki>{{WarningBox|text=Some warning text}}</nowiki>
| <nowiki>{{WarningBox|text=Some warning text}}</nowiki>
| {{WarningBox|text=Some warning text}}
| {{WarningBox|text=Some warning text}}
|-
|-
| [[Template:Cleanup]] inserts a notice that the article needs improvement, and puts the article in [[:Category:Articles needing cleanup]]. You can specify the reason for the tag.
| [[Template:Cleanup]] fügt eine Notiz hinzu, dass der Artikel verbessert werden muss und fügt den Artikel in die [[:Category:Articles needing cleanup]] hinzu. Eine Begründung kann auch angegeben werden.  
| <nowiki>{{Cleanup|reason=The text is too repetitive.}}</nowiki>
| <nowiki>{{Cleanup|reason=The text is too repetitive.}}</nowiki>
| {{Ambox|text='''This article may require cleanup to meet the Qt Wiki's quality standards.''' Reason: The text is too repetitive.<br /><small>Please '''[{{fullurl:{{FULLPAGENAME}}|action=edit}} improve this article]''' if you can. Remove the <nowiki>{{cleanup}}</nowiki> tag and add this page to '''[[Updated pages]]''' list after it's clean.</small>}}
| {{Ambox|text='''This article may require cleanup to meet the Qt Wiki's quality standards.''' Reason: The text is too repetitive.<br /><small>Please '''[{{fullurl:{{FULLPAGENAME}}|action=edit}} improve this article]''' if you can. Remove the <nowiki>{{cleanup}}</nowiki> tag and add this page to '''[[Updated pages]]''' list after it's clean.</small>}}
|-
|-
| [[Template:Delete]] inserts a notice that the article is nominated for deletion, and puts the article in [[:Category:Delete]]. You can specify the reason for the tag.
| [[Template:Delete]] fügt eine Notiz hinzu, dass der Artikel für die Löschung nominiert ist und fügt den Artikel in die [[:Category:Delete]] hinzu. Eine Begründung kann auch angegeben werden.
| <nowiki>{{Delete|reason=This page is empty.}}</nowiki>
| <nowiki>{{Delete|reason=This page is empty.}}</nowiki>
| {{WarningBox|text=This article is nominated for deletion. Reason: This page is empty.<br /><small>Please raise your support/opposition to this nomination in the article's Discussion page.</small>}}
| {{WarningBox|text=This article is nominated for deletion. Reason: This page is empty.<br /><small>Please raise your support/opposition to this nomination in the article's Discussion page.</small>}}
|}
|}


== Multi-language articles ==
== Artikel in mehreren Sprachen ==


When creating new articles the first language should always be English (reference language). When translating an article you just append the [[wikipedia:List of ISO 639-1 codes|ISO-639-1]] language code separated by a slash to the URL and hit Enter. The Wiki now tells you that the page can be created.
Wenn ein neuer Artikel erstellt wird, sollte die erste Sprache Englisch sein und als Referenz dienen. Sobald ein Artikel übersetzt werden soll, wird einfach ein Slash und der  [[wikipedia:List of ISO 639-1 codes|ISO-639-1]] Sprachcode an die URL angehangen und Enter gedrückt. Das Wiki bestätigt nun, dass die Seite erstellt werden kann.  


Example:
Beispiel:


* [[Basic Qt Programming Tutorial]]
* [[Basic Qt Programming Tutorial]]
* [[Basic Qt Programming Tutorial/de]]
* [[Basic Qt Programming Tutorial/de]]


== Tables ==
== Tabellen ==


The Mediawiki [https://www.mediawiki.org/wiki/Help:Tables help page on Tables] is useful reading to anyone who edits tables.
Die MediaWiki-[https://www.mediawiki.org/wiki/Help:Tables/de Hilfsseite für Tabellen] ist nützlich für jeden, der Tabellen bearbeiten möchte.


== Code highlighting ==
== Syntax-Highlighting von Programmcode ==


The wiki uses the standard [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi syntax highlighter].
Dieses Wiki verwendet den [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi Syntax-Highlighter].


The only customisation made, has been to add the <nowiki><code></nowiki> tag to the highlighted list handled by GeSHi. The default language is set to C++/Qt toolkit. You can change the language with the <tt>lang=""</tt> attribute.
Die einzige Anpassung, die gemacht worden ist, ist das Hinzufügen des <nowiki><code></nowiki>-Elements zu der Elementliste, die von GeSHi behandelt wird. Die Standardprogrammiersprache ist auf C++/Qt gesetzt. Das Syntax-Highlighting kann mit Hilfe des Attributs <tt>lang=""</tt> geändert werden.


For example, you can use these settings:
Zum Beispiel können folgende Einstellungen gemacht werden:
* Javascript/QML : <tt><nowiki><code lang="javascript"></nowiki></tt>  
* Javascript/QML : <tt><nowiki><code lang="javascript"></nowiki></tt>  
* Qt .pro : <tt><nowiki><code lang="make"></nowiki></tt>  
* Qt .pro : <tt><nowiki><code lang="make"></nowiki></tt>  
* Command Lines : <tt><nowiki><code lang="bash"></nowiki></tt>
* Kommandozeilen : <tt><nowiki><code lang="bash"></nowiki></tt>
* XML : <tt><nowiki><code lang="xml"></nowiki></tt>
* XML : <tt><nowiki><code lang="xml"></nowiki></tt>




[[Category:General]]
Um Code '''inline''' in einem Absatz hervorzuheben, sollte man folgendes tun:  
[[Category:German]]
... der folgende hervorgehobene Text <nowiki><code </nowiki>'''inline'''<nowiki>>void mySuperFunkyFunc(const char*)</code></nowiki> sollte im selben Absatz bleiben ...
 
Dieser wird dann so angezeigt:
 
... der folgende hervorgehobene Text <code inline>void mySuperFunkyFunc(const char*)</code> sollte im selben Absatz bleiben ...
 
Ohne '''inline''':
 
... der folgende hervorgehobene Text <code>void mySuperFunkyFunc(const char*)</code> erzeugt einen neuen Absatz ...

Latest revision as of 00:03, 15 April 2020

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

Die ersten Schritte

  • Dieses Wiki ist der richtige Ort um Wissen über Qt zu teilen. Aber die Artikel sollten auf Themen beschränkt werden, die mit Qt zu tun haben.
  • Wenn eine neue Seite erstellt werden soll, ist es wichtig zuerst zu überprüfen, ob sie nicht bereits existiert. Das Suchfeld rechts oben auf dieser Seite ist für diesen Zweck gedacht. Wenn es schon eine Seite zum gesuchten Thema gibt, wird sie in den Suchergebnissen erscheinen.
  • Da diese Webseite ein Wiki ist, kann der Inhalt auf fast allen Seiten bearbeitet werden.
  • Wenn keine Seite zu einem Thema existiert, kann sie erstellt werden, indem man auf den Link Create the page "Suchbegriff" on this wiki! in den Suchergebnissen klickt.
  • Um ein "Vermüllen" der Versionsgeschichte einer Seite durch Tests zu verhindern, sollte die Sandbox stattdessen für Tests genutzt werden.

Wie man eine Seite bearbeitet

Das Qt Wiki basiert auf MediaWiki, der Wiki-Engine, die von Wikipedia und vielen anderen Wikis genutzt wird.

Wenn eine Seite bearbeitet wird, wird eine Werkzeugleiste angezeigt, die es erlaubt die meist genutzten Syntax-Elemente einzufügen. Die Wikicode-Syntax ist unkompliziert und man kann Wikicode direkt schreiben ohne die Werkzeugleiste zu nutzen. Ein Blick auf die MediaWiki Bearbeitungshilfe bietet einen schnellen Überblick.

Es soll bitte immer die "Preview"-Option genutzt werden, um die Änderungen an der Seite vor dem Abspeichern zu überprüfen. So wird verhindert, dass die Versionsgeschichte mit überflüssigen Einträgen vermüllt wird, wenn man die zuvor gemachten Eingabefehler behebt.

Wie man eine gute Seite erstellt

Ein paar einfache Richtlinien sollten eingehalten werden um anderen Entwicklern zu helfen, die Information zu finden nach der sie suchen:

So schreiben wie man programmiert

Gute Wikis sind wie guter Code: einfach zu überblicken und einfach zu warten. Jeder Artikel sollte sich mit einem Thema beschäftigen (sehr ähnlich zu einer Klasse). Jeder Absatz sollte sich mit einem Aspekt des Themas beschäftigen (wie eine Funktion).

Überschriften für eine bessere Übersicht verwenden

Lange Artikel kann man einfacher lesen, wenn informative Überschriften hinzugefügt werden. Für die Einleitung sollte bitte die MediaWiki-Überschriftstiefe (==) verwendet werden und danach die Tiefen === und ====, um einzelne Aspekte des Themas abzugrenzen. (Der Editor enthält Schaltflächen, mit denen sich die Überschriften schnell einfügen lassen.) Die Überschriften sollten aussagekräftig den Inhalt des Abschnitts zusammenfassen.

Ein Inhaltsverzeichnis hinzufügen

Wenn ein Leser einen Artikel findet, wird er die erste Seite zunächst überfliegen, um herauszufinden, ob der Artikel enthält, wonach er sucht. Ist der Artikel nicht länger als eine Buchseite, kann er einfach geschrieben werden. Wenn der Artikel länger als eine Buchseite ist, sollte ein Inhaltsverzeichnis erstellt werden, damit der Leser schnell weiß, was im Artikel enthalten ist. Der erste Abschnitt und das Inhaltsverzeichnis sollten dem Leser reichen, um zu entscheiden, ob er auf der Seite bleiben oder sie verlassen möchte.

Ein Inhaltsverzeichnis wird automatisch generiert, sobald drei Überschriften hinzugefügt worden sind (unabhängig von ihrer Tiefe). Manchmal möchte man nicht, dass ein Inhaltsverzeichnis erstellt wird (z.B. wenn die erstellte Seite selbst ein Inhaltsverzeichnis ist). In so einem Fall kann der Befehl __NOTOC__ am Anfang der Seite eingefügt werden.

Kategorien hinzufügen

Um einen Link zu dem neu erstellten Artikel auf den passenden Übersichtsseiten zu erzeugen, kann man ihn einer oder mehreren existierenden Kategorien hinzufügen. Auf diese Weise wird den Lesern geholfen den neuen Artikel zu finden.

Wenn eine neue Kategorie mit Übersichtsseite angelegt werden soll, kann der Artikel einfach mit einer Kategorie gekennzeichnet werden, die noch nicht existiert:

[[Category:Wiki Help]].


Zusammenarbeit

Wikis wurden zur gemeinschaftlichen Arbeit an Inhalten entworfen. Um das für alle so einfach wie möglich zu machen, sollten bitte die folgenden Grundregeln beachtet werden:

  • Ein Artikel sollte auf der zugehörigen "Talk"-Seite diskutiert werden
  • Eine verständliche, informative, aber nicht zu formelle Sprache hilft dem Leser, den Inhalt besser zu verstehen
  • Gegliederte Seiten (durch Überschriften und durch eine angemessenen Zahl von Absätzen) fördern die Verständlichkeit und den Lesefluss
  • Abkürzungen sollten zumindest bei ihrer ersten Benutzung erklärt werden
  • Eindeutige Seitennamen sollten verwendet werden
  • Die Arbeit anderer sollte nicht leichtfertig verworfen werden
  • Kategorien [[Category:...]] sollten genutzt werden, um Seiten thematisch zu gruppieren

Kategorieseiten

Sobald eine neue Kategorie auf einer Seite verwendet und damit erstellt wird, generiert die Wiki-Software auch eine Einstiegsseite für diese Kategorie. Diese Seite kann genauso bearbeitet werden wie jede andere Seite des Wikis auch. Dafür muss der angezeigte Link für die Kategorie nur angeklickt werden und die Kategorieseite kann direkt bearbeitet werden. Alle Seiten dieser Kategorie werden auf der Kategorieseite angezeigt. Warum also nicht eine Einleitung zum Thema auf der Kategorieseite verfassen?

Templates

Es können auch MediaWiki-Templates im Wiki genutzt werden. Dieser Abschnitt fasst den aktuellen Stand der verfügbaren Templates zusammen:

Name des Templates Befehl Ergebnis
Template:DocLink erstellt einen Link zur Qt-Referenz (doc.qt.io)
  • {{DocLink|QWidget}}
  • {{DocLink|QWidget|properties}}
  • {{DocLink|QWidget|size-prop|size()}}
  • {{DocLink|QtWidgets-Index||Qt Widgets}}
Template:LangLinks erstellt eine Liste der zuvor erstellten Sprachlinks, sodass schnell gesehen werden kann, welche Sprachen für die angegebene Seite verfügbar sind {{LangLinks|base=Download Data from URL}} bg de el es fr it ja ko pt ru zh
Template:LangSwitch hat die gleiche Funktion wie LangLinks, aber es führt das Template für die Seite aus, auf der es eingefügt worden ist. Es überprüft alle verfügbaren Sprach-Unterseiten und fügt die Links ein. Für dieses Template muss kein Parameter angegeben werden. {{LangSwitch}}

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

Template:Ambox fügt eine Box mit einem Hinweis hinzu {{Ambox|text=Some notification text}}
Some notification text
Template:WarningBox fügt eine Box mit einer Warnung hinzu {{WarningBox|text=Some warning text}}
Some warning text
Template:Cleanup fügt eine Notiz hinzu, dass der Artikel verbessert werden muss und fügt den Artikel in die Category:Articles needing cleanup hinzu. Eine Begründung kann auch angegeben werden. {{Cleanup|reason=The text is too repetitive.}}
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: The text is too repetitive.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.
Template:Delete fügt eine Notiz hinzu, dass der Artikel für die Löschung nominiert ist und fügt den Artikel in die Category:Delete hinzu. Eine Begründung kann auch angegeben werden. {{Delete|reason=This page is empty.}}
This article is nominated for deletion. Reason: This page is empty.
Please raise your support/opposition to this nomination in the article's Discussion page.

Artikel in mehreren Sprachen

Wenn ein neuer Artikel erstellt wird, sollte die erste Sprache Englisch sein und als Referenz dienen. Sobald ein Artikel übersetzt werden soll, wird einfach ein Slash und der ISO-639-1 Sprachcode an die URL angehangen und Enter gedrückt. Das Wiki bestätigt nun, dass die Seite erstellt werden kann.

Beispiel:

Tabellen

Die MediaWiki-Hilfsseite für Tabellen ist nützlich für jeden, der Tabellen bearbeiten möchte.

Syntax-Highlighting von Programmcode

Dieses Wiki verwendet den GeSHi Syntax-Highlighter.

Die einzige Anpassung, die gemacht worden ist, ist das Hinzufügen des <code>-Elements zu der Elementliste, die von GeSHi behandelt wird. Die Standardprogrammiersprache ist auf C++/Qt gesetzt. Das Syntax-Highlighting kann mit Hilfe des Attributs lang="" geändert werden.

Zum Beispiel können folgende Einstellungen gemacht werden:

  • Javascript/QML : <code lang="javascript">
  • Qt .pro : <code lang="make">
  • Kommandozeilen : <code lang="bash">
  • XML : <code lang="xml">


Um Code inline in einem Absatz hervorzuheben, sollte man folgendes tun:

... der folgende hervorgehobene Text <code inline>void mySuperFunkyFunc(const char*)</code> sollte im selben Absatz bleiben ...

Dieser wird dann so angezeigt:

... der folgende hervorgehobene Text void mySuperFunkyFunc(const char*) sollte im selben Absatz bleiben ...

Ohne inline:

... der folgende hervorgehobene Text

void mySuperFunkyFunc(const char*)

erzeugt einen neuen Absatz ...