Initial commit

src/formats/playlists.md

@@ -0,0 +1,59 @@
+---
+icon: material/code-brackets
+tags: ["плейлисты"]
+---
+
+# :material-code-brackets: Формат файла `playlists.ini`
+
+Рассмотрим на примере:
+
+```ini
+[code]
+name = Рабочий автообновляемый IPTV плейлист M3U
+desc = "В этом IPTV плейлисте есть каналы в высоком качестве"
+pls = 'https://example.com/pls.m3u'
+src = 'https://example.com/super-duper-playlist'
+# комментарий 1
+; ещё один комментарий
+```
+
+Перенос строк невозможен.
+Комментарии игнорируются.
+
+Для значений можно (не) использовать 'одинарные' или "двойные" кавычки.
+Ради единообразия рекомендуется использовать 'одинарные'.
+
+## `code`
+
+Код плейлиста в рамках этого конфига (**обязательно**).
+
+Должен быть коротким и уникальным.
+
+Подставляется в короткую ссылку, по которой произойдёт переадресация на прямой адрес `pls`.
+
+!!! note
+    Для удобства ввода с пульта, код рекомендуется задавать числом или короткой строкой без пробелов и др. спецсимволов.
+    Чем короче, тем лучше.
+
+## `name`
+
+Название плейлиста (необязательно).
+
+По умолчанию: `Playlist #<code>`.
+
+## `desc`
+
+Краткое описание из источника или от себя (необязательно).
+
+По умолчанию: пусто.
+
+## `pls`
+
+Прямая ссылка на m3u/m3u8 плейлист (**обязательно**).
+
+## `src`
+
+Ссылка на источник (страницу сайта), откуда был взят плейлист (необязательно).
+
+По умолчанию: пусто.
+