Create a Page: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
| Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
==Available Tools== | ==Available Tools== <!--T:1--> | ||
<!--T:2--> | |||
* [[Special:myLanguage/PageLayout|Page Layout]] helps to standardize the look of pages | * [[Special:myLanguage/PageLayout|Page Layout]] helps to standardize the look of pages | ||
<!--T:3--> | |||
* [[Special:myLanguage/Toolbox|Tool Box]] shows you wiki markup for the effect you need | * [[Special:myLanguage/Toolbox|Tool Box]] shows you wiki markup for the effect you need | ||
<!--T:4--> | |||
* [[Special:myLanguage/Typographical_Guidelines|Typographical Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. | * [[Special:myLanguage/Typographical_Guidelines|Typographical Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. | ||
==Deciding where to create your page== | ==Deciding where to create your page== <!--T:5--> | ||
<!--T:6--> | |||
Many people choose to draft a page on their own Talk page, then move the result to the desired site. Sometimes there is a good reason for preferring to do it in the final location. If that is the case, consider using before your content <nowiki>{{Construction}}</nowiki> which will display | Many people choose to draft a page on their own Talk page, then move the result to the desired site. Sometimes there is a good reason for preferring to do it in the final location. If that is the case, consider using before your content <nowiki>{{Construction}}</nowiki> which will display | ||
{{Construction}} | {{Construction}} | ||
==Wiki Structure== | ==Wiki Structure== <!--T:7--> | ||
<!--T:8--> | |||
For the convenience of users we try to avoid creating a structure more than three levels deep, avoiding having to type long paths for page names. For most purposes, the following guide will suffice: | For the convenience of users we try to avoid creating a structure more than three levels deep, avoiding having to type long paths for page names. For most purposes, the following guide will suffice: | ||
<!--T:9--> | |||
Application <br /> | Application <br /> | ||
Application/Troubleshooting <br /> | Application/Troubleshooting <br /> | ||
| Line 26: | Line 32: | ||
Application/Manual/Section_xxx <br /> | Application/Manual/Section_xxx <br /> | ||
<!--T:10--> | |||
{{Remember|1=<span style="color:red;">Please do not use any kind of punctuation in your page names</span> — punctuation like question marks or periods creates serious problems for the wiki software, in particular for the translation system.}} | {{Remember|1=<span style="color:red;">Please do not use any kind of punctuation in your page names</span> — punctuation like question marks or periods creates serious problems for the wiki software, in particular for the translation system.}} | ||
==Workflow== | ==Workflow== <!--T:11--> | ||
<!--T:12--> | |||
* Navigate to a page, which will contain a link to your new page | * Navigate to a page, which will contain a link to your new page | ||
<!--T:13--> | |||
* Edit this page and insert a link to a new, not yet existing page like this: <nowiki>[[My New Page]]</nowiki> | * Edit this page and insert a link to a new, not yet existing page like this: <nowiki>[[My New Page]]</nowiki> | ||
<!--T:14--> | |||
* Write a one-line summary of what you changed | * Write a one-line summary of what you changed | ||
<!--T:15--> | |||
* Hit the Preview button and check your work | * Hit the Preview button and check your work | ||
<!--T:16--> | |||
* Save your edits. | * Save your edits. | ||
<!--T:17--> | |||
Now the page shows a <span style="color:red">red colored link</span> to your upcoming page. A click on this link will send you directly to your new page and will open the edit box. | Now the page shows a <span style="color:red">red colored link</span> to your upcoming page. A click on this link will send you directly to your new page and will open the edit box. | ||
<!--T:18--> | |||
{{Note|A double-Enter is required to make a new paragraph. Please use this after any heading, as it puts headings in a separate translation unit which is preferred by translators using external tools.}} | {{Note|A double-Enter is required to make a new paragraph. Please use this after any heading, as it puts headings in a separate translation unit which is preferred by translators using external tools.}} | ||
<!--T:19--> | |||
{{Note|If you are making frequent edits to your page, please use either <nowiki>{{Construction}}</nowiki> or <nowiki>{{Being_Edited}}</nowiki> so that translators and other contributors know to wait until you are finished.}} | {{Note|If you are making frequent edits to your page, please use either <nowiki>{{Construction}}</nowiki> or <nowiki>{{Being_Edited}}</nowiki> so that translators and other contributors know to wait until you are finished.}} | ||
<!--T:20--> | |||
{{Warning|Avoid using text smilies as they cause problems for translation applications (due to unbalanced parentheses). Instead use <nowiki>{{Smiley}}</nowiki> {{Smiley}} Other smilies can be found on [[http://commons.wikimedia.org/w/index.php?title=Special:Search&search=smilies&fulltext=1 Commons Wikimedia]] and the file-name is sufficient to get the image included}} | {{Warning|Avoid using text smilies as they cause problems for translation applications (due to unbalanced parentheses). Instead use <nowiki>{{Smiley}}</nowiki> {{Smiley}} Other smilies can be found on [[http://commons.wikimedia.org/w/index.php?title=Special:Search&search=smilies&fulltext=1 Commons Wikimedia]] and the file-name is sufficient to get the image included}} | ||
<!--T:21--> | |||
{{Note|For help about editing existing pages read [[Special:myLanguage/Modify a Page|Modify a Page]].}} | {{Note|For help about editing existing pages read [[Special:myLanguage/Modify a Page|Modify a Page]].}} | ||
<!--T:22--> | |||
[[Category:Contributing]] | [[Category:Contributing]] | ||
</translate> | </translate> | ||
Revision as of 08:49, 4 June 2011
Available Tools
- Page Layout helps to standardize the look of pages
- Tool Box shows you wiki markup for the effect you need
- Typographical Guidelines standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.
Deciding where to create your page
Many people choose to draft a page on their own Talk page, then move the result to the desired site. Sometimes there is a good reason for preferring to do it in the final location. If that is the case, consider using before your content {{Construction}} which will display
Under Construction
This is a new page, currently under construction!
Wiki Structure
For the convenience of users we try to avoid creating a structure more than three levels deep, avoiding having to type long paths for page names. For most purposes, the following guide will suffice:
Application
Application/Troubleshooting
Application/xxx-How-To
Application/Manual
Application/Manual/Introduction
Application/Manual/Section_1
Application/Manual/Section_xxx
Remember
Please do not use any kind of punctuation in your page names — punctuation like question marks or periods creates serious problems for the wiki software, in particular for the translation system.
Workflow
- Navigate to a page, which will contain a link to your new page
- Edit this page and insert a link to a new, not yet existing page like this: [[My New Page]]
- Write a one-line summary of what you changed
- Hit the Preview button and check your work
- Save your edits.
Now the page shows a red colored link to your upcoming page. A click on this link will send you directly to your new page and will open the edit box.
Note
A double-Enter is required to make a new paragraph. Please use this after any heading, as it puts headings in a separate translation unit which is preferred by translators using external tools.
Note
If you are making frequent edits to your page, please use either {{Construction}} or {{Being_Edited}} so that translators and other contributors know to wait until you are finished.
Warning
Avoid using text smilies as they cause problems for translation applications (due to unbalanced parentheses). Instead use {{Smiley}} 
Other smilies can be found on [Commons Wikimedia] and the file-name is sufficient to get the image included
Other smilies can be found on [Commons Wikimedia] and the file-name is sufficient to get the image included
Note
For help about editing existing pages read Modify a Page.