Navigation in a Multi-lingual Site

The linguist plugIn allows parallel editing of a given topic in many languages. However, to create a multilingual site, there are two other areas to address, both relating to navigation. The first is to provide a useful navigation tool for your pages, the second deals with jumping from one language to another and supported by the crossLink macro

In most instances you will have a structure that will look like this:

myManilaWebsite/en/category1/story1
myManilaWebsite/en/category1/story2

myManilaWebsite/es/category1/story1
myManilaWebsite/es/category1/story2

myManilaWebsite/cn/category1/story1
myManilaWebsite/cn/category1/story2

The following is a step by step description of of setting up a navigation menu that only shows links to the other pages in that language.

1. enable the ManilaFixer Plug-in. Your site administrator may need to make this possible.
2. In myManilaWebsite/admin/sitePrefs ->navigation, empty out the navigation section, leaving only the XML tags: <navigator></navigator>
3. In your template add the following macro where you want to place the navigation: {ManilaExtras.siteMenu(startLevel : 2)}
   Note: startLevel:2 means that only items in the structure past level two (that of the language, here en, es or cn) will be rendered (see siteMenu Macro for more sophisticated choices)
4. Go back into manilaFixer and choose siteMenu setup. There are variants of the menu which will affect how the navigation is outputted. The simple menu will render something similar to what the sitePrefs-> navigation would have rendered
5. Create new stories by clicking on linguist then new nTuple or by clicking on create a new story as usual stories created within nTuple or frames/windows due to the linguistic plugIn will automatically be inserted in myManilaWebsite/admin/sitePrefs ->Site Structure
6. If the site structure is not as you wish it, you can edit the order in which items appear (Suggestion : copy the whole window and edit it in a text editor, saving a copy in case you mess things up)