[Infrastructure] Experiment: Recompile using entirely Pandoc

Dimitris Zacharopoulos (HARICA) dzacharo at harica.gr
Tue Apr 9 09:06:55 MST 2019

Jos this is great work! I think you just completed a huge milestone!

If you can send me an example of similar outputs from the previous 
version of the BRs, I can try to create a red-line for both the word and 


On 9/4/2019 6:01 μ.μ., Jos Purvis (jopurvis) wrote:
> Great feedback! I had a little mini-hackathon the last couple nights, 
> and managed to untangle and clean up the formatting in sections like 
> 5.4.1 and the 7.2.x.x.x.x sections and added page numbers to the Word 
> doc. Results are attached. ☺
> -- 
> Jos Purvis (jopurvis at cisco.com)
> .:|:.:|:. cisco systems  | Cryptographic Services
> PGP: 0xFD802FEE07D19105  | +1 919.991.9114 (desk)
> *From: *"Dimitris Zacharopoulos (HARICA)" <dzacharo at harica.gr>
> *Date: *Monday, 8 April, 2019 at 02:56
> *To: *"Jos Purvis (jopurvis)" <jopurvis at cisco.com>, 
> "infrastructure at cabforum.org" <infrastructure at cabforum.org>
> *Subject: *Re: [Infrastructure] Experiment: Recompile using entirely 
> Pandoc
> Thanks Jos, this looks really promising!
> I noticed some issues with the numbering of different levels. For 
> example, take a look at section 5.4.1. Page numbers are also missing 
> from the docx version. We're getting close!
> Dimitris.
> On 7/4/2019 9:32 μ.μ., Jos Purvis (jopurvis) wrote:
>     It’s astonishing what you can get done when you’re avoiding other
>     work. ☺For fun[0], I decided to see how much would need to change
>     in the BRs to get Pandoc to produce a PDF from them, since it can
>     happily take the same source document and also produce DOCX, HTML,
>     and even ODT. Turns out, it wasn’t much:
>      1. I removed the funky Kramdown table header lines from the list
>         of ballots and the list of effective dates at the top of the
>         document.
>      2. I removed some zero-length Unicode space characters that had
>         crept into one of the 7.2.2.X.X.X sections.
>     That’s it. Really.
>     From there, I added a metadata file (“BR.yaml”) that contains some
>     document variables like the title and copyright info, and a
>     template LaTeX document with a nice-looking title page, since
>     that’s what Pandoc uses in the background to produce a PDF. Then I
>     converted the old title block for the document to a ‘Verso’ page
>     so there’s still a title at the top of the Markdown file. The
>     result is attached: I think it looks pretty close to what we were
>     looking for, including an automatically-generated table of
>     contents and a nice title page, and we can use the same toolset to
>     generate all of the output artifacts. From there, next steps would
>     be to generate a similarly nice-looking Word doc (Pandoc will take
>     an existing DOCX as a template and use its formatting styles) and
>     CSS for the other two formats.
>     Note that we don’t /need/ to go this route, but it’s cool to note
>     that a little tinkering with the Markdown generated something that
>     will produce all three outputs pretty easily. If you’re curious, I
>     forked the repo and the changes and artifact output are here:
>     https://github.com/castillar/documents
>     --Jos
>     [0] For interesting values of “fun” that include “avoiding
>     house-cleaning”.
>     -- 
>     Jos Purvis (jopurvis at cisco.com <mailto:jopurvis at cisco.com>)
>     .:|:.:|:. cisco systems  | Cryptographic Services
>     PGP: 0xFD802FEE07D19105  | +1 919.991.9114 (desk)
>     _______________________________________________
>     Infrastructure mailing list
>     Infrastructure at cabforum.org  <mailto:Infrastructure at cabforum.org>
>     http://cabforum.org/mailman/listinfo/infrastructure

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://cabforum.org/pipermail/infrastructure/attachments/20190409/6252ea8e/attachment.html>

More information about the Infrastructure mailing list