Reply to Moving the pfSense® Documentation to GitHub on Wed, 13 Jun 2018...
Some of the pages were considered outdated, redundant, or misplaced and are still being manually organized and that might be one of them. We are still working on cleaning up everything from the move....
View ArticleReply to Moving the pfSense® Documentation to GitHub on Tue, 12 Jun 2018...
There used to be documentation for installing pfSense on watchguard firebox appliances; this seems to have disappeared. I had bookmarked the link at...
View ArticleReply to Moving the pfSense® Documentation to GitHub on Wed, 06 Jun 2018...
Plus we've been using Sphinx for years for the pfSense book and other internal documentation, so it made sense to keep the converted wiki consistent.
View ArticleReply to Moving the pfSense® Documentation to GitHub on Wed, 06 Jun 2018...
I'd say the big reason is that Sphinx (restructuredText) has a syntax geared towards documentation (info/warning boxes, etc) so we didn't have to adopt a custom markdown flavor to achieve the same...
View ArticleReply to Moving the pfSense® Documentation to GitHub on Wed, 06 Jun 2018...
Great, thanks for sharing! How did you come to choose Sphinx over the other many possible options (Jekyll, Hugo, many other choices)?
View ArticleReply to Moving the pfSense® Documentation to GitHub on Wed, 06 Jun 2018...
I used a php script to grab all the wiki pages from the DB and save them as flat files (note: I forgot to add the title at the top of each page in this version): <?php $servername = "localhost";...
View ArticleReply to Moving the pfSense® Documentation to GitHub on Wed, 06 Jun 2018...
I have a similar doc site I would like to convert from Mediawiki to GitHub. How did you execute the actual conversion of Mediawiki pages? What tooling did you use? Thanks.
View ArticleReply to Moving the pfSense® Documentation to GitHub on Mon, 04 Jun 2018...
We've moved the documentation from mediaWiki to GitHub. More information can be found on the following blog post: https://www.netgate.com/blog/moving-the-pfsense-documentation-to-github.html. There is...
View Article