How to translate an AsciiDoc (adoc) file?
Thread poster: Tobi
Tobi
Tobi
Local time: 03:47
English to German
+ ...
Jan 24, 2017

One of my clients plans to write a new documentation in AsciiDoc, a markup language similar to Markdown or Wikitext, but a bit more versatile. Studio 2017 has no native support so far. Does anyone have some experience with translating AsciiDoc files?
Thank you in advance!


 
Ruth Wiedekind
Ruth Wiedekind  Identity Verified
Germany
Local time: 03:47
Spanish to German
+ ...
Translate as HTML? Jan 25, 2017

Translate it after conversion?

AsciiDoc ist eine vereinfachte Auszeichnungssprache, die dazu dient, Texte in verschiedenen Dokumentenformaten zu veröffentlichen. AsciiDoc-Dateien können entweder nach HTML oder ins DocBook-Format konvertiert werden – und von dort dann ggf. weiter in viele andere Formate, z. B. PDF oder Manpage. Das Konvertierprogramm asciidoc ist in Python geschrieben und steht unter der freien GNU General Public
... See more
Translate it after conversion?

AsciiDoc ist eine vereinfachte Auszeichnungssprache, die dazu dient, Texte in verschiedenen Dokumentenformaten zu veröffentlichen. AsciiDoc-Dateien können entweder nach HTML oder ins DocBook-Format konvertiert werden – und von dort dann ggf. weiter in viele andere Formate, z. B. PDF oder Manpage. Das Konvertierprogramm asciidoc ist in Python geschrieben und steht unter der freien GNU General Public License (GPL).
https://de.wikipedia.org/wiki/AsciiDoc
Collapse


 
Tobi
Tobi
Local time: 03:47
English to German
+ ...
TOPIC STARTER
Only a workaround Jan 25, 2017

Thanks, Ruth, but this is only a workaround. It would be much better in the sense of single-source publishing to translate the source that is in AsciiDoc.
In this case in addition, the source files will be placed in a repository from which the HTML content will be created automatically. Therefore, it will be very cumbersome to grab all HTML pages, translate them and upload them again.
I really wonder why markup languages are not supported by Studio. The largest projects are documente
... See more
Thanks, Ruth, but this is only a workaround. It would be much better in the sense of single-source publishing to translate the source that is in AsciiDoc.
In this case in addition, the source files will be placed in a repository from which the HTML content will be created automatically. Therefore, it will be very cumbersome to grab all HTML pages, translate them and upload them again.
I really wonder why markup languages are not supported by Studio. The largest projects are documented using markup languages.
Collapse


 
Tobi
Tobi
Local time: 03:47
English to German
+ ...
TOPIC STARTER
Is the use of markup languages really so limited? Apr 13, 2017

Still nobody around who has experience with translating documents in a markup language format?

 
Dan Lucas
Dan Lucas  Identity Verified
United Kingdom
Local time: 02:47
Member (2014)
Japanese to English
Yup Apr 14, 2017

Markup languages (I mean the ones like Markdown rather than the commonly used ones like HTML) may be used in certain fairly limited applications, such as website forums and app documentation, but how often do such documents get translated? And from the perspective of a CAT tool supplier, which one of the many dialects should be supported? It might be difficult for them to make the case for investing in support for something like this.

Dan


 


To report site rules violations or get help, contact a site moderator:


You can also contact site staff by submitting a support request »

How to translate an AsciiDoc (adoc) file?







TM-Town
Manage your TMs and Terms ... and boost your translation business

Are you ready for something fresh in the industry? TM-Town is a unique new site for you -- the freelance translator -- to store, manage and share translation memories (TMs) and glossaries...and potentially meet new clients on the basis of your prior work.

More info »
Wordfast Pro
Translation Memory Software for Any Platform

Exclusive discount for ProZ.com users! Save over 13% when purchasing Wordfast Pro through ProZ.com. Wordfast is the world's #1 provider of platform-independent Translation Memory software. Consistently ranked the most user-friendly and highest value

Buy now! »