User:Dhaumann: Difference between revisions

From KDE TechBase
(create translation howto)
(translation moved to Wiki Translation)
Line 33: Line 33:


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.
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:
* [[Development/Tutorials]]
The language abbreviation for german is '''de''', thus, all articles will have the ending " (de)" (with a leading space).
Reference:  [http://www.opticentre.net/FAQ/Languages/List-of-language-abbreviations/ 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:
* [[Development/Tutorials (de)]]
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:
* <nowiki>{{Template:I18n/Language Navigation Bar|Development/Tutorials}}</nowiki>
This magic line expands to the language navigation bar for the article <tt>Development/Tutorials</tt>.
== 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:
<nowiki><span lang="de">[[{{{1}}}_(de)|Deutsch]]</span></nowiki>
Replace 'de' by the language abbreviation and adapt the visible name.
== Important Notes ==
As the wiki uses [[Help:Wiki Structure|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 <tt>/Debugging</tt>. Translating ''Debugging'' in (3) might result in
Development/Tutorials_(de)/Debugging      # or
Development/Tutorials_(de)/Debugging_(de)
'''This is wrong.'''
The '''right link''' is supposed to be
Development/Tutorials/Debugging_(de)
So be sure you adapt the links in the article to use absolute paths everywhere (i.e. no leading slash '/' in the wiki links).

Revision as of 16:14, 17 June 2007

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 :)

see: http://developer.kde.org/documentation/other/index.html

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.

Retrieved from "https://techbase.kde.org/index.php?title=User:Dhaumann&oldid=11306"