Skip to content
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

Open
dennisguse opened this issue Apr 5, 2017 · 4 comments
Open

Documentation: convert G191E.docx to Latex/Markdown/...? #40

dennisguse opened this issue Apr 5, 2017 · 4 comments

Comments

@dennisguse
Copy link
Member

Usage of docx/pdf has three drawbacks:

  1. files are binary and thus diff does not work (only reports file has changed),
  2. some people might not have the correct version of Microsoft Office at hand, and
  3. it is not readable from the command line (at least not as easy as a text file).

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.

@simaocampos
Copy link
Member

simaocampos commented Apr 5, 2017 via email

@maadolph
Copy link
Member

maadolph commented Apr 6, 2017

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

@simaocampos
Copy link
Member

simaocampos commented Apr 6, 2017 via email

@dennisguse
Copy link
Member Author

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.
It can convert Markdown to DOCX, but we would need to check how to apply formatting correctly.
I use Pandoc regularly to convert Markdown to HTML+CSS as a replacement for Word...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants