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

Create LaTeX version #8

Open
nlohmann opened this issue Jul 24, 2017 · 4 comments
Open

Create LaTeX version #8

nlohmann opened this issue Jul 24, 2017 · 4 comments

Comments

@nlohmann
Copy link
Owner

To submit the proposal, it has to be in [HTML or PDF format](https://isocpp.org/std/standing-documents/sd-7-mailing-procedures-and-how-to-write-papers. For the latter, the repository of the C++ standard draft can be used to take a lot of macros.

Personally (@nlohmann), I think we should only take the effort to switch to LaTeX once the proposal stabilizes, because it seems to be a lot of effort to understand all the (definitly useful) commands and environments used in the standard LaTeX template.

@mariokonrad
Copy link
Collaborator

The point in time to switch is for me personally not that important. Wait until stable (more or less) seems to be easier upfront, where switching now may save time later on...

Or switch to HTML instead of LaTeX, leaving out the intermediate step of generating a PDF? Although, the macros really seem useful.

I have no preference in both regards.

@mariokonrad
Copy link
Collaborator

Not sure if I overlooked it or it was added recently, but the allowed formats (now) are:

Documents must be in PDF, html, text (.txt), or Markdown (.md) format.

Markdown documents should follow the following rules:

  1. Files should be usable either in their original text form or as formatted by a Markdown processor, so make sure the text form is well formatted.
  2. The document should follow the Commonmark specification

Sooo... no need to convert anything!? We just rename (P-number) the document and make sure it adheres to Commonmark and be done with it.

Your thoughts on this?

@nlohmann
Copy link
Owner Author

The Commonmark specification does not allow tables at the moment. I am not sure if this is a strict prerequisite. However, tools like Pandoc or Github's own renderer allow to easily convert Markdown to HTML or other formats.

@nlohmann
Copy link
Owner Author

(That said, I think we should continue using Markdown at the moment.)

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

No branches or pull requests

2 participants