Are there best practices for setting up Oxygen projects in languages other than English?
Post here questions and problems related to editing and publishing DITA content.
Are there best practices for setting up Oxygen projects in languages other than English?
Hi all,
I was wondering if there are best practices you could point me to regarding the setup of content that is not maintained in English. Up to now, my content was in English. We now got a second product line for which the content is maintained in German, with the option to later translate it into English and French.
My Oxygen project setup follows the recommendations from this post (https://ivannovation.com/blog/how-to-tr ... -projects/). I also had a look a the add-ons that Oxygen supports here, but my process is not at this step yet.
My main question is regarding the file names and the output in HTML. I still use English names, as our whole SVN structure (which my content is a part of) is using English names. If I now add the de_DE locale to each file name and use a publishing template to publish to HTML, the links will have the de_DE extension. Is it supposed to work like that so that a Browser can detect the language and choose the correct file if we deliver several languages?
Am I overlooking something?
Any hints are welcome. Thanks and best regards, Tanja
I was wondering if there are best practices you could point me to regarding the setup of content that is not maintained in English. Up to now, my content was in English. We now got a second product line for which the content is maintained in German, with the option to later translate it into English and French.
My Oxygen project setup follows the recommendations from this post (https://ivannovation.com/blog/how-to-tr ... -projects/). I also had a look a the add-ons that Oxygen supports here, but my process is not at this step yet.
My main question is regarding the file names and the output in HTML. I still use English names, as our whole SVN structure (which my content is a part of) is using English names. If I now add the de_DE locale to each file name and use a publishing template to publish to HTML, the links will have the de_DE extension. Is it supposed to work like that so that a Browser can detect the language and choose the correct file if we deliver several languages?
Am I overlooking something?
Any hints are welcome. Thanks and best regards, Tanja
-
- Posts: 968
- Joined: Wed Nov 16, 2005 11:11 am
Re: Are there best practices for setting up Oxygen projects in languages other than English?
Post by alex_jitianu »
Hello ,
From what I know, translators are not interested in the names of the files nor do they change it, these are normally left unaffected. I am also unaware of a browser feature that would automatically detect language codes. A translation workflow based on Fluenta works with a project structure similar with the one described in the post you've followed. Basically, in the root folder you place content for each language in separated folders (en-US, de-DE etc). In the en-US you have the DITA source documents on which you work. When you are ready to translate to German, for example, you generate an XLIFF file from the en-US content, send it to translation and when it comes back you generate from it the German content inside the de-DE folder.
Once you have the content in multiple languages, you will publish them all on your website and it's up to the user to select one language or another. Of course, you could add code that detects the user locale and redirect him to a specific language HTML.
We will soon release a DITA translation add-on based on Fluenta. I will post here the details on how to install it, in case you want to give it a try.
Best regards,
Alex
From what I know, translators are not interested in the names of the files nor do they change it, these are normally left unaffected. I am also unaware of a browser feature that would automatically detect language codes. A translation workflow based on Fluenta works with a project structure similar with the one described in the post you've followed. Basically, in the root folder you place content for each language in separated folders (en-US, de-DE etc). In the en-US you have the DITA source documents on which you work. When you are ready to translate to German, for example, you generate an XLIFF file from the en-US content, send it to translation and when it comes back you generate from it the German content inside the de-DE folder.
Once you have the content in multiple languages, you will publish them all on your website and it's up to the user to select one language or another. Of course, you could add code that detects the user locale and redirect him to a specific language HTML.
We will soon release a DITA translation add-on based on Fluenta. I will post here the details on how to install it, in case you want to give it a try.
Best regards,
Alex
Re: Are there best practices for setting up Oxygen projects in languages other than English?
Hello Alex,
I will look at the Fluenta content you provided - thanks for sharing. I am relieved that my initial setup seems to be okay so far.
It would be great if you could post details on Fluenta when the add-on becomes available. I am looking forward to trying it out.
Thanks and best regards,
Tanja
I will look at the Fluenta content you provided - thanks for sharing. I am relieved that my initial setup seems to be okay so far.
It would be great if you could post details on Fluenta when the add-on becomes available. I am looking forward to trying it out.
Thanks and best regards,
Tanja
-
- Posts: 968
- Joined: Wed Nov 16, 2005 11:11 am
Re: Are there best practices for setting up Oxygen projects in languages other than English?
Post by alex_jitianu »
Hi,
We have released the Fluenta DITA Translation add-on which can be installed from Help->Install new add-ons.... Please give it a try and let us know your thoughts.
Best regards,
Alex Jitianu
We have released the Fluenta DITA Translation add-on which can be installed from Help->Install new add-ons.... Please give it a try and let us know your thoughts.
Best regards,
Alex Jitianu
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service