4 ms·

Tangential: Does anyone know how to generate HTML docs such as this? It looks like a page in a book - with a header/footer and page number. And, surprisingly no

Tangential: Does anyone know how to generate HTML docs such as this? It looks like a page in a book - with a header/footer and page number. And, surprisingly no one in 1991 imaged we would be reading it on a 4k widescreen - and here I am, and it is extremely readable (using SF Mono on macOS). I would love to know what tools can be used to generate almost paper-like HTML docs. Edit: I found the answer, tiny link at the bottom: https://tools.ietf.org/tools/rfcmarkup/ https://tools.ietf.org/tools/rfcmarkup/

andrewzah 7y ago
You could also achieve this with LaTeX and pandoc.
- systemvoltage 7y ago
  With similar formatting and index?
  - pan69 7y ago
    Yes. This book uses pandoc: https://github.com/jagregory/abrash-black-book https://github.com/jagregory/abrash-black-book This is the HTML output: http://www.jagregory.com/abrash-black-book/ http://www.jagregory.com/abrash-black-book/
lozf 7y ago
> Edit: I found the answer, tiny link at the bottom: https://tools.ietf.org/tools/rfcmarkup/ https://tools.ietf.org/tools/rfcmarkup/ If you read the link, that just adds the HTML markup to plain text ASCII RFCs (which were deprecated in favour of XML, back in 2013 as per RFC 7994.) RFC 7990 has more details on the format framework. But for actual guidance on the tools used, you probably want to peruse the "Prepare documents" section of the IETF's tools[0] page, or those at rfc-editor.org[1]. [0]: http://tools.ietf.org/ http://tools.ietf.org/ [1]: https://www.rfc-editor.org/pubprocess/tools/ https://www.rfc-editor.org/pubprocess/tools/ XML, markdown, asciidoc, Bibtex, nroff, and even Word are covered.
ducktective 7y ago
How about a version-controllable markdown diagram generator? https://mermaid-js.github.io/mermaid/ https://mermaid-js.github.io/mermaid/
yjftsjthsd-h 7y ago
pr(1) can do it - https://linux.die.net/man/1/pr https://linux.die.net/man/1/pr

andrewzah 7y ago

You could also achieve this with LaTeX and pandoc.

systemvoltage 7y ago
With similar formatting and index?
- pan69 7y ago
  Yes. This book uses pandoc: https://github.com/jagregory/abrash-black-book https://github.com/jagregory/abrash-black-book This is the HTML output: http://www.jagregory.com/abrash-black-book/ http://www.jagregory.com/abrash-black-book/

lozf 7y ago

> Edit: I found the answer, tiny link at the bottom: https://tools.ietf.org/tools/rfcmarkup/ https://tools.ietf.org/tools/rfcmarkup/ If you read the link, that just adds the HTML markup to plain text ASCII RFCs (which were deprecated in favour of XML, back in 2013 as per RFC 7994.) RFC 7990 has more details on the format framework. But for actual guidance on the tools used, you probably want to peruse the "Prepare documents" section of the IETF's tools[0] page, or those at rfc-editor.org[1]. [0]: http://tools.ietf.org/ http://tools.ietf.org/ [1]: https://www.rfc-editor.org/pubprocess/tools/ https://www.rfc-editor.org/pubprocess/tools/ XML, markdown, asciidoc, Bibtex, nroff, and even Word are covered.

ducktective 7y ago

How about a version-controllable markdown diagram generator? https://mermaid-js.github.io/mermaid/ https://mermaid-js.github.io/mermaid/

yjftsjthsd-h 7y ago

pr(1) can do it - https://linux.die.net/man/1/pr https://linux.die.net/man/1/pr