Différences

Ci-dessous, les différences entre deux révisions de la page.

--- technique:adminserv:sites:mise_a_jour_de_radio.picasoft.net [2022/04/15 20:42] – crozatst
+++ technique:adminserv:sites:mise_a_jour_de_radio.picasoft.net [2022/04/17 08:29] (Version actuelle) – rdelaage
@@ Ligne 1: / Ligne 1: @@
 {{indexmenu_n>20}}
 # La voix est libre (radio.picasoft.net)
-# ! Section obsolète : site en cours de migration vers le service podcast.picasoft.net
-Les émissions de *La voix est libre* sont diffusées le vendredi à 9h30 par la radio associative Graf'hit, sur la fréquence 94.9FM aux alentours de Compiègne, et sur https://grafhit.net.
 <bootnote critical>
-Penser également à mettre en ligne sur le podcast sur [[technique:adminserv:castopod:nouvel_episode|Castopod]].
+Radio redirige désormais vers [[technique:adminserv:castopod:nouvel_episode|Castopod]]. Il faut donc publier les épisodes à l'aide de Castopod.
-</bootnote>
-La mise à jour du site de *La voix est libre* s'effectue en 3 étapes :
-  - Téléverser le `mp3` de l'émission sur https://culture.picasoft.net
-  - Éditer un nouveau billet dans l'espace `radio` de l'atelier Scenari `picasoft-optim` (explications [ici](https://doc.picasoft.net/modules/scenari01/co/scenari01.html))
-  - Publier le site
-Une fois le site mis à jour, une bonne pratique est d'annoncer la nouvelle émission sur Mastodon avec le [compte de Picasoft](https://mamot.fr/@picasoft) (les identifiants sont  [[technique:adminsys:secu:password_store:start|sur le pass]]).
-## Ajout du podcast sur culture.picasoft.net
-On peut récupérer le podcast sur https://podcast.grafhit.net (Graf'hit met en ligne l'émission du jour dans la matinée).
-Ensuite, on [[technique:adminserv:sites:update_from_archive|rajoute ce fichier au site Culture]], dans son dossier `/var/www/html/audio/la-voix-est-libre`.
-## Édition d'un nouveau billet
-Depuis un client Scenari [connecté au serveur de l'UTC](https://doc.picasoft.net/modules/scenari01/co/scenari01.html), se rendre dans l'atelier `picasoft-optim`.
-Ouvrir le dossier `radio`. Les billets composant le site apparaissent, ainsi que l'item Blog `radio.webpage`, l'item Site web `radio.website`, et l'espace `re` contenant des ressources multimédias intégrées au site.
-### Créer un billet
-Pour éditer un nouveau billet, il est possible de créer un nouvel item Billet, mais, les billets ayant tous une structure similaire, on peut se faciliter la tâche en dupliquant un billet précédent. Cela permet d'en réutiliser le plan et les contenus récurrents (comme les crédits du générique de l'émission), au lieu de repartir de zéro à chaque nouveau billet.
-Pour cela : clic droit sur un billet, `Copier`, nouveau clic droit sur un billet (plus exactement, à n'importe quel endroit dans l'espace `radio`), et `Coller(dupliquer)`.
-### Effectuer les modifications mineures
-Après avoir créé un nouveau billet par duplication d'un précédent, il est nécessaire de modifier :
-* Son nom : choisir la date de publication au format `AAAA-MM-JJ.object`
-* Son titre
-* Sa date de publication
-* L'URL du lien `Écouter` dans le premier bloc `Graf'hit 94.9FM`. Pour cela : clic droit sur le lien, `Propriétés > Adresse web, email, lien vers un document externe`, et modifier l'URL avec le nom du fichier mp3 ajouté sur https://culture.picasoft.net à l'étape 1.
-<bootnote warning>Ce lien doit rester le premier lien du billet. Il ne faut donc pas déplacer ce bloc plus bas dans le billet. Cette condition est nécessaire à l'ajout du lien dans le tag `<enclosure>`, lors de la mise à jour du flux RSS.</bootnote>
-* Si l'April a mis à disposition une retranscription (l'APRIL vous contactera le cas échéant), ajouter un lien.
-* La musique : dans le Bloc mis en relief `La musique`, changer le titre (terme mis en relief, apparaît en gras), l'artiste (terme spécifique, apparaît en italique), l'intitulé et le contenu du lien vers le mp3, la licence ainsi que le lien vers sa page web.
-* La date d'enregistrement (dernier bloc)
-### Rédiger les blocs `L'interview`, `L'échange`, `Les notes`, `Le quiz`, `Les liens`
-Pour chaque bloc, supprimer l'ensemble du contenu, correspondant au billet dupliqué.
-#### L'interview :
-Écrire le nom de l'invité⋅e, ainsi qu'une présentation en une ou deux lignes. Mettre en relief ce texte : le sélectionner, clic droit, `Insérer dans le paragraphe > Mise en relief`.
-Lister les questions posées à l'invité⋅e : créer une liste à puce en appuyant sur `CTRL + L` .
-#### L'échange
-Écrire le plan suivi (`CTRL + O` pour créer une liste ordonnée) ou la liste des sujets abordés (en général sous forme de questions).
-#### Les notes
-Pour conserver la préparation rédigée sur [le pad](https://pad.picasoft.net/p/la-voix-est-libre), copier celle-ci dans le bloc `Les notes`, et veiller à ce que les 3 icônes `Exclusion du support web`, `Exclusion du support de présentation` et `Exclusion du support papier` soient recouvertes d'une croix rouge. Ainsi, ces notes n'apparaîtront pas sur ces supports, dont le site web.
-#### Le quiz
-Si l'émission comprend un quiz, en écrire l'énoncé et les propositions sous forme de liste ordonnée. La réponse est réservée aux auditeur⋅ices…
-#### Les liens
-Ajouter les références abordées pendant l'émission : donner un nom au lien, copier l'URL (sans le `https://` et raccourcie à l'essentiel, c'est plus joli) et ajouter l'url entière dans la propriété `Adresse web, email, lien vers un document externe`.
-#### Transcription
-Si l'April a mis à disposition une retranscription (l'APRIL vous contactera le cas échéant), ajoutez un bloc transcription (cliquer sur l'étoile rouge à gauche au dessus du bloc "la musique"), copiez le texte d'une émission qui contient une transcription (par exemple l'émission du 17/05/2019) et ajoutez le titre "transcription" .
-### Enregistrer
-Le billet est prêt, le plus gros est fait !
-### Ajouter le nouveau billet au site
-Double-cliquer sur l'item Blog `radio.webpage` pour l'ouvrir. Cliquer sur l'astérisque située juste au-dessus du premier billet de la liste afin d'insérer le nouveau billet : clic sur `Billet`. Un nouvel élément `Billet` est ajouté. Clic droit sur la croix rouge : `Sélectionner un item`. Sélectionner l'item en `.object` correspondant au nouveau billet. Enregistrer.
-----
-Enfin, quelques astuces pour cette étape :
-* Explorer les possibilités d'enrichissement du texte, disponibles via un clic droit et le choix d'`Insérer dans le paragraphe` : tout mot ou ensemble de mots peut être mis en relief, en citation, en indice, en terme spécifique, en label d'un lien… pour supprimer une ou plusieurs de ces propriétés : clic droit sur le terme, `Éliminer du paragraphe`, puis choisir la propriété à supprimer.
-* Penser à sauvegarder ses modifications régulièrement : `CTRL + S`
-* Pour insérer un bloc, cliquer sur l'astérisque située sur la position souhaitée, et sélectionner un type de bloc. Un clic droit ouvre le menu pour déplacer le bloc, en changer le type, le supprimer ou y ajouter un commentaire en en-tête.
-## Publication
-### Permettre la mise à jour du flux RSS
-La mise à jour du site s'accompagne d'une mise à jour de son flux RSS. Ainsi, les personnes abonnées au flux RSS de La voix est libre sont automatiquement informées de la publication d'un nouvel épisode.
-Un flux RSS est un fichier au format `xml`. Le flux RSS de La voix est libre est accessible [à cette adresse](https://radio.picasoft.net/co/radio.xml).
-Sa mise à jour consiste en l'ajout d'un nouveau tag `<item>` correspondant au nouveau billet publié. Un tag `<item>` comprend les tags `<title>` (titre de l'émission), `<link>`(lien vers la page correspondant au billet sur radio.picasoft.net), `<pubDate>`(date et heure de publication renseignées dans le billet), `<managingEditor>` (adresse mail de Graf'hit, pour publication sur site de podcasts et récolte de statistiques) et `<content:encoded>`(contenu du billet en HTML) et `<enclosure>`. Ce dernier tag contient le lien vers le `mp3` de l'émission.
-Afin d'ajouter les tags `<enclosure>` et `<managingEditor>` dans le flux RSS, il est nécessaire d'**installer sur sa machine locale le processeur XSLT : effectuer `apt install xsltproc`.**
-<bootnote question>Pourquoi ces tags doivent être rajoutés "à la main" ?</bootnote>
-Il semblerait que Scenari ne soit pas capable d'ajouter des tags "personnalisés" au flux RSS qu'il génère ; il faut faire l'opération nous même.
-Pour ce faire, avant chaque publication, **télécharger le fichier `radio.xsl` (https://gitlab.utc.fr/picasoft/projets/website/raw/master/radio.xsl) dans `/tmp`**. (Ce fichier contient les règles que doit suivre le processeur XSLT pour ajouter le nouveau tag `<enclosure>` dans le fichier https://radio.picasoft.net/co/radio.xml.)
-### Générer le site
-Ouvrir l'item `radio.website`. Dans l'onglet `Aperçu`, cliquer sur la liste déroulante affichant `Boxed` et choisir le thème `Fool Skin`, pour avoir un aperçu fidèle au site tel qu'il sera publié. Vérifier que le billet est bien ajouté, et que le billet s'affiche comme attendu. Si le site est prêt à être publié, se rendre dans l'onglet `Publi`, vérifier que le thème `Fool Skin` est bien sélectionné, et cliquer sur `générer`. Il est possible de consulter à nouveau un aperçu du site, dans son navigateur, en cliquant sur `consulter`.
-Télécharger le site généré dans un répertoire quelconque, par exemple `/tmp`.
-Depuis `/tmp`, générer le flux RSS correct, avec la commande :
-```bash
-unzip radio_gen_site.zip -d radio
-xsltproc radio.xsl radio/co/radio.xml > radio.xml
-cp radio.xml radio/co/radio.xml
-```
-Puis [[technique:adminserv:sites:update_from_archive|transférer le dossier radio sur le serveur web]].
-<bootnote>
-Le script qu'utilise Stéphane. À supposer que le site généré se trouve dans `/tmp` ainsi que `radio.xsl`. Penser à remplacer `<user>` :
-```
-# Pour publier :
-cd /tmp &&
-unzip -uo radio_gen_site.zip -d radio &&
-xsltproc radio.xsl radio/co/radio.xml > radio.xml &&
-cp radio.xml radio/co/radio.xml &&
-rsync -va radio/* <user>@pica01.picasoft.net:/tmp/radio &&
-ssh  <user>@pica01.picasoft.net "docker cp /tmp/radio/. radio:/var/www/html && docker exec radio chown -R www-data:www-data /var/www/html && chmod 777 -R /tmp/radio"
-```
 </bootnote>