Allegedly, on or about 4 April 2018, Sam Varshavchik sent:
> I find Docbook XML to be irreplacable, when it comes to writing
> technical documentation that serves as a single source of both manual
> pages and publishable HTML.
I'm pretty sure I've looked at Docbook, though could have been another
thing. But what I found when using *some* form of intermediate
language, that the conversions to other forms were not optimal.
I might write a page with headings and subheadings, properly in
sequence, and text between.
Like:
<h1 id="pancakes">Pancakes</h1>
<div>
<h2 id="ingredients">Ingredients</h2>
<ul>
<li>Flour</li>
<li>Milk</li>
<li>etc...</li>
</ul>
</div>
<div>
<h2 id="method">Method</h2>
And so on, and so forth...
Only to find out the translation has lost the context, converting plain
headings into stylised generic headings all of the same hierarchy. Or
that straight-forward attributes (name="something") get butchered into
garbage (name="g12").
Or that your two languages have no overlap in being able to do the same
thing, albeit using different methods, and content gets butchered into
inappropriate simulations of what you were trying to do.
--
[tim@localhost ~]$ uname -rsvp
Linux 4.15.10-200.fc26.x86_64 #1 SMP Thu Mar 15 17:14:41 UTC 2018 x86_64
Boilerplate: All mail to my mailbox is automatically deleted.
There is no point trying to privately email me, I only get to see
the messages posted to the mailing list.
Linux cures Windows pains.
_______________________________________________
users mailing list -- users@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to users-leave@xxxxxxxxxxxxxxxxxxxxxxx
