HowToWriteOnMultilingualPages

MultilingualExperiment

[ar]تجربة متعدّدة اللّغات
[da]Multisprogs experiment
[de]Mehrsprachiges Experiment
[eo]Multlingva eksperimento
[en]Multilingual experiment
[fr]Expérience multilingue
[it]Esperimento multilingue

HowToWriteOnMultilingualPages

[ar]كيف تكتب على صفحات متعدّدة اللّغات
[da]°°°
[de]Wie man auf einer mehrsprachigen Seite schreibt
[eo]Kiel skribi sur multlingva paĝo
[en]How to write on multilingual pages
[fr]Comment écrire sur des pages multilingues
[it]Come si scrive sulle pagine multilingue

[ar]لغة العمل: en
[da]°°°: en
[de]Arbeitssprache: en
[eo]Laborlingvo: en (bedaŭrinde)
[en]working-language: en
[fr]Langue de travail: en
[it]°°°: en<br


[en]On this page we collect recommendation on how to write on multilingual pages. It also deals with the question on what could be improved on both the actual writing and the software that computes and displays this writing in order to make multilingual support work best.
[eo]Sur ĉi paĝo ni kolektas kelkajn rekomendojn pri la maniero skribi sur multlingvaj paĝoj. Tio ankaŭ ebligas trakti la demandon pri planendaj plibonigoj je la nivelo kaj de “reala verkado” kaj de “progamita skribado” kiu kalkulas kaj elmontras tiun “realan verkadon” por ke plej bone funkciu la multlingva eltenilo.
[fr]Sur cette page nous rassemblons quelques recommandations sur la manière d’écrire sur des pages multilingues. Cela permet de traiter également la question des améliorations à envisager tant au niveau de l’“écriture réelle” qu’au niveau de l’ “écriture logicielle” qui calcule et affiche cette “écriture réelle” pour que fonctionne au mieux le support multilingue.
[it]In questa pagina ci sono dei consigli - da tenere aggiornati - sul come si scrive sulle pagine multilingue. La pagina serve anche ad affrontare la questione di come si potrebbe migliorare sia il modo di scrivere testi multilingue, sia il software che elabora e presenta ciò che viene scritto, per far funzionare il supporto multilingue nel migliore dei modi.

[en]The goal is to make a multilingual page show up most readable and complete but without any unwanted text displayed - no matter which combination of language filters settings you chose.
[eo]La celo estas elmontri kiel eble plej legeblan kaj plej kompletan multlingvan paĝon ebligante neelmontro de nedezirataj tekstoj - kiu ajn estu la kombino da lingvaj filtriloj kiujn vi elektas.
[fr]L’objectif est de produire un affichage de page multilingue le plus lisible et le plus complet et permettant d’éviter l’affichage de textes non désirés - peu importe la combinaison des filtres de langues que vous choisissez.

[en]Paragraphs & line-shifts
[eo]Paragrafoj kaj linisaltoj
[fr]Paragraphes & sauts de ligne

[en]For now it seems best to do translations paragraph-wise. You seperate the different translations of a pararaph with a lineshift < br > (without spaces). Done like that a paragraph - which is a subunit of a contents (in the line: letter, word, sentence, paragraph, …, page) - always remains tied together, even if translated to different languages.
[eo]Nuntempe plej bone estas tradukadi poparagrafe. Disdividu la diversajn tradukojn per linisalto < br > (sen la spacoj). Redaktu popargrafe - kiu estas dividoj de enteno (litero, vorto, frazo, paragrafo,… , paĝo) - kiu plu ligiĝas inter si eĉ se ili estas tradukitaj al pluraj lingvoj.
[fr]A cette heure ce qui semble le mieux est d’effectuer les traductions sous formes de paragraphes. Vous séparez les différentes traductions par un paragraphe avec un saut de ligne < br > (sans espaces). Faites une construction en paragraphes - qui sont des sous-unités d’un contenu (lettre, mot, phrase, paragraphe,… , page) - qui restent toujours liés etre eux, même s’ils sont traduits en différentes langues.

[ar]فقرة 1
[de]Absatz 1
[en]Paragraph 1
[eo]Paragrafo 1
[fr]Paragraphe 1

[ar]فقرة 2
[de]Absatz 2
[en]Paragraph 2
[eo]Paragrafo 2
[fr]Paragraphe 2

[ar]أفكار
[en]Thoughts
[en]Ideoj
[fr]Idées

[en]This is optimal for reading when you display your language only but also when you enable two or more languages, like when you check translations or when you want to read and learn an additional language.
[eo]Tio plifaciligas la legadon kiam vi elmontras nur vian propran lingvon sed ankaŭ kiam vi ebligas du aŭ plurajn lingvojn, kiel ekzemple kiam vi deziras kontroli tradukon aŭ kiam vi deziras legi kaj lerni alian lingvon.
[fr]Ceci optimise la lecture quand vous affichez seulement votre langue mais aussi quand vous autorisez deux ou bien plusieurs autres langues, comme par exemple lorsque vous voulez vérifiez des traductions ou bien quand vous voulez lire et apprendre une autre langue.

