Create a Page: Difference between revisions

From KDE UserBase Wiki
(Included Structure section)
m (Removed protection from "Create a Page")
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Available Tools==
<languages />
<translate>
==Available Tools== <!--T:1-->


* [[PageLayout|Page Layout]] helps to standardize the look of pages
<!--T:2-->
* [[Toolbox|Tool Box]] shows you wiki markup for the effect you need
* [[Special:myLanguage/PageLayout|Page Layout]] helps to standardize the look of pages
* [[Typographical_Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.


==Wiki Structure==
<!--T:3-->
* [[Special:myLanguage/Toolbox|Tool Box]] shows you wiki markup for the effect you need


Try to avoid creating a structure more than three levels deep.  For most purposes,  the following guide will suffice:
<!--T:4-->
* [[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== <!--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:4-->
<!--T:9-->
Application <br />
Application <br />
Application/Troubleshooting <br />
Application/Troubleshooting <br />
Line 18: Line 32:
Application/Manual/Section_xxx <br />
Application/Manual/Section_xxx <br />


==Workflow==
<!--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
 
<!--T:15-->
* 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:23-->
{{Note|You can also create a new page, by entering the URL of the new page directly in your browser address bar. '''In this case, don't forget to link the new page from another page.'''}}
 
<!--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.}}


# Navigate to a page, which will contain a link to your new page
<!--T:19-->
# Edit this page and insert a link to a new, not yet existing page like this: <nowiki>[[My New Page]]</nowiki>
{{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.}}
# 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 <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: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}}


{{Note|For help about editing existing pages read [[Modify a Page]].}}
<!--T:21-->
{{Note|For help about editing existing pages read [[Special:myLanguage/Modify a Page|Modify a Page]].}}


<!--T:22-->
[[Category:Contributing]]
[[Category:Contributing]]
</translate>

Latest revision as of 10:39, 20 July 2023

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

You can also create a new page, by entering the URL of the new page directly in your browser address bar. In this case, don't forget to link the new page from another page.


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.