Difference between revisions of "User:Hans/Examples2"

Revision as of 12:17, 4 June 2011

Basic formatting

Section headings

== Level 2 ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====
====== Level 6 ======

Section headings define the structure of the page and is used to generate the Table of Contents. They are created by putting two or more = characters at each end of the section heading.

 

Remember
= Level 1 = is reserved for page titles and should not be used.

Paragraphs and newlines

This is a paragraph.
This belongs to the same paragraph.

This starts a new paragraph.

You can manually insert a newline like this. <br />
Use this feature sparingly.

Paragraphs are created by separating two blocks of text with at least one empty line.

Text formatting

'''Bold text'''

''Italic text''

''Bold and italic text''

See Typographical Guidelines for more information about when to use what.

Lists

* One
* Two
** Two point one
* Three

# One
# Two
## Two point one
# Three

* One
* Two
*# Two point one
* Three

;item 1
: definition 1
;item 2
: definition 2-1
: definition 2-2

 

Note

(to be made shorter) Please remember, that long lists are a problem for translators. With single level bulleted lists, place each bullet in a section of its own, i.e. make a blank line between bullets. With two levels of bullets the subitems must be kept in the same section as their top level bullet; if you have to use subbullets, please keep the sublists short! With enumerations involved, you must keep everything in one unit. Please try to avoid enumerations, and if you find that you must use them try to keep them short.

Indenting text

No indent (normal)
:First indent

 

Note
Multiple indents can cause problems and should not be used anymore.

Escape wiki markup

To make '''bold text''',
use <nowiki>'''bold text'''</nowiki>

Sometimes it is useful to not apply the wiki markup, for example when you want to demonstrate how to use the markup. In such cases you can put <nowiki> and </nowiki> between the text that should remain unformatted.

Common elements

Links

[[Special:myLanguage/Dolphin|Dolphin]]

[[Special:myLanguage/Dolphin|Custom text]]

[http://kde.org An external link]

Images

A single centered image

text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text

text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text

Thumbnail with caption

This is a caption

text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text text

Multiple images in a grid

More examples

More detailed examples can be found on http://www.mediawiki.org/wiki/Help:Images.

Icons

You type	You get
Click on {{Icon|plasma}} to open the desktop Tool Box.	Click on to open the desktop Tool Box.

The best way to refer to icons in the GUI is to display the icon in the text. The argument (in the example above plasma) is the same as the icon name that icon themes use.

If the icon does not exist, it has to be uploaded to the wiki:

• The icons can often be found locally in the directory usr/share/icons/oxygen/
• Find the icon image file, preferably in 16x16 px
• Copy the image file to your home directory and add Icon- in front of the filename. The rest of the filename should remain the same, so for example plasma.png would be Icon-plasma.png
• Upload the icon to UserBase. See Update an Image for more information about how to upload images

Code

Here is some <code>code</code> in running text.

{{Input|1=<nowiki>
The code in this box is input by the user
  Indent with whitespace 
</nowiki>}}

The code in this box is input by the user
  Indent with whitespace 

{{Output|1=<nowiki>
This is some output the user would read from e.g. Konsole
It works in a similar way as the input box above
</nowiki>}}

This is some output the user would read from e.g. Konsole
It works in a similar way as the input box above

{{Input|<syntaxhighlight lang="php" line>
# The input and output box also support syntax highlighting
# This is useful for displaying source code, in this example some PHP code

# Initialise common code
$preIP = dirname( __FILE__ );
require_once( "$preIP/includes/WebStart.php" );
</syntaxhighlight>}}

1 # The input and output box also support syntax highlighting
2 # This is useful for displaying source code, in this example some PHP code
3 
4 # Initialise common code
5 $preIP = dirname( __FILE__ );
6 require_once( "$preIP/includes/WebStart.php" );

Quotes

<blockquote>This is a quote from another page</blockquote>

Information, Note, Tip and Warning box

You type	You get
{{Info|This is general information}}	Information This is general information
{{Note|Some important information to note}}	Note Some important information to note
{{Tip|A helpful piece of advice}}	Tip A helpful piece of advice
{{Warning|Something that can be dangerous}}	Warning Something that can be dangerous

Where the strongest possible warning is needed, the Remember box can be used, but please use sparingly.

You type	You get
|{{Remember|1=Important thing to remember}}	Remember Important thing to remember

 

Tip
You can change the heading of boxes using 3=New heading, for example {{Remember|3=Don't Forget This!|1=You must make sure that...}}.

Special text

Dates

2 April 2012

18 Mar 2011

Dates in a purely numerical format cause confusion due to differences in expectations of geographical zones. Spell out the month completely or in abbreviated form (first three letters), and write the year in 4-digit format. The day may be single or double-digit.

Keyboard keys and shortcuts

Press <keycap>Enter</keycap>

<keycap>Alt + Shift + E</keycap>

Menus and sequence of choices?

A sequence of menu choices should look like this: File -> Create New -> Folder...

Other sequences have a similar look, for example System Settings -> Hardware -> Multimedia

Filenames and paths

This is an example of a filename: some_file.txt

A path is written in a similar way: ~/some/path/

Application pages

Application screenshot and description

The dedicated file manager focusing on usability

KDE3 and KDE SC 4 versions

If you write about the KDE3 version of an application, you should use this icon.

If information about the KDE SC 4 version appears an the same page, you can use this icon.

Community applications

For community applications not distributed as core KDE applications, add {{Community-app}} to the bottom of the page. It shows up like this:

 See footnote