- Decide what subdivision are going to be used to present your content, it's best to adjust these subdivisions so visitors can find what they are looking for as fast as possible! Incidentally search engines will find it easier too, and they like it.
- Find for each language and subject the most pertinent sentences, one menu title associated with a page equal a single unique sentence.
- Write into your best word processor the complete structure of your Website, describing the structure menus/pages and the relation they have between each others with tabulated indentations (only tabs are accepted by the site builder.
- Copy the complete structure inside the installer area box "Menus / Pages definition and hierarchy" and select the other parameters according to your needs,
- The indentations (only tabulations) specify the hierarchy of the menus, almost like they would be seen on the web site itself and for each interdependent languages! When building the frame of a site like that the same structure of pages most be specified for each languages because it's the only way the parser can apparent pages across languages. Once the site frame is built it's possible to have pages that appear inside a single language without having to deal with pages we don't have time to translate.
- [addLgContent .../] adds a block of Xpetal language to deal with a complex problem, for example to define a contact form with captcha in the correct language (for now only English and French and for other languages English is imposed when generating the page, but the language can naturally be adapted later when editing the site.)
- [diffPgName ... /] specify a different page name and built a table allowing a direct display of the original characters inside the Url (minimum of restriction). Note that we must be careful with this option because some actor of the Web may not be capable of dealing correctly with full blown utf-8 urls, starting with web site that would like to do a back link but can't because they do not have pages in utf-8
- Data encapsulation is done with double quotes : "some data" like it can be done inside inside each pages using the standard editor. The same syntax is also going to be used with forums (though with a restricted number of tags), making it easier when going from an environment to the other.
- ◯ : language block separator, it can be any UTF-8 character specified explicitly (see the installation form during the installation process) and it should not appear inside the language paragraphs.
Below are the specification in "expert" mode with a hybrid Xpetal code to generate in one go a three languages site structure (in this case a CV) with menus (mainly links and labels) pointing on the relevant pages with global language adaptation as much as possible.
Please note that in this example the concerned urls (menu links) are finely tuned to the original language, in English it stay the same, in French it loose its accents (because it does not hurt the indexation) and in Chinese the original characters are kept, the advantage of doing that for Chinese is still to be proved, because the supplementary url information may be undermined by the inability of some spider to index it, an open question that improving with time considering the wide acceptation of UTF-8 on Internet.
Introduction and CV
Training
Experience [addLgContent id="xCodeCVip" /]
To print
Motivations
Business
Generalities
Other Points
Personality
Hobbies
Contact [addLgContent id="xCodeFormalWebMail" /]
◯
Présentation et CV
Formation
Expérience [addLgContent id="xCodeCVip" /]
A imprimer
Motivations
Professionnelle
Générale
Autres Points forts
Personnalité
Passions
Contact [addLgContent id="xCodeFormalWebMail" /]
◯
介紹和簡歷 [diffPgNameMdlLg lg="en" /]
訓練
經驗 [addLgContent id="xCodeCVip" /]
打印
動機
業務]
泛泛而談
其他點
個性
愛好
聯繫 [addLgContent id="xCodeFormalWebMail" /]
Syntax explanation of the above paragraphs : we have a hybrid language based on Xpetal and a direct interpretation of indented texts (strict use of tabulations), each label being associated with a menu and a unique matching page.