Update documentation layout.

Author: brocaar

docs/config.toml

@@ -1,31 +1,31 @@
-baseURL = "https://docs.loraserver.io/lora-gateway-bridge/"
+baseURL = "https://www.loraserver.io/lora-gateway-bridge/"
 languageCode = "en-us"
 title = "LoRa Gateway Bridge documentation"
 googleAnalytics = "UA-3512995-9"
 
 [[menu.main]]
-    pre = "<i class='fa fa-hand-o-right'></i>"
+    pre = "<i class='fas fa-hand-point-right'></i>"
     name = "Overview"
     identifier = "overview"
     url = "/overview/"
     weight = 1
 
 [[menu.main]]
-    pre = "<i class='fa fa-download'></i>"
+    pre = "<i class='fas fa-download'></i>"
     name = "Install"
     identifier = "install"
     url = "/install/"
     weight = 2
 
 [[menu.main]]
-    pre = "<i class='fa fa-user'></i>"
+    pre = "<i class='fas fa-user'></i>"
     name = "Use"
     identifier = "use"
     url = "/use/"
     weight = 3
 
 [[menu.main]]
-    pre = "<i class='fa fa-github'></i>"
+    pre = "<i class='fab fa-github'></i>"
     name = "Community & support"
     identifier = "community"
     url = "/community/"

docs/content/community/contribute.md

@@ -6,7 +6,7 @@ menu:
         weight: 2
 ---
 
-## Contribute
+# Contribute
 
 There are a couple of ways to get involved:
 

docs/content/community/source.md

@@ -6,13 +6,13 @@ menu:
         weight: 3
 ---
 
