@paddatrapper changes

docs/_data/nav.yml

@@ -1,8 +1,6 @@
 topnav:
-- page: Install
-  url: quickstart
 - page: Docs
-  url: preparing-the-server
+  url: quickstart
 - page: Contribute
   url: contribute
 - page: <svg class="bi bi-heart-fill" width="1em" height="1em" viewBox="0 0 16 16" fill="currentColor" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" d="M8 1.314C12.438-3.248 23.534 4.735 8 15-7.534 4.736 3.562-3.248 8 1.314z"/></svg> Sponsor
@@ -11,8 +9,6 @@ topnav:
 docsnav:
 - section: Install
   contents:
-  - page: 0. Preparing the Server
-    url: preparing-the-server
   - page: 1. Quick Install
     url: quickstart
   - page: 2. Host Configuration

docs/contribute.md

@@ -24,6 +24,13 @@ Have an idea that would make LibreTime even better than it is right now? Start a
 LibreTime can run in over 15 different languages due to the gracious help of our volunteers. Is your language not
 supported? Follow [this guide](interface-localization) to add your language to LibreTime!
 
+## Help write documentation for LibreTime
+
+Our site is now run by Jekyll. After cloning our repo locally, enter the `/docs` directory and run
+```
+jekyll serve
+```
+
 ## Help write code for LibreTime
 
 Are you familar with coding in PHP? Have you made projects in Liquidsoap and some of the other services we use?

docs/dashboard.md

@@ -80,8 +80,6 @@ To cancel the current show completely, click the red button to the right again.
 A pop-up window will ask you to confirm the cancellation, as this action cannot
 be undone.
 
-![](img/cancel-show.png)
-
 Items which are no longer available have an exclamation mark icon in the second
 column. This may happen for media files which were part of previous shows, and
 were removed from LibreTime's library (main storage or watched folders)

docs/hd-audio-modules.md

@@ -1,9 +1,8 @@
 ---
-sidebar: appendix
+layout: docs
+title: HD Audio Modules
 ---
 
-# HD Audio Modules
-
 This listing is provided to help ensure that the correct model parameter is passed to the ALSA kernel module for an Intel HDA soundcard, if one is fitted to your LibreTime server. See the chapter *Preparing the server* in this book for more details.
 
       Model name   Description

docs/icecast-shoutcast.md

