Enjoy Slackware 15.0!

Welcome to the Slackware Documentation Project

Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
slackdocs:styleguide [2012/09/05 23:46 (UTC)]
mfillpot [Translating a Page] redirected install link to community page 		slackdocs:styleguide [2012/09/14 21:25 (UTC)]
zithro [Translating a Page] removed text, linked to translation guidelines
Line 99: Line 99:
   * If your text has examples of key presses, use the %%<key></key>%% markup to make a visual impact. <key>Alt-F2</key> looks better than "''Alt-F2''".   * If your text has examples of key presses, use the %%<key></key>%% markup to make a visual impact. <key>Alt-F2</key> looks better than "''Alt-F2''".
   * Avoid the passive voice. Use it only when alternatives would be clumsy.   * Avoid the passive voice. Use it only when alternatives would be clumsy.
-  * Try to avoid long-windedness. "To do x, use the -y option" or "To do x, type foo -y" reads better than "If you want foo to do x for you, you need to type foo -y".+  * Try to avoid long-windedness. "To do x, use the -y option" or "To do x, type [[http://www.techopedia.com/definition/7264/foo|foo]] -y" reads better than "If you want foo to do x for you, you need to type foo -y".
  
  
 ===== Translating a Page ===== ===== Translating a Page =====
  
-The multi-language capability of this Wiki requires that you stick to a few rules: +The multi-language capability of this Wiki requires that you stick to a few rules. Please read them in the specific [[slackdocs:translation_guide|Translation Guidelines]].
- +
-  * English is the primary language of the Wiki. Every Wiki article must **at least** have an English version. +
- +
-  * When you want to translate a page, you must not change the name of the page. \\ For example to translate [[slackware:install|slackware:install]] into Brazilian Portuguese, just add the **pt-br:** prefix in the URL like this: [[pt-br:slackware:install|http://docs.slackware.com/pt-br:slackware:install]] . Do not change the page name "//install//" to its Brazilian Portuguese translation of "//instalar//" ! You should only translate the page's content. +
- +
-  * If you want to create a //new// page in your native language, first create the English version of the page using an English word for the page. A page name like "instalar" is not an English word and therefore will not be accepted. You can start with an empty English page if you want, with just a title for example and containing a large notice that you are working on a translated version first. Then, add your language prefix into the page URL, and start writing your document. +
- +
-<note>A good practice is to put your doc through an automatic translator like [[http://translate.google.com/ | http://translate.google.com/]], paste the translated English text into the empty English page, and post on the [[http://lists.alienbase.nl/mailman/listinfo/slackdocs | slackdocs mailing list]] for help to fix the English translation. //__Creating the English version is a requirement if you want the site editors to accept the article in your own language.__// \\ You should add a note or warning to the English version that it is in need of proof-reading and editing.</note> +
 ===== Pages That Require Attention from an Admin ===== ===== Pages That Require Attention from an Admin =====
  

In Other Languages
QR Code
QR Code slackdocs:styleguide (generated for current page)