chore: clean old docs files (#2132)

docs/_interface-customization.md

@@ -1,41 +0,0 @@
----
-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 so, open one of the CSS files in the `/public/css/` directory under the LibreTime _DocumentRoot_ directory in an editor such as `nano`:
-
-```bash
-sudo nano /usr/share/airtime/public/css/styles.css
-```
-
-To change the background colour of the administration interface from dark gray to white, the _background:_ property of the body tag could be changed to `#ffffff` as follows:
-
-```css
-body {
-  font-size: 62.5%;
-  font-family: Arial, Helvetica, sans-serif;
-  background: #ffffff;
-  margin: 0;
-  padding: 0;
-}
-```
-
-Save the file with **Ctrl+S**, then refresh your browser to see the change to the interface background colour.
-
-Any custom changes that you make to the administration interface should be backed up before upgrading LibreTime to a newer version, otherwise they could be overwritten. If you have made improvements that you think might be useful to other LibreTime users, please contact LibreTime and tell us about them.
-
-# Modifying the Icecast interface
-
-If you have installed Icecast, in the directory `/etc/icecast2/web/` you will find several XSLT and other files which are used to generate the Icecast web interface. If you are familiar with HTML you should be able to modify these pages, as they're well commented. You do have to be careful with syntax, because something as simple as a missing bracket can cause the Icecast web interface to break down.
-
-For example, you could change the `status.xsl` page:
-
-```bash
-sudo nano /etc/icecast2/web/status.xsl
-```
-
-Modifying the `status.xsl` page is a good place to start, because this is the default page that site visitors see when they browse port 8000 on your Icecast server. The most obvious change to make in the XSLT pages is the content of the _<title>_ and _<h2>_ tags, to announce the name of your station. You can also modify the `style.css` file in this directory to change colour and layout options.
-
-After saving the file with Ctrl+O, refresh your web browser, and the new look should now be visible.
-
-![](/img/Screenshot177-Icecast_rocks.png)

docs/_interface-localization.md

@@ -1,59 +0,0 @@
----
-title: Interface localization
----
-
-The LibreTime administration interface can be localized using the standard GNU **gettext** method. Using GitHub for this task means you don't have to tackle the whole of a localization yourself; just as much as you can manage.
-
-![](/img/Screenshot464-Korean_stream_setting.png)
-
-First, you should check if a localization is already under way for your locale of choice. The best way to do this is to take a look at the 'main' branch in the GitHub repository for LibreTime at https://github.com/libretime/libretime. You can also ask in the LibreTime development forum at https://discourse.libretime.org/, where you might find community members who can help you with the translation.
-
-GNU **gettext** means using a .po file for each language or dialect, a specially formatted plain text file with groups of three or more lines, like this example from LibreTime's Korean localization:
-
-```
-#: legacy/application/configs/navigation.php:57
-msgid "Media Folders"
-msgstr "미디어 폴더"
-```
-
-The first of these three lines starts with the hash symbol, and references where this string of text is found in the source code by its file name and line number. If this string is found more than once in the source code, you will see other reference lines here. The second line contains the **msgid**, which is the original version of the string. The third line contains the **msgstr**, which is the translation of that string for the localization that this particular .po file relates to.
-
-If you use the cross-platform program **Poedit** (https://www.poedit.net/) to edit the .po file, this formatting of the text is hidden by an easy-to-use GUI. The _poedit_ package can be installed on most GNU/Linux distributions using the standard software installer. Versions of Poedit for Mac and Windows are available for free download from the project's homepage.
-
-Before manually translating strings in Poedit from scratch, you should take a look at the online translation services available, such as Lingohub (https://lingohub.com), which both support gettext .po files. If using automatic translation, you can then use Poedit to fine-tune the localization and fix any formatting errors.
-
-If you don't already have a GitHub account, you can sign up at https://github.com/signup/free. Once you have a GitHub account, you can fork a copy (https://help.github.com/articles/fork-a-repo) of the LibreTime project. Work for the next major version of the software is done in the **main** branch of each project, so that's the branch to **checkout** after you have made the initial **git clone**.
-
-In the locale code _de_CH_, for example, _de_ represents the German language and the suffix _\_CH_ indicates the dialect spoken in Switzerland. Some languages have a wide variety of dialect localizations, which can be differentiated with a suffix in this way. You should update the header information in the .po file, which includes the language code and a country code, using one of the existing .po files as a guide.
-
-After forking the LibreTime git repository, make sure you're in the **main** branch:
-
-```bash
-git branch
-  devel
-* main
-```
-
-Create a new locale directory (e.g. `legacy/locale/de_CH/LC_MESSAGES/` for German as spoken in Switzerland):
-
-```bash
-mkdir -p legacy/locale/de_CH/LC_MESSAGES/
-```
-
-Copy the template `airtime.po` file into the directory you just created:
-
-```bash
-cp legacy_locale/template/airtime.po legacy/locale/de_CH/LC_MESSAGES
-```
-
-and update the header information in the new copy of the `airtime.po` file using the **nano** editor:
-
-```bash
-nano legacy/locale/de_CH/LC_MESSAGES/airtime.po
-```
-
-After using an online translation tool to begin a new localization, you can load the exported .po file into Poedit and complete your translation there. Enter the localization team's contact information and language into Poedit's **Edit -> Preferences** and **Catalog -> Settings** dialogs, which will be added to the .po file. When you save a .po file in Poedit, the corresponding binary .mo file will be compiled automatically.
-
-Finally, **git add**, **git commit** and **git push** these new .mo and .po files to your GitHub fork of the project, and send a git pull request (https://help.github.com/articles/using-pull-requests) to the LibreTime developers. The localization can then be added to a forthcoming LibreTime release.
-
-If you don't want to work with git, that's no problem - download a copy of the .po template file, edit the header, run it through an automatic translator and check it with Poedit. Then email your contribution to the LibreTime team as an attachment - it will be very welcome! However, learning to use git is a good idea, because it means you can work directly on the current source code, share the localization work with the LibreTime community, and avoid duplicated effort.

docs/_microsite.md

@@ -1,26 +0,0 @@
----
-title: Built-in microsite
----
-
-![](/img/radio-page.png)
-
-LibreTime includes a microsite, which can be accessed at _serverIP_ or a domain you've set up for your server. The site includes your
-logo and station description (set under Settings > General), the login button to the LibreTime interface, the schedule for the next seven days,
-podcast tabs, and a live feed of your station with information on the currently playing artist and track.
-
-## Modifying the LibreTime radio page
-
-The background of the mini-site that appears when you visit the server's domain in your web browser can be changed by modifying the page's CSS file, located at `/usr/share/airtime/php/legacy/public/css/radio-page/radio-page.css`.
-
-```css
-html {
-  background: url("img/background-testing-3.jpg") no-repeat center center fixed;
-  -webkit-background-size: cover;
-  -moz-background-size: cover;
-  -o-background-size: cover;
-  background-size: cover;
-  overflow-y: auto;
-}
-```
-
-Place the new background image in the `/usr/share/airtime/php/legacy/public/css/radio-page/img/` folder and change the `background:` entry's URL to point to the new image. The new image should be at least 1280 x 720 in pixel size to avoid being blurry.