Create a Page: Difference between revisions

From KDE UserBase Wiki
No edit summary
m (Slightly different procedure with special:mylanguage links)
(2 intermediate revisions by the same user not shown)
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> &mdash; 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> &mdash; 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


* Edit this page and insert a link to a new, not yet existing page like this: <nowiki>[[My New Page]]</nowiki>
<!--T:13-->
* Edit this page and insert a link to a new, not yet existing page like this: <nowiki>[[Special:myLanguage/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.


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:17-->
Now the page shows a <span style="color:red">red colored link</span> to your upcoming page. A click on this link will tell you, that the page doesn't exist yet, and offer you to create the page. Clicking this
sends 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 05:10, 23 June 2011

Available Tools

  • 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: [[Special:myLanguage/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 tell you, that the page doesn't exist yet, and offer you to create the page. Clicking this sends 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


Note

For help about editing existing pages read Modify a Page.