Revision as of 15:47, 17 June 2007 by Dhaumann (Talk | contribs) (create translation howto)

Jump to: navigation, search

todo: integrate (+ validate for kde4) those pages into sane locations ;)

  • Common Programming Mistakes
hey, the first one we have not ported yet. should be moved for kde4 into Development/Tutorials (TODO)
Thinking more about it, it could be an extension of Policies/Library_Code_Policy, i.e. as subpage like Policies/Library_Code_Policy/Common Mistakes (although it's not only about libraries...)
  • KDE Developer's Checklist
look svery old. if migrated, please fix it for kde3 or even kde4 (TODO)
  • What is Scripty?
indeed a TODO :)


Contribute to KDE TechBase

You are welcome to contribute to the KDE TechBase wiki. In order to keep a high quality of the articles there are some guidelines you should follow.

What Content belongs into KDE TechBase

The KDE TechBase wiki is meant to contain technical information all around KDE, for instance

More details can be found in the article 'Help:Wiki Structure'. End-user documentation or API documentation should not be added here.

Where to put new Articles

The KDE TechBase wiki uses subpages. Take a quick look at the article about the Help:Wiki Structure. In short: Do not randomly add toplevel pages.

It is possible to translate KDE TechBase articles into other languages. Read the article about Translation for further details.

The Procedure

You want to add new content. To keep high quality, please create the article in your userpage first (e.g. User:foo/My Acticle). Once it is ready, discuss the article with other developers and proof-read it. Finally, if a location is found, move the page.

Translation into other Languages

It is possible to translate articles into other languages. The reference language should be the english version.

Step 1: Language Abbreviations

As an example let us assume you want to translate the following page to german:

The language abbreviation for german is de, thus, all articles will have the ending " (de)" (with a leading space).

Reference: list of language abbreviations.

Step 2: Create the Article

Sometimes a link in the language navigation bar already exists. In that case, simply click on the link you want to translate. If no, create the article manually:

As initial content simply use the content of the corresponding english page.

Step 3: Language Navigation Bar

The article must contain the following template line in order to show the language navigation bar:

  • {{Template:I18n/Language Navigation Bar|Development/Tutorials}}

This magic line expands to the language navigation bar for the article Development/Tutorials.

Step 4: Language Missing?

If the language is missing, please search for the right abbreviation (see Step 1). In the example above this abbreviation is " (de)".

Edit Template:I18n/Language Navigation Bar and add a line for the language you want to translate:

<span lang="de">[[{{{1}}}_(de)|Deutsch]]</span>

Replace 'de' by the language abbreviation and adapt the visible name.

Important Notes

As the wiki uses subpages it is likely that translators run into the following issue.

Assume the following pages exist:

1. Development/Tutorials
2. Development/Tutorials/Debugging

Further assume you want to translate (1) to german (postfix de).

The final page will be

3. Development/Tutorials_(de)

The english content of (2) uses relative wiki links like /Debugging. Translating Debugging in (3) might result in

Development/Tutorials_(de)/Debugging      # or

This is wrong.

The right link is supposed to be


So be sure you adapt the links in the article to use absolute paths everywhere (i.e. no leading slash '/' in the wiki links).

Content is available under Creative Commons License SA 4.0 unless otherwise noted.