OPNsense Forum
English Forums => Documentation and Translation => Topic started by: temporaryuser on March 07, 2016, 04:01:38 pm
-
Hi there!
Thank you very much for providing such a beautiful documentation using Sphinx with the "Read the Docs" theme.
One of the great features of Sphinx is: "Output formats: HTML (including Windows HTML Help), LaTeX (for printable PDF versions), ePub, Texinfo, manual pages, plain text".
Unfortunately I have not found the option for that in your documentation. Did you disable that feature in purpose, or is there any possibility for you implementing it / turning it on? It is very convenient for reading the documentation as EPUB on a tablet or to print it out as PDF.
Thank you & all the best for your young project!
Yours,
temporaryuser
-
Hi temporaryuser,
Thanks for your compliment!
Currently we don't offer the option to download the docs as they change a lot (very frequent updates and new chapters) and some pages don't export very well to different formats.
I would say keep a close eye on the project and you never know your wish might be granted at a later time.
Cheers,
Jos
-
Hi Jos,
Thanks for your compliment!
You are welcome :)
Currently we don't offer the option to download the docs
BTW: For anybody reading this and not knowing what we are talking about - here is an example:
https://virtualenvwrapper-bitbucket.readthedocs.org/en/stable/
-> If you click on the "v:stable" link at the bottom of the menu on the left side, you will get a menu with the export/download options.
as they change a lot (very frequent updates and new chapters) and some pages don't export very well to different formats.
I see. Nevertheless me as a consumer of this documentation I would prefer having the freedom of the export and then deal with the downsides you mentioned, since I love reading offline / on paper / as EPUB and make notes, etc. Maybe adding a short warning such as "Beware when exporting: Please come back regularly since this documentation is under active and heavy development" would solve the issue?
I would say keep a close eye on the project and you never know your wish might be granted at a later time.
Yes, of course, I will keep a close eye on the project in any case, since I am very positive about your reasons to fork pfSense, and I will be a happy new user of OPNsense, soon.
But I also keep my fingers crossed that you will grant me the freedom and openness to read the documentation as I prefer, soon, too.. ;-)
Cheers,
temporaryuser