OPNsense Forum
English Forums => Documentation and Translation => Topic started by: markLopez9 on June 03, 2021, 10:43:21 pm
-
Hello everyone,
It's my first time posting here, so I hope I picked the proper board for my suggestion/request.
I browsed through the existing topics, and saw that there are people like me who prefer learning things offline (specifically reading through print). I combed through wiki.opnsense.org and I know there is no 'download as PDF' button unlike with pfSense (excuse me for the comparison). In the topic Printable version of the OPNsense 18.7.x documentation (https://forum.opnsense.org/index.php?topic=9792.0), there was a mention about building it from the sources which would have been a good alternative as I'm comfortable with Linux, but the disclaimer about issues with big images simply won't cut it. As an alternative, I saw that I can use the Print option on the browser and just print it to PDF as if I'm exporting the web page. It's a hassle as I have to do it on each page, but it's the only choice available until a PDF version is made available.
Apart from printing the wiki to learn OPNsense for the first time, I also intend to have a readily-available reference going forward that is both offline and kept up-to-date. Since I can't download it with a click of a button, I'll have to comb through the entire wiki page-by-page. But there's a challenge for that: I couldn't tell which pages have been updated recently and which ones have not. In some wikis like Asterisk's (https://wiki.asterisk.org/wiki/display/AST/Asterisk+Architecture%2C+The+Big+Picture) though, which is an open-source IP telephony thing, there's a small line of text just below the topic title saying "last modified by [contributor] on [date of last update]." The wiki for OpenWrt also has something similar.
Having mentioned those examples, I hope it's not too much to ask from the people maintaining the wiki: can we incorporate an indicator of some sort on the wiki pages as to when those pages were last updated? That would help people (who prefer reading from print) to identify which wiki page we just need to print from the browser if we are just looking for pages with updated content.
Hoping for your kind consideration. Thanks in advance.
-
The documentation is not really a wiki. It is a static site that is generated out of some text and image sources. To generate a pdf, you only need to specify to use that as an output. The documentation is here:
https://github.com/opnsense/docs
-
I suppose that means no, the date stamp cannot be added. Thanks for providing the path to the source though. I'll play around with LaTeX to see if I can generate the PDFs on my own.