Calligra/Wiki editing hints

From KDE Community Wiki
Revision as of 18:00, 6 December 2010 by Cyrille (talk | contribs) (Created page with '== Using templates == To improve readibility of your wiki pages you can now '''"tag"''' them by adding boxes of appropriate type. The markup behind this is called ''wiki template...')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Using templates

To improve readibility of your wiki pages you can now "tag" them by adding boxes of appropriate type. The markup behind this is called wiki templates.

Inserting information about unfinished content

Use:

{{Improve}}

.. to get this:

Warning

This section needs improvements: Please help us to

cleanup confusing sections and fix sections which contain a todo


You can add more info to the box. Example:

{{Improve|Let's all chip in to compile a list of icons.}}

Here's the result:

Warning

This section needs improvements: Please help us to

cleanup confusing sections and fix sections which contain a todo


Let's all chip in to compile a list of icons.

Inserting notes

Use:

{{Note|This is stable API}}

.. to get this:

Note

This is stable API


Inserting other general warnings

Use:

{{Warning|Don't do it!}}

.. to get this:

Warning

Don't do it!


Links to bugs in the KDE's Bugzilla

Use:

{{Bug|12345}}

.. to get automatic link like this: Bug #12345

Random notes

  • Page names. Use natural language with spaces - wiki will replace them with _ in URLs. Use hierarchical names, e.g. Icons/KOffice wide icons instead of flat structured KOffice wide icons. Then, create parent page, e.g. Icons for Icons/KOffice_wide_icons. You will get a nice link to the parent on the top of the subpage, allowing navigation. Many levels are allowed in the hierarchy.
  • Use a single line containing __TOC__ to control where do you want to display table of contents.