Modifying the Sidebar: Difference between revisions

    From KDE TechBase
    No edit summary
    No edit summary
    Line 8: Line 8:
    The list-level controls if the item is written as a seperating heading or a link.
    The list-level controls if the item is written as a seperating heading or a link.


    The list items are divided into two parts by a pipe "|". Both parts shall be the name of a page that belongs to the MediaWiki namespace as well. The first part is a placholder for the link, the second one is a placeholder for the title of the link shown in the sidebar.
    The list items are divided into two parts by a pipe "|". Both parts shall be the name of a page that belongs to the MediaWiki namespace as well. The first part is a placeholder for the link, the second one is a placeholder for the title of the link shown in the sidebar.


    For TechBase related changes we prefer following nomenclature:
    For TechBase related changes we prefer following nomenclature:
    Line 20: Line 20:
    Example:
    Example:
    * <tt>MediaWiki:Sidebar</tt>:{{Input|1=<nowiki>...
    * <tt>MediaWiki:Sidebar</tt>:{{Input|1=<nowiki>...
    ** tb-translation-workflow | ub-helpfiles-new-content
    ** tb-translation-workflow | tb-helpfiles-new-content
    ...</nowiki>}}
    ...</nowiki>}}
    * <tt>MediaWiki:ub-helpfiles-new-content</tt>:{{Input|1=<nowiki>Add new pages</nowiki>}}
    * <tt>MediaWiki:tb-helpfiles-new-content</tt>:{{Input|1=<nowiki>Add new pages</nowiki>}}
    * <tt>MediaWiki:ub-helpfiles-new-content-url</tt>:{{Input|1=<nowiki>Tasks and Tools</nowiki>}}
    * <tt>MediaWiki:tb-helpfiles-new-content-url</tt>:{{Input|1=<nowiki>Tasks and Tools</nowiki>}}
    Where "Tasks and Tools" is the name of an existing page of the Main namespace.
    Where "Tasks and Tools" is the name of an existing page of the Main namespace.


    == Links to Anchors ==
    == Links to Anchors ==
    If the link shall point to an anchor of a page you have to insert a redirect-page as a work around. Following the nomenclature this page should be called <tt>ub-name-redirect</tt> and shall only contain the #REDIRECT statement wich leads to the final destination page.
    If the link shall point to an anchor of a page you have to insert a redirect-page as a work around. Following the nomenclature this page should be called <tt>tb-name-redirect</tt> and shall only contain the #REDIRECT statement wich leads to the final destination page.


    So let's improve the example from above:
    So let's improve the example from above:
    * <tt>MediaWiki:Sidebar</tt>:{{Input|1=<nowiki>...
    * <tt>MediaWiki:Sidebar</tt>:{{Input|1=<nowiki>...
    ** ub-helpfiles-new-content-url | ub-helpfiles-new-content
    ** tb-helpfiles-new-content-url | tb-helpfiles-new-content
    ...</nowiki>}}
    ...</nowiki>}}
    * <tt>MediaWiki:ub-helpfiles-new-content</tt>:{{Input|1=<nowiki>Add new pages</nowiki>}}
    * <tt>MediaWiki:tb-helpfiles-new-content</tt>:{{Input|1=<nowiki>Add new pages</nowiki>}}
    * <tt>MediaWiki:ub-helpfiles-new-content-url</tt>:{{Input|1=<nowiki>ub-helpfiles-new_content-redirect</nowiki>}}
    * <tt>MediaWiki:tb-helpfiles-new-content-url</tt>:{{Input|1=<nowiki>tb-helpfiles-new_content-redirect</nowiki>}}
    * <tt>ub-helpfiles-new-content-redirect</tt>:{{Input|1=<nowiki>Tasks and Tools#Add_New_Pages</nowiki>}}
    * <tt>tb-helpfiles-new-content-redirect</tt>:{{Input|1=<nowiki>#REDIRECT [[Tasks and Tools#Add_New_Pages]]</nowiki>}}


    <span id="Translating Sidebar Items"></span>
    <span id="Translating Sidebar Items"></span>
    Line 47: Line 47:
    ...</nowiki>}}
    ...</nowiki>}}


    Now the new items can be translated. Visit the [[Special:Translate | Translate page]]. At the bottom of the list you will find the page "Userbase's custom interface messages". Finally choose your language and fetch the items to be translated.
    Now the new items can be translated. Visit the [[Special:Translate | Translate page]]. At the bottom of the list you will find the page "TechBase's custom interface messages". Finally choose your language and fetch the items to be translated.


    [[Category:Admin]]
    [[Category:Admin]]

    Revision as of 18:24, 8 July 2011

     
    Currently Being Edited
    This page is currently being edited.
    If this notice persists for an unreasonable time, please either notify irc.freenode.org #kde-www or report on Annewilson's Talk page.


    Involved Pages

    The Sidebar ist generated with a special page in the MediaWiki namespace, that is MediaWiki:Sidebar. It is a bullet list with special items. Don't mix it up with common list styling!

    The list-level controls if the item is written as a seperating heading or a link.

    The list items are divided into two parts by a pipe "|". Both parts shall be the name of a page that belongs to the MediaWiki namespace as well. The first part is a placeholder for the link, the second one is a placeholder for the title of the link shown in the sidebar.

    For TechBase related changes we prefer following nomenclature:

    ** tb-name-url | tb-name

    Replace name to your needs.

    Now you have to edit MediaWiki:tb-name and MediaWiki:tb-name-url. These pages will contain only one line with the title of the link and the page the link shall point to.

    Example:

    • MediaWiki:Sidebar:
      ...
      ** tb-translation-workflow | tb-helpfiles-new-content
      ...
    • MediaWiki:tb-helpfiles-new-content:
      Add new pages
    • MediaWiki:tb-helpfiles-new-content-url:
      Tasks and Tools

    Where "Tasks and Tools" is the name of an existing page of the Main namespace.

    Links to Anchors

    If the link shall point to an anchor of a page you have to insert a redirect-page as a work around. Following the nomenclature this page should be called tb-name-redirect and shall only contain the #REDIRECT statement wich leads to the final destination page.

    So let's improve the example from above:

    • MediaWiki:Sidebar:
      ...
      ** tb-helpfiles-new-content-url | tb-helpfiles-new-content
      ...
    • MediaWiki:tb-helpfiles-new-content:
      Add new pages
    • MediaWiki:tb-helpfiles-new-content-url:
      tb-helpfiles-new_content-redirect
    • tb-helpfiles-new-content-redirect:
      #REDIRECT [[Tasks and Tools#Add_New_Pages]]

    Translating Sidebar Items

    The pages containing the link titles are listed in a special page that is MediaWiki:Techbase-messages. Just write them down without any list formatting or such.

    In our example we have to insert the line

    ...
    tb-translation-workflow
    ...

    Now the new items can be translated. Visit the Translate page. At the bottom of the list you will find the page "TechBase's custom interface messages". Finally choose your language and fetch the items to be translated.