Quantcast
Channel: Moving the pfSense® Documentation to GitHub
Browsing all 8 articles
Browse latest View live

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 Article



Reply 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 Article

Reply 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 Article

Reply 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 Article

Reply 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 Article


Reply 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 Article

Reply 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 Article

Reply 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

Browsing all 8 articles
Browse latest View live




Latest Images