Wiki Editing Hints/de

From Qt Wiki
< Wiki Editing Hints
Revision as of 00:59, 18 March 2016 by Katzschke (talk | contribs) (Translation and corrected Link to german wikimedia page)
Jump to navigation Jump to search
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

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.

Add categories

Add category tags to insert a link to your article in the appropriate summary pages. By adding your article to existing categories you help readers find your content.

If you want to create a new category and summary page, just tag your article to a category that does not yet exist like so: [[Category:Wiki Help]]

Collaboration

Wikis are meant for collaborative editing. To make it as easy as possible for everybody please follow some basic rules:

  • Discuss your pages on the Talk subpage that can be reached via the top toolbar
  • Write in an understandable, informative, but not too formal language.
  • Structure your pages with subheadings and a healthy amount of paragraphs for easier understanding and better reading.
  • Explain acronyms, at least at first use.
  • Use meaningful but straight to the point page names.
  • Don't mindlessly throw away other people's work.
  • Use [[Category:...]] to group pages by topic.

Category pages

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?

Templates

One can make use of the MediaWiki Templates. This page summarizes the current state of available Templates:

Template Name You type You get
Template:DocLink creates a link to the doc.qt.io reference documentation
  • {{DocLink|QWidget}}
  • {{DocLink|QWidget|properties}}
  • {{DocLink|QWidget|size-prop|size()}}
  • {{DocLink|QtWidgets-Index||Qt Widgets}}
Template:LangLinks creates a list of predefined language links so that you can easily see what languages are available for the page specified {{LangLinks|base=Download Data from URL}} bg de el es fr it ja ko pt ru zh
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. {{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 inserts a notification box {{Ambox|text=Some notification text}}
Some notification text
Template:WarningBox inserts a warning box {{WarningBox|text=Some warning 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. {{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 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. {{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.

Multi-language articles

When creating new articles the first language should always be English (reference language). When translating an article you just append the 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.

Example:

Tables

The Mediawiki help page on Tables is useful reading to anyone who edits tables.

Code highlighting

The wiki uses the standard GeSHi syntax highlighter.

The only customisation made, has been to add the <code> tag to the highlighted list handled by GeSHi. The default language is set to C++/Qt toolkit. You can change the language with the lang="" attribute.

For example, you can use these settings:

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

Zusammenarbeit

Wikis wurden zur gemeinschaftlichen Arbeit an Inhalten entworfen. Um das so einfach wie möglich zu gestalten, orientiere dich bitte an den folgenden grundlegenden Regeln:

  • Nutze eine verständliche, informative, aber nicht zu gestelzte Sprache
  • Gliedere deine Seiten mittels Überschriften und einer angemessenen Zahl von Absätzen, um Verständlichkeit und Lesefluss zu fördern
  • Erkläre Abkürzungen — spätestens bei ihrer ersten Benutzung
  • Nutze griffige Seitennamen
  • Verwirf nicht leichtfertig anderer Menschen Arbeit
  • Nutze Tags um Seiten zu gruppieren