ad-alta-voce/README.md

88 lines
2.2 KiB
Markdown
Raw Permalink Normal View History

2021-01-10 20:13:54 +01:00
# Ad Alta Voce
Script per la generazione dei Feed Podcast di [Ad Alta Voce](https://www.raiplayradio.it/programmi/adaltavoce/).
## Utilizzo
### Installazione
Una volta scaricato il repository è possibile installare il programma tramite `stack` attraverso il seguente comando:
```bash
stack install
```
L'eseguibile può essere chiamato attraverso il comando `loud`.
### Generazione di un singolo podcast
È possibile generare il feed podcast di un audiobook tramite il seguente comando:
```bash
loud single <audiobook-url>
```
Una lista di tutti gli audiolibri di Ad Alta Voce può essere recuperata al seguente [link](https://www.raiplayradio.it/programmi/adaltavoce/archivio/audiolibri/tutte/).
### Generazione di tutti i podcast
È possibile generare in automatico tutti i feed podcast degli audiobook attraverso il seguente comando:
```bash
loud all
```
2021-01-28 14:31:58 +01:00
### Generazione indice
Attraverso il comando `all` è possibile generare anche un indice di tutti gli audiolibri generati attraverso il comando:
```bash
loud all --index
```
Inoltre attraverso il flag `--index-template` è possibile specificare il template [mustache](https://mustache.github.io/mustache.5.html) dell'indice.
2021-01-28 14:58:37 +01:00
Il file del template deve trovarsi nella working directory ed avere un del tipo `<nome>.<estensione>.mustache`.
2021-01-28 14:31:58 +01:00
I parametri del template sono:
- `entries`: lista dei feed podcast degli audiolibri
- `audiobook-file`: nome del file xml
- `audiobook-author`: autore dell'audiolibro
- `audiobook-title`: titolo dell'audiolibro
Di seguito è riportato un esempio di template html per l'indice.
```html
<html>
<head>
<title>Ad alta voce - Podcast non ufficiale</title>
<meta charset="utf-8" />
</head>
<h1>Lista audiobook</h1>
<ul>
{{#entries}}
<li><a href='{{audiobook-file}}'>{{audiobook-title}}</a> {{audiobook-author}}</li>
{{/entries}}
</ul>
</html>
```
### Help page
2021-01-24 15:35:00 +01:00
È possibile visualizzare le opzioni aggiuntive attraverso la *help page* richiamabile attraverso il seguente comando:
```bash
loud --help
```
## Utilizzo tramite stack
2021-01-24 15:35:00 +01:00
Alternativamente è possibile utilizzare `loud` attraverso `stack` senza doverlo installare.
In questo caso i comandi sono:
```bash
stack run -- single <audiobook-url>
stack run -- all
```
2021-01-24 15:35:00 +01:00