Italian Translation

Discussions about the wiki documentation of FreeCAD and its translation.
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Italian Translation

Postby maegras » Thu Nov 18, 2010 12:33 pm

Hi everyone, I would like to start a freeCAD Italian translation, especially in Wiki and Man.

MR
User avatar
yorik
Site Admin
Posts: 12032
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels, Belgium
Contact:

Re: Italian Translation

Postby yorik » Thu Nov 18, 2010 3:02 pm

Hi MR,
Great! Welcome on board. I just gave you edit rights on the wiki.

To translate the wiki, the fist thing to do is to visit this page:
http://sourceforge.net/apps/mediawiki/f ... e_Help_Toc
and create this one:
https://sourceforge.net/apps/mediawiki/ ... elp_Toc/it
Then copy all the contents of the english one inside and start translating (see other translations as an example on how they did it)

The rule is simple: For each SomeEnglishTitle page you create a corresponding SomeEnglishTitle/it page (I know it would be better to translate SomeEnglishTitle to italian, but the reason to do like this is that in the future any freecad admin must be able to understand what the page is about if no italian translator is there).

I will then add your italian table of contents to the main page (How do you say/write "table of contents" in italian, by the way?)
I'll also create a couple of templates (you will see how to use them as you go. You will also need to take care of adding a link to your translated pages to the main english page, so readers know an italian translation is available. But I'll explain you further on.

Any question, feel free to come back here
Cheers & thanks
Yorik
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Re: Italian Translation

Postby maegras » Thu Nov 18, 2010 9:40 pm

yorikvanhavre wrote: "table of contents"
Translation is Indice dei contenuti
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Re: Italian Translation

Postby maegras » Fri Nov 19, 2010 9:01 am

yorikvanhavre wrote:Hi MR,
To translate the wiki, the fist thing to do is to visit this page:
http://sourceforge.net/apps/mediawiki/f ... e_Help_Toc
and create this one:
https://sourceforge.net/apps/mediawiki/ ... elp_Toc/it
Then copy all the contents of the english one inside and start translating (see other translations as an example on how they did it)
Done.. tell me more about IT template
User avatar
yorik
Site Admin
Posts: 12032
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels, Belgium
Contact:

Re: Italian Translation

Postby yorik » Fri Nov 19, 2010 1:18 pm

Ok then:

- First, look at the https://sourceforge.net/apps/mediawiki/ ... elp_Toc/it page.

I did some edits to it, basically make sure all links point to an /it page. This is also handy, because they turn red, so readers know what has already been translated and what not. Wiki links can be written like this: [[WikiPageName]] or [[WikiPageName|TranslatedPageName]]. So you can always use the latter form to make the links appear translated.

Other thing I did is to add {{en|Online Help Toc}} in the {{Language/it}} template at the bottom of the page. On each italian page you make, you insert that link to the original english page, so readers have a direct link back to the original page.

Similarily, you add {{it|Online Help Toc/it}} inside the {{Language}} template on the original english page. I already did it for this one here: https://sourceforge.net/apps/mediawiki/ ... e_Help_Toc

So, to resume, when you translate a new page you do the following steps:

1) copy/past the contents of the english page
2) change {{Language}} by {{Language/it}}
3) change {{docnav}} by {{docnav/it}}
4) change all other [[Link]] to [[Link/it]] or [[Link/it|Translation]]
5) add {{en|CurrentPageName}} to your italian page inside the {{Language/it}} template
6) add {{it|CurrentPageName/it}} to the english page inside the {{Language}} template

That's it!

Now can you also edit those 2 templates and translate the text inside?
https://sourceforge.net/apps/mediawiki/ ... nguages/it (Available translations)
https://sourceforge.net/apps/mediawiki/ ... :Docnav/it (previous, next & Index)

I think this should get yo ugoing, if something is unclear tell me!
Cheers
Yorik
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Re: Italian Translation

Postby maegras » Fri Nov 19, 2010 1:49 pm

when I have, on page footer

Code: Select all

{{docnav|Online Help Toc|About FreeCAD}}
Is possible to translate, for instance, Online Help Toc, make it pointing to the correct italian page, instead typing Online Help Toc/it?
User avatar
yorik
Site Admin
Posts: 12032
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels, Belgium
Contact:

Re: Italian Translation

Postby yorik » Fri Nov 19, 2010 2:41 pm

Yes sure, when on the english page it is: {{docnav|Online Help Toc|About FreeCAD}}
On your translation you'll use: {{docnav/it|Online Help Toc/it|About FreeCAD/it}}
So the whole italian manual can be browsed coherently without going back to english.
I just setup those 2 templates for you to use in your pages (instead of docnav and languages), docnav/it and Languages/it
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Re: Italian Translation

Postby maegras » Fri Nov 19, 2010 9:51 pm

yorikvanhavre wrote:Yes sure, when on the english page it is: {{docnav|Online Help Toc|About FreeCAD}}
On your translation you'll use: {{docnav/it|Online Help Toc/it|About FreeCAD/it}}
So the whole italian manual can be browsed coherently without going back to english.
I just setup those 2 templates for you to use in your pages (instead of docnav and languages), docnav/it and Languages/it
This is not what i meant

Is possible to use something like:

{{docnav/it| [[Online Help Toc/it | Help on-line]] | [[About FreeCAD/it | Informazioni su FreeCAD]] }}
{{docnav/it| [[Original translated link | Translated string that describes the link]] | [[same as previous | same as previous]] }}

???
User avatar
yorik
Site Admin
Posts: 12032
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels, Belgium
Contact:

Re: Italian Translation

Postby yorik » Fri Nov 19, 2010 10:33 pm

Hm no, but it's a very good idea, let's try.
I changed the template, now you must pass it the complete link, like this:
{{docnav/it| [[Online Help Toc/it | Help on-line]] | [[About FreeCAD/it | Informazioni su FreeCAD]] }}
User avatar
maegras
Posts: 16
Joined: Thu Nov 18, 2010 12:27 pm
Location: Tivoli - Roma [IT]

Re: Italian Translation

Postby maegras » Mon May 30, 2011 9:09 pm

Hi everyone.. :)

After a stand-by period, due to my graduation, I'm finally back and I bring with me a question for admins:

Can I use a page of the wiki in order to coordinate the Italian translation if someone else will join the It team?