|C-Duv a341ab2e72||2 days ago|
|source||2 days ago|
|themes/opnsense/sass||1 year ago|
|.gitignore||3 days ago|
|LICENSE||1 year ago|
|Makefile||2 years ago|
|README.md||1 month ago|
|collect_api_endpoints.in||2 weeks ago|
|collect_api_endpoints.py||2 weeks ago|
|collect_changelogs.py||3 days ago|
|requirements.txt||1 month ago|
Welcome to the OPNsense documentation & wiki.
The purpose of this project is to provide OPNsense users with quality documentation.
You can contribute to the project in many ways, e.g. testing functionality, sending in bug reports or creating pull requests directly via GitHub. Any help is always very welcome!
OPNsense documentation is available under the 2-Clause BSD license:
Every contribution made to the project must be licensed under the same conditions in order to keep OPNsense truly free and accessible for everybody.
Some pictures are licensed under the Creative Commons Zero (CC0) license:
Logos may be subject to additional copyrights, property rights, trademarks etc. and may require the consent of a third party or the license of these rights. Deciso B.V. does not represent or make any warranties that it owns or licenses any of the mentioned, nor does it grant them.
Install Sphinx, our default theme and contrib packages
pip3 install -r requirements.txt --upgrade
A script is provided to update the api endpoint documentation, this can be executed using:
./collect_api_endpoints.py --repo core /path/to/core/repository ./collect_api_endpoints.py --repo plugins /path/to/plugins/repository
make clean to flush)
gem install --no-user-install sass
npm install -g bower
Install required stylesheets using bower
bower install wyrm bower install robotoslab-googlefont bower install inconsolata-googlefont bower install font-awesome#4.7.0
(for font-awesome, choose newest)
sass -I bower_components/wyrm/sass/ -I bower_components/bourbon/dist/ -I bower_components/neat/app/assets/stylesheets/ -I bower_components/font-awesome/scss/ themes/opnsense/sass/theme.sass > source/_static/css/opnsense.css