[en]The optimum when translating text (that’s in edit mode) wouldn’t be to have the contents displayed paragraph by paragraph but sentence by sentence. This means stepping backwards one step on the mentioned line (letter, word, sentence, paragraph, …)
[eo]Plej bone estus dum tradukado havi entenon elmontritan frazon post frazo. Unu retropaŝo kompare kun kio estas ĵus dirita.
[fr]L’idéal au moment de traduire le texte (ce qui se pratique en mode édition) serait d’avoir les contenus affichés phrase par phrase au lieu de paragraphe par paragraphe. Cela signifie de faire un pas en arrière par rapport à ce qui écrit précédement (lettre, mot, phrase, paragraphe,…).

[en]The reading mode already works fine - of course it is still a lot of work to prepare the text. Mistakes on the formatting easily occur and often remain uncorrected. You should check that a multilingual page works correctly with different filter settings. Change the formatting if something doesn’t work. We are just approaching a good way of formatting a multilingual page, we do not really know it yet. This is a process of both, to learn how to do it right and to improve the software according to our needs.
[eo]La legmodo jam bone funkcias - kompreneble por pretigi la tekston restas ankoraŭ multe da laboro. Enpaĝigaj eraroj facile okazas kaj ofte restas nekorektitaj. Vi devus kontroli ke multlingva paĝo bone funkcias kun malsamaj filtrilokombinoj. Ŝanĝi la formon se io ne taŭgas. Ni eble proksimiĝas de bona enpaĝiga metodo por multlingva paĝo, sed ni ne jam scias ĝin. Tio estas kaj lernoproceso “kiel bone fari” kaj de programplibonigo laŭgrade de la renkontitaj bezonoj.
[fr]Le mode lecture fonctionne déjà bien - bien sûr pour préparer le texte il reste encore beaucoup de travail . Des erreurs de mise en page arrivent facilement et restent souvent non corrigées. Vous devriez vérifier qu’une page multilingue fonctionne correctement avec différentes combinaisons de filtres de langues. Modifier le formatage si quelque chose ne fonctionne pas. Nous sommes peut-être proches d’une bonne méthode de mise en page d’“une page multilingue”, nous ne le savons pas vraiment encore. Ceci est un processus à la fois d’apprentissage de “comment faire correctement” et d’amélioration du logiciel au ryhme des besoins rencontrés.

[en]Sequence of languages
[eo]Lingvoordo
[fr]Ordre des langues

[en]We recommend to make the sequence of different languages within a paragraph simply alphabetical (language code). Albanian (al) first, Zulu (zu) last and no waste of time on a discussion of what language is more common or what language the page first was written in or whatever. We have the filters anyway. Use them.
[eo]Ni rekomendas simple respekti la alfabetan ordon de la diversaj lingvokodoj ene de paragrafo. Albana (al) unue, le Zulua (zu) laste kaj neniu tempoperdo por diskuti kiu estas la plej komuna lingvo aŭ en kiu lingvo la paragrafo estis unue verkita aŭ kio ajn alia. Ja estas filtriloj : bonvolu uzi ilin.
[fr]Nous recommandons de respecter simplement l’ordre alphabétique des codes des différentes langues à l’intérieur d’un paragraphe. L’Albanais (al) en premier, le Zoulou (zu) en dernier et pas de perte de temps en discussion pour savoir quelle langue est la plus commune ou dans quelle langue la page a d’abord été écrite ou tout ce que vous voudrez. Bref il y a des filtres. Utilisez-les.

[en]Language markup
[eo]Lingvaj markoj
[fr]Les Balises de Langues

[en]As long as a sub-paragraph (ending with a line-shift < br > ) is not marked up for a language by putting the language tag [??] at it’s beginning, it is always displayed on the page - no matter what filter combinations you choose. New text, when first being written - no matter in what language - should not be marked up. Why?
[eo]Tiomlonge kiam subparagrafo (finante per < br > ) ne estas markita por lingvo lokante lingvan markilon en ties komenco, ĝi daŭre estas elmontrita sur la paĝo - kiu ajn estas la filtrilokombinoj kiujn vi elektas. La nova teksto, kiam ĝi estas verkita unuafoje - en kiu ajn lingvo - ne devus esti markita. Kial ?
[fr]Tant que le sous-paragraphe (se terminant avec un saut de ligne < br > ) n’est pas marqué pour une langue en plaçant la balise langue à sont début, il est toujours affiché sur la page - quelles que soient les combinaisons des filtres langues que vous choisissez. Le nouveau texte, quand il est écrit pour la première fois - peu importe en quelle langue - ne devrait pas être marqué. Pourquoi ?

