20210628 - Upgrade of php fixed the page rendering issue.

Welcome to the Slackware Documentation Project

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
Last revision Both sides next revision
slackdocs:styleguide [2012/09/05 16:13 (UTC)]
hazel [A General Note on Style]
slackdocs:styleguide [2012/09/08 03:24 (UTC)]
nocturnal.slacker [A General Note on Style] added external definition of "foo"
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".
  
  
Line 108: Line 108:
   * English is the primary language of the Wiki. Every Wiki article must **at least** have an English version.   * 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 [[slackbook:install|slackbook: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.+  * 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.   * 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.

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