From ef4feb10950fb3ff2b536cc3a88591e3b6dceaf5 Mon Sep 17 00:00:00 2001 From: Zachary Klosko Date: Wed, 10 Jun 2020 12:25:34 -0400 Subject: [PATCH] Fixed scrolling issue on TOC links --- docs/css/creative.min.css | 7 +++- docs/preparing-media.md | 21 ++++++----- docs/preparing-the-server.md | 8 +++-- docs/reverse-proxy.md | 2 +- docs/setting-the-server-time.md | 6 ++-- docs/ssl-config.md | 64 ++++++++++++++++----------------- 6 files changed, 57 insertions(+), 51 deletions(-) diff --git a/docs/css/creative.min.css b/docs/css/creative.min.css index 29450db5c..ba2c3459e 100755 --- a/docs/css/creative.min.css +++ b/docs/css/creative.min.css @@ -28,7 +28,7 @@ img{ a{ color:#f05f40; -webkit-transition:all .2s; - transition:all .2s + transition:all .2s; } a:hover{ @@ -39,6 +39,11 @@ h1,h2,h3,h4,h5,h6{ font-family:'Open Sans','Helvetica Neue',Arial,sans-serif; } +/* Correcting overscroll on TOC links */ +:target{ + padding-top: 57px; +} + /* Table Properties */ table{ padding: 20px; diff --git a/docs/preparing-media.md b/docs/preparing-media.md index 28fbd526b..578dcf086 100644 --- a/docs/preparing-media.md +++ b/docs/preparing-media.md @@ -6,23 +6,22 @@ title: Preparing Media for LibreTime Before uploading media to an LibreTime server, there are a number of factors which should be considered. Getting your ingest workflow right will save you a lot of time later. -# Metadata quality +## Metadata quality LibreTime automatically imports any metadata that is in the files' ID3 tags. If these tags are incorrect or are missing information, you will have to either edit the metadata manually, or suffer the consequences. For example, if the files have creator or genre metadata missing, it will be impossible to search for, create playlists or generate smart blocks according to these criteria until you add it. -There are a number of programs available which can be used to correct mistakes or incomplete information in ID3 tags. On GNU/Linux, the program **Ex Falso** ([http://code.google.com/p/quodlibet/](http://code.google.com/p/quodlibet/) "http://sourceforge.net/projects/dr14tmeter/")) can be useful for batch setting and editing ID3 tags before importing files into your LibreTime server. On a Debian or Ubuntu desktop machine, you can install this program with the command: +There are a number of programs available which can be used to correct mistakes or incomplete information in ID3 tags. - sudo apt-get install exfalso +| Windows | macOS | Linux | +|---------|-------|-------| +| [Mp3tag](https://www.mp3tag.de/en/index.html) | [MusicBrainz Picard](https://picard.musicbrainz.org/) | [Ex Falso](http://code.google.com/p/quodlibet/) | +| [TagScanner](https://www.xdlab.ru/en/) | | | -After installation, you can run this program with the command: - - exfalso - -or from the desktop menu. The *Tags From Path* feature of this program is a particularly useful time saver if you have a large archive of untagged files. Sometimes there is useful creator or title information in the file name or directory path structure, which can be converted into an ID3 tag automatically. +The *Tags From Path* feature of Ex Falso is a particularly useful time saver if you have a large archive of untagged files. Sometimes there is useful creator or title information in the file name or directory path structure, which can be converted into an ID3 tag automatically. ![](img/Screenshot175-Ex_Falso.png) -# Metadata in legacy character sets +## Metadata in legacy character sets LibreTime expects file tag metadata to be stored in the international *UTF-8* character set. Programs such as **Ex Falso** (described above) encode metadata in UTF-8 by default. If you have an archive of files encoded with metadata in a legacy character set, such as the Cyrillic encoding *Windows-1251*, you should convert these files before import. @@ -56,7 +55,7 @@ CP1254: Turkish CP1255: Hebrew CP1256: Arabic -# Audio loudness +## Audio loudness On file ingest, LibreTime analyzes each Ogg Vorbis, MP3, AAC or FLAC file's loudness, and stores a *ReplayGain* value for that file in its database. At playout time, the ReplayGain value is provided to Liquidsoap so that gain can be automatically adjusted to provide an average output of -14 dBFS loudness (14 decibels below full scale). See for more details of ReplayGain. @@ -88,7 +87,7 @@ And here is an example of a very loud file, with lower crest factor, where the o In the output from vorbisgain, *Peak* is the maximum sample value of the file before any ReplayGain has been applied, where a value of 32,767 represents full scale when decoding to signed 16 bit samples. Note that lossy compressed files can have peaks greater than full scale, due to encoding artifacts. The *New Peak* value for the Snoop Dogg file may be relatively low due to the hard limiting used in the mastering of that piece of music. -# Silence in media files +## Silence in media files Before importing media, it is good practice to check for any silent sections in the media files. While LibreTime compensates for leading and trailing silence with the use of automatic cue-in and cue-out points****, it may be preferable to trim these files to the intended length before upload. This is because media in the LibreTime library could potentially be re-used in many different systems. **Audacity** is a cross-platform editor suitable for the task of trimming audio files, available from [http://audacity.sourceforge.net/](http://audacity.sourceforge.net "http://sourceforge.net/projects/dr14tmeter/") diff --git a/docs/preparing-the-server.md b/docs/preparing-the-server.md index 207a0344a..a32912b73 100644 --- a/docs/preparing-the-server.md +++ b/docs/preparing-the-server.md @@ -62,15 +62,17 @@ Setting up a local firewall is done differently on all the supported distros. * [Debian](https://wiki.debian.org/DebianFirewall) * [FirewallD](http://www.firewalld.org/) (CentOS) * [Ubuntu](https://help.ubuntu.com/lts/serverguide/firewall.html) - * To quickly configure Ubuntu's firewall, `ufw`: - ``` + +To quickly configure Ubuntu's firewall, `ufw`: + +``` sudo ufw enable sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 8000/tcp #only if streaming from your server sudo ufw allow 8001/tcp #only if DJs will be directly connecting to stream in ports, also include 8002/tcp sudo ufw status #to check setup - ``` +``` There are a vast amount of ways to configure your network, firewall included. Choose the way that best fits your deployment and don't expose internal parts of your diff --git a/docs/reverse-proxy.md b/docs/reverse-proxy.md index 3943accd4..438404b3e 100644 --- a/docs/reverse-proxy.md +++ b/docs/reverse-proxy.md @@ -15,7 +15,7 @@ domains that will be used externally to connect to your reverse proxy that you want handled by LibreTime. These URLS can also be set during the first run configuration that is displayed when you first install LibreTime -# Reverse Proxy Basics +## Reverse Proxy Basics A reverse proxy allows the LibreTime server to not be connected to the open internet. In this configuration, it is rather behind another server that proxies traffic to it from diff --git a/docs/setting-the-server-time.md b/docs/setting-the-server-time.md index 071f59914..bac536aab 100644 --- a/docs/setting-the-server-time.md +++ b/docs/setting-the-server-time.md @@ -4,7 +4,7 @@ title: Setting the Server Time --- -# Setting the server time +## Setting the server time Accurate time keeping on your server is vital for LibreTime performance. You can confirm that the date and time of your server are set correctly with the **date** command: @@ -16,7 +16,7 @@ The server should respond with the date, time, time zone and year in a format si If the time on your server is wrong, it is recommended that you take LibreTime off-air until the problem is fixed. -# Configuring NTP +## Configuring NTP Although it is possible to set the date and time of the server manually, this is not recommended because the server clock can drift over time, compromising the accuracy of your broadcast schedule. If your LibreTime server is permanently connected to the Internet, you can synchronize your server to a time server with the **ntp** ** program. If **ntp** is not yet installed, you can enter the following command on Debian or Ubuntu: @@ -55,7 +55,7 @@ Then use the **ntpq -p** command to confirm that **ntp** is working. This comman ntppub.le 158.43.192.66  2 u   91   64    2 122.781  44.864  0.001 dns0.rmpl 195.66.241.3   2 u   27   64    3  22.171   1.464  4.242 -# Adjusting the server time zone +## Adjusting the server time zone The data centre which hosts your LibreTime server could be located anywhere in the world. Some servers are set to *Coordinated Universal Time* or UTC (similar to *Greenwich Mean Time* or GMT), regardless of their location. LibreTime uses UTC time in its database for scheduling purposes, independent of the server time zone. diff --git a/docs/ssl-config.md b/docs/ssl-config.md index ae7c903d4..1ed402de5 100644 --- a/docs/ssl-config.md +++ b/docs/ssl-config.md @@ -74,47 +74,47 @@ 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. ``` - - SSLEngine on - SSLProtocol All -SSLv2 -SSLv3 - SSLCompression off - SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem - SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key - Header always set Strict-Transport-Security "max-age=31536000" + + SSLEngine on + SSLProtocol All -SSLv2 -SSLv3 + SSLCompression off + SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem + SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key + Header always set Strict-Transport-Security "max-age=31536000" - ServerName airtime.example.com - #ServerAlias www.example.com + ServerName airtime.example.com + #ServerAlias www.example.com - ServerAdmin admin@example.com + ServerAdmin admin@example.com - DocumentRoot /usr/share/airtime/php/airtime_mvc/public - DirectoryIndex index.php + DocumentRoot /usr/share/airtime/php/airtime_mvc/public + DirectoryIndex index.php - - Options -Indexes FollowSymLinks MultiViews - AllowOverride all - Order allow,deny - Allow from all - - + + Options -Indexes FollowSymLinks MultiViews + AllowOverride all + Order allow,deny + Allow from all + + - - ServerName airtime.example.com + + ServerName airtime.example.com - ServerAdmin admin@example.com + ServerAdmin admin@example.com - DocumentRoot /usr/share/airtime/php/airtime_mvc/public - Redirect permanent /login https://airtime.example.com/login + DocumentRoot /usr/share/airtime/php/airtime_mvc/public + Redirect permanent /login https://airtime.example.com/login - SetEnv APPLICATION_ENV "production" + SetEnv APPLICATION_ENV "production" - - Options -Indexes FollowSymLinks MultiViews - AllowOverride All - Order allow,deny - Allow from all - - + + Options -Indexes FollowSymLinks MultiViews + AllowOverride All + Order allow,deny + Allow from all + + ``` Save the file with **Ctrl+O** and exit the **nano** editor with **Ctrl+X**. Then restart Apache with the command: