You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Ad Schellevis 453a37451f Firewall / Alias - explain format for URL table type. (https://forum.opnsense.org/index.php?topic=29486.msg142366#msg142366) 1 day ago
.github/ISSUE_TEMPLATE add issue templates 2 years ago
source Firewall / Alias - explain format for URL table type. (https://forum.opnsense.org/index.php?topic=29486.msg142366#msg142366) 1 day ago
.gitignore add collect_changelogs.py script to collect and transform release logs. 2 years ago
CONTRIBUTING.md add CONTRIBUTING.md 2 years ago
LICENSE Many typo fixes and some rewording (#80) 4 years ago
Makefile Initial version of the freely available OPNsense documentation project, original commiters are listed in LICENSE file. 5 years ago
README.md pip[3] in case pip3 doesn't exist :) 2 years ago
collect_api_endpoints.in collect_api_endpoints.py: extend script with support for abstract classes, add used model when using standard templates. 2 years ago
collect_api_endpoints.py collect_api_endpoints.py: add standard base methods and escape parameters 1 year ago
collect_changelogs.py changelogs - better handle BE 1 year ago
requirements.txt sphinx_rtd_theme==0.5.2 << version 1.0.0 doesn't render correctly 9 months ago

README.md

alt text

OPNsense documentation

Welcome to the OPNsense documentation & wiki.
The purpose of this project is to provide OPNsense users with quality documentation.

Contribute

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!

License

OPNsense documentation is available under the 2-Clause BSD license:

http://opensource.org/licenses/BSD-2-Clause

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:

https://creativecommons.org/publicdomain/zero/1.0/

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.

Prepare build

On FreeBSD the following packages are required:

pkg install py37-pip jpeg-turbo gmake

Install Sphinx, our default theme and contrib packages:

pip[3] install -r requirements.txt --upgrade

Update API endpoints

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

Generate HTML documents

make html

(make clean to flush)