Create a Page: Difference between revisions

From KDE UserBase Wiki
m (Slightly different procedure with special:mylanguage links)
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Creating a New Page==
<languages />
<translate>
==Available Tools== <!--T:1-->


===Available Tools===
<!--T:2-->
* [[Special:myLanguage/PageLayout|Page Layout]] helps to standardize the look of pages


* [[PageLayout|Page Layout]] helps to standardise the look of pages
<!--T:3-->
* [[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
* [[Typographical_Guidelines]] standardises markup for use in translation, either to official manuals (DocBook) or to other languages.


==Workflow==
<!--T:4-->
* Select the Edit tab
* [[Special:myLanguage/Typographical_Guidelines|Typographical Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.
* You should see a preview of the page, and the edit box below it.
 
* Make your changes in the edit box
==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
{{Construction}}
 
==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:
 
<!--T:9-->
Application <br />
Application/Troubleshooting <br />
Application/xxx-How-To <br />
Application/Manual <br />
Application/Manual/Introduction <br />
Application/Manual/Section_1 <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.}}
 
==Workflow== <!--T:11-->
 
<!--T:12-->
* 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>[[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
* Hit the Preview button
 
* If you have included links, check how they display, and hover over them, checking the status line to see if they are going to take you to the intended location.
<!--T:15-->
* Save your work.
* Hit the Preview button and check your work
 
<!--T:16-->
* 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 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.}}
 
<!--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.}}
 
<!--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}}
 
<!--T:21-->
{{Note|For help about editing existing pages read [[Special:myLanguage/Modify a Page|Modify a Page]].}}
 
<!--T:22-->
[[Category:Contributing]]
</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.