@@ -1,4 +1,7 @@
-# Icecast and Shoutcast stream configuration
+---
+layout: docs
+title: Icecast and Shoutcast Stream Configuration
+---
 
 LibreTime supports direct connection to two popular streaming media servers, the open source **Icecast** (<http://www.icecast.org>) and the proprietary **SHOUTcast** (<http://www.shoutcast.com>). Apart from the software license, the main difference between these two servers is that Icecast supports simultaneous MP3, AAC, Ogg Vorbis or Ogg Opus streaming from LibreTime, whereas SHOUTcast supports MP3 and AAC streams but not Ogg Vorbis or Opus. The royalty-free Ogg Vorbis format has the advantage of better sound quality than MP3 at lower bitrates, which has a direct impact on the amount of bandwidth that your station will require to serve the same number of listeners. Ogg Opus also benefits from good sound quality at low bitrates, with the added advantage of lower latency than other streaming formats. Opus is now an IETF standard (<http://tools.ietf.org/html/rfc6716>) and requires Icecast 2.4 or later to be installed on the streaming server.
 

docs/interface-customization.md

@@ -1,5 +1,8 @@
-Modifying the LibreTime interface
-----------------------------------
+---
+layout: docs
+title: Modifying the LibreTime interface
+---
+
 
 The LibreTime administration interface, as a web application, is fully customizable using the same methods that you might use to modify a website. For instance, you may wish to increase certain font sizes or change the colours in the LibreTime interface to better suit staff users with impaired vision. To do this, open one of the CSS files in the */public/css/* directory under the LibreTime *DocumentRoot* directory in an editor such as **nano**:
 

docs/live-broadcast.md

@@ -7,7 +7,11 @@ title: Broadcasting live with MIXXX or B.U.T.T.
 - [MIXXX](#mixxx)
 - [BUTT](#butt)
 
-[![How to Livestream Your Show](http://img.youtube.com/vi/4GLsU9hPTtM/0.jpg)](https://www.youtube-nocookie.com/embed/4GLsU9hPTtM "How to Livestream Your Show")
+# Video Tutorial
+
+<html>
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/4GLsU9hPTtM" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</html>
 
 This how to is intended for DJs using BUTT or MIXXX to stream to their LibreTime
 server with an external USB audio card setup to route a mixer and sound.

docs/quickstart.md

@@ -81,10 +81,32 @@ After the install is completed, head to the IP address of the server LibreTime w
 to complete the welcome wizard. While not strictly necessary, it is recommended that you change the passwords prompted in the welcome wizard if you intend on accessing the server from the Internet. The welcome wizard will
 walk you through the rest of the installation process.
 
-Congratulations! You've successfully set up LibreTime!
-
 ## Post-install
 
+### Services
+
+Once all of the services needed to run LibreTime are installed and configured,
+it is important that the server starts them during the boot process, to cut down on downtime, especially in live enviornments.
+Ubuntu 18.04 uses the `systemctl` command to manage services, so run the following commands to enable all
+LibreTime-needed services to run at boot:
+
+```
+sudo systemctl enable libretime-liquidsoap
+sudo systemctl enable libretime-playout
+sudo systemctl enable libretime-celery
+sudo systemctl enable libretime-analyzer
+sudo systemctl enable apache2
+sudo systemctl enable rabbitmq-server
+```
+
+If an error is returned, try adding `.service` to the end of each command. For example:
+
+```
+sudo systemctl enable apache2.service
+```
+
+### User Permissions
+
 If you plan to have LibreTime output analog audio directly from its server to a mixing console or transmitter,
 the `www-data` user needs to be added to the `audio` user group using the command below.
 
@@ -92,6 +114,8 @@ the `www-data` user needs to be added to the `audio` user group using the comman
 sudo adduser www-data audio
 ```
 
+Congratulations! You've successfully installed LibreTime!
+
 Now that the install is complete, use these guides to help you continue to set up your LibreTime server
 
 - [Host Configuration](host-configuration)

docs/ssl-config.md

@@ -72,6 +72,7 @@ Using the following configuration for Apache 2.2 as a guide, replace *airtime.ex
 
 On port 80, Apache's *alias* module is used to set a *Redirect permanent* for the login page. Optionally, access could be denied to all sites except *localhost* and any other LibreTime servers on your network, so that unencrypted communication between LibreTime components can continue.
 
+```
     <VirtualHost *:443>
           SSLEngine on
           SSLProtocol All -SSLv2 -SSLv3
@@ -113,6 +114,7 @@ On port 80, Apache's *alias* module is used to set a *Redirect permanent* for th
                   Allow from all
           </Directory>
     </VirtualHost> 
+```
 
 Save the file with **Ctrl+O** and exit the **nano** editor with **Ctrl+X**. Then restart Apache with the command:
 
@@ -136,4 +138,3 @@ If the users of your LibreTime server wish to avoid going through these steps, o
 
 Whether your certificate is self-signed or not, you will see browser security warnings whenever a https:// page is delivering unencrypted content, such as the stream from an Icecast server. In Firefox, an exclamation mark icon is displayed in the address bar of the **Listen** pop-up.
 
-![](img/Screenshot549-unencrypted_warning.png)

docs/uninstall.md

@@ -1,5 +1,7 @@
-Uninstall LibreTime
--------------------
+---
+layout: docs
+title: Uninstall LibreTime
+---
 
 Hopefully it wasn't something that we did, but if you need to uninstall LibreTime for
 any reason, cd to the directory of the installer and run `sudo ./uninstall` and follow the prompts.