Help:Contents: Difference between revisions

From KDE TechBase
m (Fixed typo "tempate")
(→‎Tips: language codes reference)
Line 19: Line 19:
== Tips ==
== Tips ==
; Syntax highlighting
; Syntax highlighting
: Wrap your C++ Qt/KDE code snippets in <code cpp>, <code cpp n>, <code qt> and </code> to get syntax highlighting (cpp == c++, qt == qt) and numbered lines (n). Replace "cpp" with the language used, e.g. rubyqt for Ruby and pythonqt for Python (soon). Use "ini" for .desktop files, "xml" for XML files.
: Wrap your C++ Qt/KDE code snippets in <TT >&lt;code cpp&gt;</TT >, <TT >&lt;code cpp n&gt;</TT >, <TT >&lt;code cpp-qt&gt;</TT > and <TT >&lt;/code&gt;</TT > to get syntax highlighting (<TT >cpp</TT > for C++, <TT >cpp-qt</TT > for Qt) and numbered lines (<TT >n</TT >). Replace <TT >cpp</TT > with [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages the language used], e.g. <TT >ruby</TT > for Ruby and <TT >python</TT > for Python (soon). Use <TT >ini</TT > for {{path|.desktop}} files, <TT >xml</TT > for XML files.  Use plain <TT >&lt;code></TT > for wikitext (for now).


== New Templates ==
== New Templates ==

Revision as of 19:41, 14 September 2010


Help:Contents


Before you start to add or change content, please read the articles about the

Wiki Syntax

To get started with the MediaWiki syntax, read

The most important commands are summarized in the Wikipedia Cheatsheet. Information about how to migrate content can be found here.

Tips

Syntax highlighting
Wrap your C++ Qt/KDE code snippets in <code cpp>, <code cpp n>, <code cpp-qt> and </code> to get syntax highlighting (cpp for C++, cpp-qt for Qt) and numbered lines (n). Replace cpp with the language used, e.g. ruby for Ruby and python for Python (soon). Use ini for .desktop files, xml for XML files. Use plain <code> for wikitext (for now).

New Templates

To get a list of pages using a template, go to corresponding template page (e.g. Template:movepage) and click "What links here" in the toolbox.

{{movepage|url}}
Use this template to mark a page as not finished.
{{improve|explanation}}
Pages which need cleanups or contain empty sections and/or todos are marked with this template. Add an explanation if you want (optional)
{{tip|text}}
Use this template to add a tip for the reader.
{{note|text}}
Use this template to add an explanatory note.
{{warning|text}}
Use this template to add a warning.
{{qt|class-name}} and {{qt3|class-name}}
Use this template to generate a link to a Qt class, e.g. QWidget. For Qt3 classes use {{qt3|class-name}}
{{class|class-name}}
Use this template to generate a link to a KDE class, e.g. KDialog.
{{path|path-or-filename}}
Use this template for paths and filenames, this way all of them have a consistent style.
{{bug|123456}}
Use this template to automatically create a link to KDE's bugzilla.
{{KDE3}}
Use this template to mark the content of a page as applicable for either KDE 3. Don't tag technology agnostic pages. For KDE4 content, use [[Category:KDE4]].
{{TutorialBrowser|series|name|pre|next|reading}}
A template for tutorial navigation
{{Box|caption|text|width|float}}
Use this template to create a box with a caption and a text. The width parameter is optional and can be specified absolute (400px) or relative (50%). The last parameter is the float value, which is also optional and defaults to center.