Generate and publish HTML version of the specification

OpenCyphal / specification

The Cyphal specification documents are maintained here.

https://opencyphal.org/specification

Creative Commons Attribution 4.0 International

41 stars 13 forks source link

Generate and publish HTML version of the specification #86

Open thirtytwobits opened 4 years ago

thirtytwobits commented 4 years ago

The PDF is great but you can't provide links into it. We should also generate an HTML/web version from the same tex and publish to the uavcan.org domain.

pavel-kirienko commented 4 years ago

FWIW page anchors seem to work, although I'm not sure if it's a standard feature:

https://helpx.adobe.com/acrobat/kb/link-html-pdf-page-acrobat.html

This link works for me in Firefox, opening the page 55: https://uavcan.org/specification/UAVCAN_Specification_v1.0-alpha.pdf#page=55. Does it work for you?

@hamishwillee Hamish, do you think we could realistically ask Auterion to kindly help us get our docs in order?

thirtytwobits commented 4 years ago

It seems to work in Chrome. Nice.

hamishwillee commented 4 years ago

@pavel-kirienko Maybe. I'll send you a message offline.

silverv commented 2 years ago

This would also help potential adopters use Google Translate to read the document in a language that they can understand. https://forum.uavcan.org/t/about-the-web-version-of-the-v1-specification/878