[en]Let’s say a page starts in English and soon parts of it get translated to French. Only translated paragraphs are marked up.
[eo]Ni diru ke iu paĝo ekas nur anglalingve kaj ke poste iuj partoj estas tradukitaj al la franca.nur la tradukitaj pargrafoj ricevas markojn.
[fr]Disons qu’une page démarre en anglais et puis ensuite des sections de celle-ci sont traduites en français. Seuls les paragraphes traduits sont balisés.

[en]It now looks like that:
[eo]Tio nun aspektas tiel:
[fr]Cela ressemble à cela désormais :

[ar]فقرة 1
[en]paragraph 1
[eo]paragrafo 1
[fr]paragraphe 1

paragraph 2 (untranslated/[fr]non traduit)

A Frenchspeaker reads the page with his filters set to “show French only”.
[eo]Franclingva uzulo legas la paĝon kun filtriloj por montri “nur la francan”. [fr]Un contributeur francophone lit la page avec ses filtres réglés pour “ne montrer que le français”

He sees:
[eo]tiu vidas :
[fr]Il voit :

[eo]paragrafo 1
[fr]paragraph 1

paragraph 2 (which is in english/[fr]qui est en anglais)

He does not translate but writes a third paragraph in French. An Englishspeaker with his filters set to “English only” reads the page. He sees:
[fr]Il ne traduit pas mais écrit un troisième paragraphe en français. Un contributeur anglais avec ses filtres réglés sur “English only” lit la page. Il voit :

[en]paragraph 1

paragraph 2

paragraphe 3 (which is in french/[fr]qui est en français)

The problem is text marked up is not shown for somebody looking at it with another language activates as “show only”

[en]paragraph
[fr]paragraphe

looked at with filtersettings “Italian only” is nothing, invisible, nil. There fore you have to put the text as untagged before the translations.

parapraph
[en]paragraph
[fr]paragraphe

Now an “Italian only” viewed page shows something, the reader sees

paragraph

and knows, there is untranslated contents. This has to be done as long as a paragraph is not translated to all languages - which means kind of for ever if you want to be fair to all languages, and we want that here. I means the annoyance of always having the text displayed in the “working language” (which often will be english but it can as well be any other language). Maybe a filter for untagged text would help, or a tag for working language? Dunno.

Better:
Somewhere the Working language of a page gets defined. This is done when a page is created. Let’s say it’s English. When writing, all your text, every paragraph has to be language tagged (which later anyhow will get automatized, so it’s just a temporary problem).

There is a new box with the language filters. “Show working language [ en]”. It is activated by default and can be deactivated. You leave it activated for now.

Your other filter settings are “show all languages” (that is no crosses in the boxes - nothing gets filtered out).

You write and you translate this.

[en]hello world
[eo]Saluton mondo !
[fr]Bonjour tout le monde

You save and you see this:

hello world
[fr]hallo monde

English is shown untagged as it is the predefined Working language.

filtering see english only you read

hello world

untagged as (en)=Working language and as the “show working language” box is activated.

filtering see french only you read:

hello world
[fr]hallo monde

the working language is activated, you see it.

filtering see italian only you read:

hello world

now you deactivate “show working language”.

the Italian only filtered page shows no text now.

In “English only” it looks like this now

[en]hello world

It’s tagged, … surprise, surprise.

“French only” reads

[fr]hallo monde

no working language as filtered.

[en]Probably a show working language only box. But I dunno. The only advantages compared to “english only” would be to have no tags and backgroundcolors displayed at the moment. This might change.

[en]Required:

  • [en]All text must be language tagged.
  • [en]A working language for a page is chosen and agreed on.

[en]Advantage: Fair working conditions woldwide for all languages as you can freely define the working language.

[en]What happens when it’s changed on a page btw?

[en]Recommendations:

[en]Only use editable titles in the multilingual experiment which is a [[CommunityWiki:Cluster] cluster] of pages. Do never use camel-case titles in it. A page gets linked using an editable title only when mentioned for the first time within a paragraph. “Editable title” for example is linked already in the beginning of this paragraph.

[en]Always language-tag text. There should be no untagged text in the experiment.

[en]Write paragraph by paragraph. Tie translations within a paragraphe with lineshifts < br >.

[en]Order the languages within a paragraph alphabetically.

[en]Multilingual pages have a header that ends with a line (—-) Currently the camel-case link MultilingualExperiment is in the first line of every page of this [[[Cluster|cluster]. This actually defines it as a cluster. Next in the header is the multilingual translation to MultilingualExperiment. Then the camel-case title of the page follows. Then the editable title of the page in its multilingual translations follows (as long as it has not been changed this will be the multilingual translations of the camel-case title. We will later not even look at the camel-case title as you do not see it anywhere - unless you go really deep in it - and its use will be completely automated). Next is the working language the participants contibuting to the page have agreed on. Se the header of this page here.

EditNearLinks: CamelCase

Languages: