Home
Help
Search
Login
Register
OPNsense Forum
»
English Forums
»
Documentation and Translation
(Moderator:
fabian
) »
Suggestion (or Request) regarding wiki.opnsense.org
« previous
next »
Print
Pages: [
1
]
Author
Topic: Suggestion (or Request) regarding wiki.opnsense.org (Read 7321 times)
markLopez9
Newbie
Posts: 5
Karma: 0
Suggestion (or Request) regarding wiki.opnsense.org
«
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
, 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
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.
«
Last Edit: June 03, 2021, 10:45:03 pm by markLopez9
»
Logged
fabian
Moderator
Hero Member
Posts: 2769
Karma: 200
OPNsense Contributor (Language, VPN, Proxy, etc.)
Re: Suggestion (or Request) regarding wiki.opnsense.org
«
Reply #1 on:
June 04, 2021, 06:54:26 am »
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
Logged
markLopez9
Newbie
Posts: 5
Karma: 0
Re: Suggestion (or Request) regarding wiki.opnsense.org
«
Reply #2 on:
June 07, 2021, 12:55:35 pm »
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.
Logged
Print
Pages: [
1
]
« previous
next »
OPNsense Forum
»
English Forums
»
Documentation and Translation
(Moderator:
fabian
) »
Suggestion (or Request) regarding wiki.opnsense.org