[Po4a-devel] po4a & Markdown

[Sergey Korobitsin]

Jonas Smedegaard ☫ → To Sergey Korobitsin @ Wed, Jan 28, 2015 09:42 +0100

> > A I see, non-sophisticated translator can omit the '=====' and '----' 
> > lines and leave only translated header itself, and at the output we'll 
> > get broken structure. Then, it can be workarounded by some kind of 
> > Translator's HOWTO, but people are people, and it would better if this 
> > case processes automatically.
> 
> I don't follow how current loose parsing leads to broken structure - 
> i.e. how it is an actual (not just an academic) problem.  Can you 
> elaborate on that - perhaps give an example of how it can break (even 
> if, as you already wrote, the breakage is minor)?

See, I have a Markdown document started as follows:

Область применения документа
============================

Данный документ является руководством для администраторов платформы
«ARTA SYNERGY» (далее Система), предназначенной для совместной работы на
предприятиях и управления по целям. Здесь описываются процессы,
связанные с выполнением задач администрирования Системы.

Then, when I apply po4a, I get following content at PO file:

#. type: Plain text
#: admin-manual.md:54
#, fuzzy, no-wrap
#| msgid "Область применения документа"
msgid ""
"Область применения документа\n"
"============================\n"
msgstr "Scope of document"

And then, what will do some forgetful translator - just remove the 
"fuzzy" mark. If so, I'll get the following in output document:

Scope of document
The document is guide for Administrators of the  ARTA SYNERGY platform
(hereinafter referred to as the System) designed for groupwork on
enterprises and target-oriented management. It describes processes
connected
to execution of the System administration tasks.

And, bingo! I've got broken stucture of document.

This problem not about bugs, but about usability, and its minor.
Maybe I've got some professional deformation, because my scope of work
for now is usability :-)

--