Wiki Menu

From The Document Foundation Wiki
Jump to: navigation, search

This page coordinates the development of the wiki menu and its localization.

Description

The top menu was created because many users who come from the official websites (www.documentfoundation.org or www.libreoffice.org) or from search engines can't find back to the official websites. It must always appear at the very top of the page because it is the only menu bar formatted with a top margin.

The main menu bar should appear on all international wiki pages, which are involved in the menu structure. It can be followed by other menu bars, especially {{OrigLang|}}-bar.

The second menu bar is for all international Wiki sites, which are involved in the sub menu. It can be followed by other menu bars, especially {{OrigLang|}}-bar. There should be some attention that the following menu bars have no top margin (except the {{OrigLang|}}-bar).

Top level

{{TopMenu}}

First level (main menu)

{{Menu}}

Second level (Sub Menus)

Menu Design

{{Menu.Design}}

Menu Development

{{Menu.Development}}

Menu Documentation

{{Menu.Documentation}}

Menu Events

{{Menu.Events}}

Menu Extensions

{{Menu.Extensions}}

Menu Home

{{Menu.Home}}

Menu LibreOffice-Box

{{Menu.Box}}

Menu Localization

{{Menu.Localization}}

Menu Macros

{{Menu.Macros}}


Menu Magazine

{{Menu.Magazine}}

Menu Marketing

{{Menu.Marketing}}

Menu QA

{{Menu.QA}}

Menu ReleaseNotes

{{Menu.ReleaseNotes}}

Menu TDF

{{Menu.TDF}}

Menu Website

{{Menu.Website}}

Third level (sub menu)

Menu FAQs

{{Menu.FAQ}}

Menu Building

{{Menu.Building}}

Menu ReleasePlan

{{Menu.ReleasePlan}}

Menu UndertheHood

{{Menu.UnderTheHood}}


Structure of the template

First there is the menu itself. The complete menu includes the following tags:

{{SubMenuStart}}
Menu items by using {{SubMenuEntry}} or {{SubMenuEntryAlternative}} (see documentation page)
</ul></div><noinclude>
{{OrigLang|}}
Documentation of the template (e.g. Usage)
Categories (e.g. [[Category:Templates|Menubar]], see Category:Templates)
</noinclude>

The reason is that for the Template-namespace the subside feature isn't enabled so you won't get the right links.

Localization

Base

If you want to localize the menus there are two possibilities as described in Multilingual Wiki: If it is a "translated" menu like the main menu or the submenus above I would prefer to make them like subpages named by their language code (e.g. Template:Menu/de, Template:Menu.Design/de, Template:Menu/fr Template:Menu.Design/fr).

If it is a (sub)menu which has only local focus and is useful in its local language only and have a relevance to other languages, the menu should be like subpages of a page named by the language code in upper case (e.g. Template:DE/Menu.Schweiz, Template:DE/Menu.Österreich, Template:FR/Menu.Belgique, Template:FR/Menu.France). But this SHOULD be the exception.

How to create a localized menu?

If you want to localize an international (sub)menu you only have to open the international menu and click on the desired language code. If there is no localized menu you will be asked to edit it.

Now you can build the template like it is described in the next point (or copy it from the international (English) template and translate it).

How to get the menu to appear on a wiki page

It is easy to do: At the top of your page, type in the code which is described in the "Usage" or the wiki code listed at this page at the top of the example on this page.

Credits

Thanks to Christian K. who created the menus for the German Wiki on which these are based.