-
Notifications
You must be signed in to change notification settings - Fork 5
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
Add single file HTML and MD output of spec and store it in each ERC #9
Comments
@7048730 should we store the spec within the ERC as a PDF or as an HTML file? |
how about PDF/A for long term preservation and additionally markdown for usability? |
PDF/A with pandoc... that could be a challenge :-). I didn't find anything in that direction, so any pointers are helpful. An what about the file names and paths? |
cf. jgm/pandoc#3215 Since PDF/A seems problematic, I'd go for a text version that is as much plain text as possible. On the other hand, as we do use a lot of hyperlinks, we might be okay using markdown anyway, which is after all only very lightwightedly encoded and thus easy to preserve. As for the filenames and paths, it might be reasonable from a preservationist's point of view to include the different spec outputs in directories that label them, e.g. |
No PDF/A for us, paths to the plain text documents are listed in the archival metadata, see #10 |
use https://github.com/jgrassler/mkdocs-pandoc to create single file, then https://github.com/jgrassler/mkdocs-pandoc#usage-example and http://pandoc.org/demos.html to create
spec_version
!) > Package slip for archival extension #10.erc/erc_raw.yml
@7048730The text was updated successfully, but these errors were encountered: