Updated to use new theme for docs site (#9320)

* Updated to use new theme for docs site

* Updated theme location

* Removed librenms.css

* Updated index page + re-added librenms.css

* Use built in theme modification

* flexbox grid, dump bootstrap

* tidy up things

* Added path and updated deploy script + mkdocs config

* Removed db schmea changes

* Updated to install python/pip 3

* Removed pip3 install

* Pip3 install

* Updated deploy-docs

* Updated deploy-docs

.travis.yml

@@ -27,7 +27,7 @@ cache:
 
 before_install:
   - sudo apt-get -qq update
-  - sudo apt-get install -y snmp fping
+  - sudo apt-get install -y snmp fping python3-pip
   - mysql -e 'CREATE DATABASE librenms_phpunit_78hunjuybybh;'
   - cp tests/config/config.test.php config.php
 

doc/API/ARP.md

@@ -1,4 +1,5 @@
 source: API/ARP.md
+path: blob/master/doc/
 
 ### `list_arp`
 

doc/API/Alerts.md

@@ -1,4 +1,5 @@
 source: API/Alerts.md
+path: blob/master/doc/
 
 ### `get_alert`
 

doc/API/Bills.md

@@ -1,4 +1,5 @@
 source: API/Bills.md
+path: blob/master/doc/
 
 ### `list_bills`
 

doc/API/DeviceGroups.md

@@ -1,4 +1,5 @@
 source: API/DeviceGroups.md
+path: blob/master/doc/
 
 ### `get_devicegroups`
 

doc/API/Devices.md

@@ -1,4 +1,5 @@
 source: API/Devices.md
+path: blob/master/doc/
 
 ### `del_device`
 

doc/API/Inventory.md

@@ -1,4 +1,5 @@
 source: API/Inventory.md
+path: blob/master/doc/
 
 ### `get_inventory`
 

doc/API/Logs.md

@@ -1,4 +1,5 @@
 source: API/Logs.md
+path: blob/master/doc/
 
 All the `list_*logs` calls are aliased to `list_logs`.
 

doc/API/PortGroups.md

@@ -1,4 +1,5 @@
 source: API/PortGroups.md
+path: blob/master/doc/
 
 ### `get_graph_by_portgroup`
 

doc/API/Ports.md

@@ -1,4 +1,5 @@
 source: API/Devices.md
+path: blob/master/doc/
 
 ### `get_all_ports`
 

doc/API/Routing.md

@@ -1,4 +1,5 @@
 source: API/Routing.md
+path: blob/master/doc/
 
 ### `list_bgp`
 

doc/API/Services.md

@@ -1,4 +1,5 @@
 source: API/Services.md
+path: blob/master/doc/
 
 ### `list_services`
 

doc/API/Switching.md

@@ -1,4 +1,5 @@
 source: API/Switching.md
+path: blob/master/doc/
 
 ### `list_vlans`
 

doc/API/System.md

@@ -1,4 +1,5 @@
 source: API/System.md
+path: blob/master/doc/
 
 ### `system`
 

doc/API/index.md

@@ -1,4 +1,5 @@
 source: API/index.md
+path: blob/master/doc/
 
 ## Versioning
 

doc/Alerting/Creating-Transport.md

@@ -1,4 +1,5 @@
 source: Alerting/Creating-Transport.md
+path: blob/master/doc/
 
 # Creating a new Transport.
 

doc/Alerting/Device-Dependencies.md

@@ -1,4 +1,5 @@
 source: Alerting/Device-Dependencies.md
+path: blob/master/doc/
 
 # Device Dependencies
 

doc/Alerting/Entities.md

@@ -1,4 +1,5 @@
 source: Alerting/Entities.md
+path: blob/master/doc/
 
 # Entities
 

doc/Alerting/Introduction.md

@@ -1,4 +1,5 @@
 source: Alerting/Introduction.md
+path: blob/master/doc/
 
 # Introduction
 

doc/Alerting/Macros.md

@@ -1,4 +1,5 @@
 source: Alerting/Macros.md
+path: blob/master/doc/
 
 # Macros
 

doc/Alerting/Old_Templates.md

@@ -1,4 +1,5 @@
 source: Alerting/Templates.md
+path: blob/master/doc/
 
 # Templates
 

doc/Alerting/Rules.md

@@ -1,4 +1,5 @@
 source: Alerting/Rules.md
+path: blob/master/doc/
 
 # Rules
 Rules are defined using a logical language.

doc/Alerting/Templates.md

@@ -1,4 +1,5 @@
 source: Alerting/Templates.md
+path: blob/master/doc/
 
 # Templates
 

doc/Alerting/Testing.md

@@ -1,4 +1,5 @@
 source: Alerting/Testing.md
+path: blob/master/doc/
 
 ### Rules
 

doc/Alerting/Transports.md

@@ -1,4 +1,5 @@
 source: Alerting/Transports.md
+path: blob/master/doc/
 
 # Transports
 

doc/Alerting/index.md

@@ -1,4 +1,5 @@
 source: Alerting/index.md
+path: blob/master/doc/
 
 # About
 

doc/Developing/Code-Guidelines.md

@@ -1,4 +1,5 @@
 source: Developing/Code-Guidelines.md
+path: blob/master/doc/
 # Coding guidelines
 
 This document is here to help code standards for contributions towards LibreNMS. The original code base that we forked from had a lack of standards and as such the code base has a variety of different styles. Whilst we don't want to restrict how people write code, these guidelines should mean we have a good standard going forward that makes reading the code easier. All modern day ide's should be able to assist in these guidelines without breaking your usual workflow.

doc/Developing/Code-Structure.md

@@ -1,4 +1,5 @@
 source: Developing/Code-Structure.md
+path: blob/master/doc/
 # Code structure.
 
 This document will try and provide a good overview of how the code is structured within LibreNMS. We will go through the main directories and provide information on how and when they are used.

doc/Developing/Creating-Documentation.md

@@ -1,4 +1,5 @@
 source: Developing/Creating-Documentation.md
+path: blob/master/doc/
 # Creating Documentation
 
 One of the goals of the LibreNMS project is to enable users to get all of the help they need from our documentation.

doc/Developing/Creating-Release.md

@@ -1,4 +1,5 @@
 source: Developing/Creating-Release.md
+path: blob/master/doc/
 # Creating a release
 
 ### GitHub

doc/Developing/Dynamic-Config.md

@@ -1,4 +1,5 @@
 source: Developing/Dynamic-Config.md
+path: blob/master/doc/
 # Adding new config options to WebUI
 
 Adding support for users to update a new config option via the WebUI is now a lot easier for general options. This

doc/Developing/Licensing.md

@@ -1,4 +1,5 @@
 ## Contributor Agreement
+path: blob/master/doc/
 
 By contributing code to LibreNMS (whether by a GitHub pull request, or by
 any other means), you assert that:

doc/Developing/Merging-Pull-Requests.md

@@ -1,4 +1,5 @@
 source: Developing/Merging-Pull-Requests.md
+path: blob/master/doc/
 # Merging Pull Requests
 
 ### GitHub

doc/Developing/SNMP-Traps.md

@@ -1,4 +1,5 @@
 source: Developing/SNMP-Traps.md
+path: blob/master/doc/
 
 # Creating snmp trap handlers
 

doc/Developing/Sensor-State-Support.md

@@ -1,4 +1,5 @@
 source: Developing/Sensor-State-Support.md
+path: blob/master/doc/
 # Sensor State Support
 
 ### Introduction

doc/Developing/Style-Guidelines.md

@@ -1,4 +1,5 @@
 source: Developing/Style-Guidelines.md
+path: blob/master/doc/
 # Style guidelines
 
 This document is here to help style standards for contributions towards LibreNMS. These aren't strict rules but it is in

doc/Developing/Support-New-OS.md

@@ -1,4 +1,5 @@
 source: Developing/Support-New-OS.md
+path: blob/master/doc/
 
 This document is broken down into the relevant sections depending on what support you are adding.
 During all of these examples we will be using the OS of `pulse` as the example OS we will add. 

doc/Developing/Using-Git.md

@@ -1,4 +1,5 @@
 source: Developing/Using-Git.md
+path: blob/master/doc/
 Git can have a bit of a steep learning curve, stick with it as it is worth learning the [basics][1][2] at least.
 
 If you want to help develop LibreNMS and haven't really used Git before then this quick primer will help you get started.

doc/Developing/Validating-Code.md

@@ -1,4 +1,5 @@
 source: Developing/Validating-Code.md
+path: blob/master/doc/
 
 #### Validating Code
 

doc/Developing/index.md

@@ -1,4 +1,5 @@
 source: General/index.md
+path: blob/master/doc/
 
 # Copyright and Licensing
 All contributors to LibreNMS retain copyright to their own code and are not

doc/Developing/os/Custom-Graphs.md

@@ -1,4 +1,5 @@
 source: Developing/os/Custom-Graphs.md
+path: blob/master/doc/
 
 If you are adding custom graphs, please add the following to `includes/definitions.inc.php`:
 ```php

doc/Developing/os/Health-Information.md

@@ -1,4 +1,5 @@
 source: Developing/os/Health-Information.md
+path: blob/master/doc/
 
 #### Sensors
 

doc/Developing/os/Initial-Detection.md

@@ -1,4 +1,5 @@
 source: Developing/os/Initial-Detection.md
+path: blob/master/doc/
 
 This document will provide the information you should need to add basic detection for a new OS.
 

doc/Developing/os/Mem-CPU-Information.md

@@ -1,4 +1,5 @@
 source: Developing/os/Mem-CPU-Information.md
+path: blob/master/doc/
 
 This document will guide you through adding detection for Memory / Processor for your new device.
 

doc/Developing/os/Settings.md

@@ -1,4 +1,5 @@
 source: os/Settings.md
+path: blob/master/doc/
 # Optional OS Settings
 
 This page documents settings that can be set in the os yaml files or in config.php.

doc/Developing/os/Test-Units.md

@@ -1,4 +1,5 @@
 source: Developing/os/Test-Units.md
+path: blob/master/doc/
 
 # Tests
 

doc/Developing/os/Wireless-Sensors.md

@@ -1,4 +1,5 @@
 source: Developing/os/Wireless-Sensors.md
+path: blob/master/doc/
 
 This document will guide you through adding wireless sensors for your new wireless device.
  

doc/Extensions/Agent-Setup.md

@@ -1,4 +1,5 @@
 source: Extensions/Agent-Setup.md
+path: blob/master/doc/
 
 The agent can be used to gather data from remote systems you can use LibreNMS in combination with check_mk (found [here](https://github.com/librenms/librenms-agent)).
 The agent can be extended to include data about [applications](Applications.md) on the remote system.

doc/Extensions/Alerting.md

@@ -1,2 +1,3 @@
 source: Extensions/Alerting.md
+path: blob/master/doc/
 <meta http-equiv="refresh" content="0; url=/Alerting/Alerting/" />

doc/Extensions/Applications.md

@@ -1,4 +1,5 @@
 source: Extensions/Applications.md
+path: blob/master/doc/
 ## Introduction
 
 You can use Application support to graph performance statistics of many applications.

doc/Extensions/Authentication.md

@@ -1,4 +1,5 @@
 source: Extensions/Authentication.md
+path: blob/master/doc/
 # Authentication modules
 
 LibreNMS supports multiple authentication modules along with [Two Factor Auth](http://docs.librenms.org/Extensions/Two-Factor-Auth/).

doc/Extensions/Auto-Discovery.md

@@ -1,4 +1,5 @@
 source: Extensions/Auto-Discovery.md
+path: blob/master/doc/
 # Auto Discovery Support
 
 ### Getting Started

doc/Extensions/Billing-Module.md

@@ -1,4 +1,5 @@
 source: Extensions/Billing-Module.md
+path: blob/master/doc/
 # Billing Module
 
 With the billing module you can create a bill, assign a quota to it and add ports to it.  

doc/Extensions/Component.md

@@ -1,4 +1,5 @@
 source: Extensions/Component.md
+path: blob/master/doc/
 
 # About
 

doc/Extensions/Dashboards.md

@@ -1,4 +1,5 @@
 source: Extensions/Dashboards.md
+path: blob/master/doc/
 
 # Dashboards
 Create customised dashboards in LibreNMS per user. You can share dashboards with other users. You can also make a custom dashboard and

doc/Extensions/Dell-OpenManage.md

@@ -1,4 +1,5 @@
 source: Extensions/Dell-OpenManage.md
+path: blob/master/doc/
 
 # Dell OpenManage Support
 -----------------------

doc/Extensions/Device-Groups.md

@@ -1,4 +1,5 @@
 source: Extensions/Device-Groups.md
+path: blob/master/doc/
 
 LibreNMS supports grouping your devices together in much the same way as you can configure alerts. This document will hopefully help you get started.
 

doc/Extensions/Distributed-Poller.md

@@ -1,4 +1,5 @@
 source: Extensions/Distributed-Poller.md
+path: blob/master/doc/
 # Distributed Poller
 LibreNMS has the ability to distribute polling of devices to other machines.
 

doc/Extensions/Fast-Ping-Check.md

@@ -1,4 +1,5 @@
 source: Extensions/Fast-Ping-Check.md
+path: blob/master/doc/
 
 ## Fast up/down checking
 

doc/Extensions/Gateone.md

@@ -1,4 +1,5 @@
 source: Extensions/Gateone.md
+path: blob/master/doc/
 # GateOne integration
 
 We have simple integration for [GateOne](https://github.com/liftoff/GateOne), you will be redirected to your Gateone command line frontend to access your equipment. (Currently this only works with SSH)

doc/Extensions/Graylog.md

@@ -1,4 +1,5 @@
 source: Extensions/Graylog.md
+path: blob/master/doc/
 # Graylog integration
 
 We have simple integration for Graylog, you will be able to view any logs from within LibreNMS that have been parsed by the syslog input from within

doc/Extensions/IRC-Bot-Extensions.md

@@ -1,4 +1,5 @@
 source: Extensions/IRC-Bot-Extensions.md
+path: blob/master/doc/
 # Quick Guide
 
 Okay this is a very quick walk-through in writing own `commands` for the IRC-Bot.

doc/Extensions/IRC-Bot.md

@@ -1,4 +1,5 @@
 source: Extensions/IRC-Bot.md
+path: blob/master/doc/
 [TOC]
 
 # About

doc/Extensions/Interface-Description-Parsing.md

@@ -1,4 +1,5 @@
 source: Extensions/Interface-Description-Parsing.md
+path: blob/master/doc/
 ## About
 Librenms can interpret, display and group certain additional information on ports.
 This is done based on the format that the port description is written although it's possible 

doc/Extensions/MIB-based-polling.md

@@ -1,4 +1,5 @@
 source: Extensions/MIB-based-polling.md
+path: blob/master/doc/
 ## WARNING ##
 
 MIB-based polling is unmaintained and may be removed in the future.  It might overload your LibreNMS server,

doc/Extensions/Metric-Storage.md

@@ -1,4 +1,5 @@
 source: Extensions/Metric-Storage.md
+path: blob/master/doc/
 hide_toc: true
 
 ### Metric storage

doc/Extensions/NFSen.md

@@ -1,4 +1,5 @@
 source: Extensions/NFSen.md
+path: blob/master/doc/
 # NFSen
 
 > The installation of NFSen is out of scope for this document / LibreNMS

doc/Extensions/Network-Map.md

@@ -1,4 +1,5 @@
 source: Extensions/Network-Map.md
+path: blob/master/doc/
 
 # Network Map
 

doc/Extensions/Oxidized.md

@@ -1,4 +1,5 @@
 source: Extensions/Oxidized.md
+path: blob/master/doc/
 
 # Oxidized intro
 ---

doc/Extensions/PeeringDB.md

@@ -1,4 +1,5 @@
 source: Extensions/PeeringDB.md
+path: blob/master/doc/
 # PeeringDB Support
 
 LibreNMS has integration with PeeringDB to match up your BGP sessions with the peering exchanges you are connected to.

doc/Extensions/Plugin-System.md

@@ -1,4 +1,5 @@
 source: Extensions/Plugin-System.md
+path: blob/master/doc/
 # Developing for the Plugin System
 
 > This will most likely be deprecated in favour of adding the possible extensions to the core code base.

doc/Extensions/Poller-Service.md

@@ -1,4 +1,5 @@
 source: Extensions/Poller-Service.md
+path: blob/master/doc/
 # Poller Service
 
 > Status: BETA

doc/Extensions/Proxmox.md

@@ -1,4 +1,5 @@
 source: Extensions/Proxmox.md
+path: blob/master/doc/
 # Proxmox graphing
 It is possible to create graphs of the Proxmox **VMs** that run on your monitored machines. Currently, only traffic graphs are created. One for each interface on each VM. Possibly, IO graphs will be added later on.
 

doc/Extensions/RRDCached-Security.md

@@ -1,4 +1,5 @@
 ### Securing with nginx
+path: blob/master/doc/
 According to the [man page](https://linux.die.net/man/1/rrdcached), under "SECURITY CONSIDERATIONS", rrdcached has no authentication or security except for running under a unix socket. If you choose to use a network socket instead of a unix socket, you will need to secure your rrdcached installation. To do so you can proxy rrdcached using nginx to allow only specific IPs to connect.
 
 using the same setup above, using nginx version 1.9.0 or later, you can follow this setup to proxy the default rrdcached port to the local unix socket.

doc/Extensions/RRDCached.md

@@ -1,4 +1,5 @@
 source: Extensions/RRDCached.md
+path: blob/master/doc/
 # Setting up RRDCached
 
 This document will explain how to setup RRDCached for LibreNMS.

doc/Extensions/RRDTune.md

@@ -1,4 +1,5 @@
 source: Extensions/RRDTune.md
+path: blob/master/doc/
 # RRDTune?
 
 When we create rrd files for ports, we currently do so with a max value of 12500000000 (100G). Because of this if a device sends us bad data back then it can appear as though

doc/Extensions/Rancid.md

@@ -1,4 +1,5 @@
 source: Extensions/Rancid.md
+path: blob/master/doc/
 # Rancid integration
 
 Librenms can generate a list of hosts that can be monitored by RANCID.

doc/Extensions/SNMP-Proxy.md

@@ -1,4 +1,5 @@
 source: Extensions/SNMP-Proxy.md
+path: blob/master/doc/
 # SNMP Proxy
 
 If you have machines that you want to monitor but are not reachable directly, you can use [SNMPD Proxy](http://www.net-snmp.org/wiki/index.php/Snmpd_proxy). This will use the reachable SNMPD to proxy requests to the unreachable SNMPD.

doc/Extensions/SNMP-Trap-Handler.md

@@ -1,4 +1,5 @@
 source: Extensions/SNMP-Trap-Handler.md
+path: blob/master/doc/
 # SNMP trap handling
 
 Currently, librenms only supports linkUp/linkDown (port up/down), bgpEstablished/bgpBackwardTransition (BGP Sessions Up/Down) and authenticationFailure SNMP traps.

doc/Extensions/Services.md

@@ -1,4 +1,5 @@
 source: Extensions/Services.md
+path: blob/master/doc/
 # Setting up Services
 
 Services within LibreNMS provides the ability to use Nagios plugins to perform additional monitoring outside of SNMP.

doc/Extensions/Smokeping.md

@@ -1,4 +1,5 @@
 source: Extensions/Smokeping.md
+path: blob/master/doc/
 # Smokeping integration
 
 [SmokePing](https://oss.oetiker.ch/smokeping/) is a tool which lets us keep track of network latency, and visualise this through RRD graphs. 

doc/Extensions/Sub-Directory.md

@@ -1,4 +1,5 @@
 source: Extensions/Sub-Directory.md
+path: blob/master/doc/
 To run LibreNMS under a subdirectory on your Apache server, the directives for the LibreNMS directory are placed in the base server configuration, or in a virtual host
 container of your choosing. If using a virtual host, place the directives in the file where the virtual host is configured. If using the base server on RHEL distributions
 (CentOS, Scientific Linux, etc.) the directives can be placed in `/etc/httpd/conf.d/librenms.conf`. For Debian distributions (Ubuntu, etc.) place the directives in

doc/Extensions/Syslog.md

@@ -1,4 +1,5 @@
 source: Extensions/Syslog.md
+path: blob/master/doc/
 # Setting up syslog support
 
 This document will explain how to send syslog data to LibreNMS.

doc/Extensions/Two-Factor-Auth.md

@@ -1,4 +1,5 @@
 source: Extensions/Two-Factor-Auth.md
+path: blob/master/doc/
 
 # About
 

doc/Extensions/Varnish.md

@@ -1,4 +1,5 @@
 source: Extensions/Varnish.md
+path: blob/master/doc/
 # Varnish Installation Guide #
 
 This document explains how to install Varnish Reverse Proxy for LibreNMS.

doc/Extensions/Weathermap.md

@@ -1,4 +1,5 @@
 source: Extensions/Weathermap.md
+path: blob/master/doc/
 
 # Network-WeatherMap with LibreNMS
 Integrating LibreNMS with Network-Weathermap, allows you to build network maps to help visulaize network traffic flow rates.

doc/Extensions/World-Map.md

@@ -1,4 +1,5 @@
 source: Extensions/World-Map.md
+path: blob/master/doc/
 # World Map Configuration
 
 LibreNMS comes with a configurable Geo Map based on World Map Widget to visualize where your equipment is located geographically.

doc/Extensions/metrics/Graphite.md

@@ -1,4 +1,5 @@
 source: Extensions/metrics/Graphite.md
+path: blob/master/doc/
 # Enabling support for Graphite.
 
 This module sends all metrics to a remote graphite service. You need something like Grafana for graphing.

doc/Extensions/metrics/InfluxDB.md

@@ -1,4 +1,5 @@
 source: Extensions/metrics/InfluxDB.md
+path: blob/master/doc/
 # Enabling support for InfluxDB.
 
 Before we get started it is important that you know and understand that InfluxDB support is currently alpha at best.

doc/Extensions/metrics/OpenTSDB.md

@@ -1,4 +1,5 @@
 source: Extensions/metrics/OpenTSDB.md
+path: blob/master/doc/
 # Enabling support for OpenTSDB.
 
 This module sends all metrics to OpenTSDB server. You need something like Grafana for graphing.

doc/Extensions/metrics/Prometheus.md

@@ -1,4 +1,5 @@
 source: Extensions/metrics/Prometheus.md
+path: blob/master/doc/
 # Enabling support for Prometheus.
 
 Please be aware Prometheus support is alpha at best, It hasn't been extensively tested and is still in development

doc/General/Acknowledgement.md

@@ -1,4 +1,6 @@
 source: General/Acknowledgement.md
+path: blob/master/doc/
+path: blob/master/doc/
 
 LibreNMS wouldn't be what it is today without the use of some other amazing projects.
 We list below what we make use of including the license compliance. 

doc/General/CODE_OF_CONDUCT.md

@@ -1,4 +1,5 @@
 source: General/CODE_OF_CONDUCT.md
+path: blob/master/doc/
 
 ## Our Pledge
 

doc/General/Callback-Stats-and-Privacy.md

@@ -1,4 +1,5 @@
 source: General/Callback-Stats-and-Privacy.md
+path: blob/master/doc/
 ## Stats data and your privacy ##
 
 This document has been put together to explain what LibreNMS does when it calls back home to report some anonymous statistics.

doc/General/Contributing.md

@@ -1,2 +1,3 @@
 source: General/Contributing.md
+path: blob/master/doc/
 <meta http-equiv="refresh" content="0; url=/Developing/" />

doc/General/Credits.md

@@ -1,2 +1,3 @@
 source: General/Credits.md
+path: blob/master/doc/
 <meta http-equiv="refresh" content="0; url=/General/Acknowledgement/" />

doc/General/Releases.md

@@ -1,4 +1,5 @@
 source: General/Releases.md
+path: blob/master/doc/
 
 #### Introduction
 We try to ensure that breaking changes aren't introduced by utilising various automated 

doc/General/Security.md

@@ -1,4 +1,5 @@
 source: General/Security.md
+path: blob/master/doc/
 
 ### General
 Like any good software we take security seriously. However, bugs do make it into the software 

doc/General/Updating.md

@@ -1,4 +1,5 @@
 source: General/Updating.md
+path: blob/master/doc/
 
 By default, LibreNMS is set to automatically update. If you have disabled this feature then you can 
 perform a manual update.

doc/General/Welcome-to-Observium-users.md

@@ -1,4 +1,5 @@
 source: General/Welcome-to-Observium-users.md
+path: blob/master/doc/
 
 LibreNMS is a fork of Observium.  The reason for the fork has nothing to do
 with Observium's [move to community vs. paid versions][1].  It is simply