-## LoRa Gateway Bridge source
+# LoRa Gateway Bridge source
 
 Source-code can be found at [https://github.com/brocaar/lora-gateway-bridge](https://github.com/brocaar/lora-gateway-bridge).
 
-### Building
+## Building
 
-#### With Docker
+### With Docker
 
 The easiest way to get started is by using the provided 
 [docker-compose](https://docs.docker.com/compose/) environment. To start a bash
@@ -23,19 +23,19 @@ the root of this project:
 docker-compose run --rm gatewaybridge bash
 ```
 
-#### Without Docker
+### Without Docker
 
 It is possible to build LoRa App Server without Docker. However this requires
 to install a couple of dependencies (depending your platform, there might be
 pre-compiled packages available):
 
-##### Go
+#### Go
 
 Make sure you have [Go](https://golang.org/) installed (1.8+) and that the LoRa
 Gateway Bridge repository has been cloned to 
 `$GOPATH/src/github.com/brocaar/lora-gateway-bridge`.
 
-#### Example commands
+### Example commands
 
 A few example commands that you can run:
 

docs/content/community/support.md

@@ -6,14 +6,14 @@ menu:
         weight: 1
 ---
 
-## Support
+# Support
 
-### Bugs
+## Bugs
 
 Did you find a bug or want to request a new feature? Please first check if
 this issue has already been reported. If not, please create an issue:
 [https://github.com/brocaar/lora-gateway-bridge/issues](https://github.com/brocaar/lora-gateway-bridge/issues).
 
-### Questions
+## Questions
 
 For support questions, please refer to the [LoRa Server project forum](https://forum.loraserver.io/).

docs/content/install/config.md

@@ -6,9 +6,9 @@ menu:
         weight: 5
 ---
 
-## Configuration
+# Configuration
 
-### Gateway
+## Gateway
 
 Modify the [packet-forwarder](https://github.com/lora-net/packet_forwarder)
 of your gateway so that it will send its data to the LoRa Gateway Bridge.
@@ -18,7 +18,7 @@ You will need to change the following configuration keys:
 * `serv_port_up` to `1700` (the default port that LoRa Gateway Bridge is using)
 * `serv_port_down` to `1700` (same)
 
-### LoRa Gateway Bridge
+## LoRa Gateway Bridge
 
 The `lora-gateway-bridge` has the following command-line flags:
 
@@ -44,7 +44,7 @@ Flags:
 Use "lora-gateway-bridge [command] --help" for more information about a command.
 ```
 
-#### Configuration file
+### Configuration file
 
 By default `lora-gateway-bridge` will look in the following order for a
 configuration at the following paths when `--config` / `-c` is not set:
@@ -158,7 +158,7 @@ tls_cert=""
 tls_key=""
 ```
 
-#### Warning: deprecation warning! update your configuration
+### Warning: deprecation warning! update your configuration
 
 When you see this warning, you need to update your configuration!
 Before LoRa Gateway Bridge 2.3.0 environment variables were used for setting

docs/content/install/debian.md

@@ -6,15 +6,15 @@ menu:
         weight: 4
 ---
 
-## Debian / Ubuntu
+# Debian / Ubuntu
 
 These steps have been tested using:
 
 * Debian Jessie
 * Ubuntu Trusty (14.04)
 * Ubuntu Xenial (16.04)
 
-### LoRa Server Debian repository
+## LoRa Server Debian repository
 
 The LoRa Server project provides pre-compiled binaries packaged as Debian (.deb)
 packages. In order to activate this repository, execute the following
@@ -29,7 +29,7 @@ sudo echo "deb https://repos.loraserver.io/${DISTRIB_ID,,} ${DISTRIB_CODENAME} t
 sudo apt-get update
 ```
 
-### Install LoRa Gateway Bridge
+## Install LoRa Gateway Bridge
 
 In order to install LoRa Gateway Bridge, execute the following command:
 
@@ -41,24 +41,24 @@ This will setup an user and group, create start scripts for systemd or init.d
 (this depends on your version of Debian / Ubuntu). The configuration file is
 located at `/etc/lora-gateway-bridge/lora-gateway-bridge.toml`.
 
-### Starting LoRa Gateway Bridge
+## Starting LoRa Gateway Bridge
 
 How you need to (re)start and stop LoRa Gateway Bridge depends on if your
 platform uses systemd or init.d.
 
-#### systemd
+### systemd
 
 ```bash
 sudo systemctl [start|stop|restart|status] lora-gateway-bridge
 ```
 
-#### init.d
+### init.d
 
 ```bash
 sudo /etc/init.d/lora-gateway-bridge [start|stop|restart|status]
 ```
 
-### LoRa Gateway log output
+## LoRa Gateway log output
 
 Now you've setup LoRa Gateway Bridge and your gateway is configured to forward
 it's data to it, it is a good time to verify that data is actually comming in.
@@ -67,7 +67,7 @@ This can be done by looking at the LoRa Gateway Bridge log output.
 Like the previous step, which command you need to use for viewing the
 log output depends on if your distribution uses init.d or systemd.
 
-#### init.d
+### init.d
 
 All logs are written to `/var/log/lora-gateway-bridge/lora-gateway-bridge.log`.
 To view and follow this logfile:
@@ -76,7 +76,7 @@ To view and follow this logfile:
 tail -f /var/log/lora-gateway-bridge/lora-gateway-bridge.log
 ```
 
-#### systemd
+### systemd
 
 ```bash
 journalctl -u lora-gateway-bridge -f -n 50
@@ -103,7 +103,7 @@ lora-gateway-bridge[9714]: time="2016-08-19T09:05:34+02:00" level=info msg="gate
 For an explanation of the different types of data you can receive from and
 send to the LoRa Gateway Bridge see [send / receive data]({{< ref "use/data.md" >}}).
 
-### Install other components
+## Install other components
 
 A complete LoRa Server setup, requires the setup of the following components:
 

docs/content/install/debug.md

@@ -6,11 +6,11 @@ menu:
         weight: 6
 ---
 
-## Debugging
+# Debugging
 
 The follwing steps can be used to debug any LoRa Gateway Bridge related issues.
 
-### Receiving MQTT messages
+## Receiving MQTT messages
 
 To validate that the LoRa Gateway Bridge is publishing LoRa frames to the
 MQTT broker, you can subscribe to the `gateway/+/rx` MQTT topic. When using
@@ -29,7 +29,7 @@ When you don't see any frames appearing, this could be caused by the following i
 * The MQTT credentials / authorizations are invalid (the user is not authorized
   to subscribe to the MQTT topic)
 
-### Is LoRa Gateway Bridge receiving data
+## Is LoRa Gateway Bridge receiving data
 
 To validate that the LoRa Gateway Bridge is receiving, you can take a look
 at the LoRa Gateway Bridge logs. How to retrieve the logs depends on how you
@@ -67,7 +67,7 @@ be caused by:
 * The node is sending on a frequency that the packet-forwarder is not
   configured for.
 
-### Is the packet-forwarder running
+## Is the packet-forwarder running
 
 To validate that the packet-forwarder is running, you could execute the
 following command on your gateway:
@@ -129,7 +129,7 @@ When you don't see any of these, this could be caused by the following issues:
 * The packet-forwarder is not running
 * The packet-forwarder is forwarding to a different host / port
 
-### Where is the packet-forwarder sending data to
+## Where is the packet-forwarder sending data to
 
 Inspect the `local_conf.json` of the packet-forwarder running on your gateway.
 You might need to refer to your gateway manual to find out where you can locate

docs/content/install/deployment.md

@@ -6,11 +6,11 @@ menu:
         weight: 2
 ---
 
-## Deployment strategies
+# Deployment strategies
 
 There are multiple ways that you can deploy the LoRa Gateway Bridge:
 
-### Single instance
+## Single instance
 
 The most basic strategy is to connect all your gateways to a single instance
 of the LoRa Gateway Bridge. This is the easiest option, as installing the
@@ -20,7 +20,7 @@ The UDP protocol implemented by most gateways don't support support any
 form of authorization and checks that the received data is authentic. It is
 however an easy way to get started.
 
-### Multiple instances
+## Multiple instances
 
 For performance and to make the LoRa Gateway Bridge highly available, you
 can run LoRa Gateway Bridge on multiple servers, each connecting to the same
@@ -30,23 +30,23 @@ MQTT broker.
 Bridge cluster, make sure that each gateway connection is always routed to the
 same instance!
 
-### On each gateway
+## On each gateway
 
 Depending on the capabilities of your gateway, you can deploy the LoRa Gateway
 Bridge on each of your gateways. This might require a few additional steps in
 the setup, but has the following advantages:
 
-#### MQTT (using TCP) over UDP
+### MQTT (using TCP) over UDP
 
 By using MQTT (which uses TCP) over UDP, the connection becomes more reliable
 in case packetloss is common.
 
-#### Authentication
+### Authentication
 
 It is possible to setup credentials for each gateway, meaning you know where
 your data is coming from.
 
-#### SSL/TLS
+### SSL/TLS
 
 The MQTT protocol supports SSL/TLS meaning that you are able to setup a secure
 connection between your gateways and your MQTT broker. This not any means that

docs/content/install/gateway/_index.md

@@ -7,9 +7,9 @@ menu:
         identifier: gateway
 ---
 
-## Install on the gateway
+# Install on the gateway
 
-### Vendors
+## Vendors
 
 Instructions are available for the following vendors:
 
@@ -21,7 +21,7 @@ Instructions are available for the following vendors:
 For Raspberry Pi / Rasbian based gateways, please refer the
 [Debian / Ubuntu]({{< ref "install/debian.md" >}}) installation instructions.
 
-### Contribute
+## Contribute
 
 Help us making the above list complete! Is the gateway that you are using not
 listed in the above vendors list? Or are the steps described outdated?

docs/content/install/gateway/kerlink.md

@@ -5,8 +5,9 @@ menu:
         parent: gateway
 ---
 
+# Kerlink
 
-### Kerlink IOT station
+## Kerlink IOT station
 
 The Kerlink IOT station has a meganism to start "custom" application on boot.
 These steps will install the LoRa Gateway Bridge ARM build on the Kerlink.