Create a Page: Difference between revisions

    From KDE UserBase Wiki
    m (saving work-space)
     
    m (Slightly different procedure with special:mylanguage links)
    (21 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.
     
    <!--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: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
     
    <!--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: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.