Modify a Page: Difference between revisions

    From KDE UserBase Wiki
    (Marked this version for translation)
    (2 intermediate revisions by one other user not shown)
    Line 10: Line 10:


    <!--T:4-->
    <!--T:4-->
    * [[Special:myLanguage/Typographical Guidelines]] standardises markup for use in translation, either to official manuals (DocBook) or to other languages.
    * [[Special:myLanguage/Typographical Guidelines|Typographical Guidelines]] standardises markup for use in translation, either to official manuals (DocBook) or to other languages.


    == Workflow == <!--T:5-->
    == Workflow == <!--T:5-->
    Line 18: Line 18:


    <!--T:7-->
    <!--T:7-->
    * You should see a preview of the page, and the ''Edit box'' below it (you might have to scroll down)
    * You should see a preview of the page, and the ''Edit box'' below it &mdash; you might have to scroll down. If you don't see the preview at first you can enable this in [[Special:Preferences|your preferences]]


    <!--T:8-->
    <!--T:8-->
    Line 27: Line 27:


    <!--T:10-->
    <!--T:10-->
    * Hit the '''Preview''' button
    * Click the <menuchoice>Show Preview</menuchoice> button


    <!--T:11-->
    <!--T:11-->
    * Check how the page looks like in the preview. If you have included links, hover over them and look at the status bar to see if they are going to take you to the intended location.
    * Check how the page looks like in the preview. If you have included links, hover over them and look at the status bar to see if they are going to take you to the intended location; or better still, open the link in a new tab.


    <!--T:12-->
    <!--T:12-->
    * If you need to correct anything, make the changes in the Edit box and hit '''Preview''' again. Repeat until you're happy with the results
    * If you need to correct anything, make the changes in the Edit box and click <menuchoice> Show Preview</menuchoice> again. Repeat until you're happy with the results


    <!--T:13-->
    <!--T:13-->
    * Click on '''Save page''' to save your work
    * Click on <menuchoice>Save page</menuchoice> to save your work


    <!--T:14-->
    <!--T:14-->
    Line 43: Line 43:


    <!--T:15-->
    <!--T:15-->
    {{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 - that is, there must be an empty line between the heading and the paragraph.  Please use this, as it puts headings in a separate translation unit which is preferred by translators using external tools.}}


    <!--T:16-->
    <!--T:16-->

    Revision as of 14:34, 29 November 2011

    Available Tools

    • 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

    • Click on the Edit button
    • You should see a preview of the page, and the Edit box below it — you might have to scroll down. If you don't see the preview at first you can enable this in your preferences
    • Make your changes in the Edit box
    • Write a one-line summary of what you changed in the Summary box
    • Click the Show Preview button
    • Check how the page looks like in the preview. If you have included links, hover over them and look at the status bar to see if they are going to take you to the intended location; or better still, open the link in a new tab.
    • If you need to correct anything, make the changes in the Edit box and click Show Preview again. Repeat until you're happy with the results
    • Click on Save page to save your work

    Warning

    NEVER add new translate section tags (which look like <!--T:18-->). The software will do everything necessary with tags, and manually changing them will break the system.

    If you are adding markup for the first time, please read the Edit Markup page and the Typographical Guidelines


    Note

    A double-Enter is required to make a new paragraph - that is, there must be an empty line between the heading and the paragraph. Please use this, 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. Instead use {{Smiley}}


    Hints and Tips

    • You can experiment in the Sandbox page to familiarize yourself with page editing and the wiki markup