-
Notifications
You must be signed in to change notification settings - Fork 26
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Documentation: convert G191E.docx to Latex/Markdown/...? #40
Comments
G.191 itself is an official publication of ITU, so we must use WinWord.
Fortunately, we only need to update its Annex A and only once a snapshot of the library is agreed by ITU-T SG12 to be included in a revised version of G.191 (official ITU release). We could have a version of Annex A produced and maintained in LaTeX or HTML that could then, when time comes, be converted to Word. HTML is fairly easy to convert; LaTeX, maybe if we still have a reliable LaTeX to RTF converter.
|
For the sake of completeness I think it would be nice to have the latest version of G.191 in the Git, as LaTeX or Markdown. Obviously, the official release will be at http://itu.int/ITU-T/G.191 in docx/pdf |
Well the easiest would be to save the DOCX as HTML, but it be marked as NOT the official version, to avoid confusion.
|
I found the DOC/DOCX policy always irritating and never fully understood the reason for sticking with them - but it is probably something not going to be changed quickly. So, we could also go for some document converters, such as Pandoc. |
Usage of docx/pdf has three drawbacks:
diff
does not work (only reports file has changed),I suggest converting it to
A) Latex (nicer PDF) or
B) Markdown (automatically available as HTML).
Integrating it into Doxygen might also be possible.
#2 and #9 are related.
The text was updated successfully, but these errors were encountered: