Ce qui suit est une liste des activités du code d'activeRenderer lors d'une installation ou une désinstallation, ainsi que lors d'une modification du modèle d'un carnet Web.
ce document est fait en vue de faciliter une correction d'erreur éventuelle, quoique improbable (mais on ne sait jamais), faite par activeRenderer dans votre carnet Web. Toutes ces étapes sont clairement identifiées, et accompagnées de commentaires, dans le code d'activeRenderer; les parties significatives, ainsi que les noms de fichiers et de dossiers sont écrits en style italique.
dernière mise à jour: 19/2/03 par MB pour la version 1.3.6
Lorsque Radio démarre: activeRenderSuite.install
1: Installe une table de préférences utilisateur prefs.activeRenderer dans weblogData.root.
2: Installe une table d'actualisation des paramètres user.rootUpdates. servers.activeRenderer dans Radio.root.
3: Fait une mise à jour d'activeRenderer si cet outil est enregistré et si la mise à jour automatique (auto-update) est cochée dans les Préférences.
4: Installe un appel au code activeRenderer de formatage (rendering) dans user.html.renderers (Radio.root).
5: Vérifie dans le sous-dossier Macros de l'application Radio s'il n'y a pas quelque installation de macros antérieures à la version 1.0 d'activeRenderer et les supprime.
6: Installe les appels aux macros d'activeRenderer dans user.html.macros (Radio.root).
Ces macros sont actuellement:`
7: Crée un dossier activeRenderer dans le dossier www/gems.
8: Crée ou met à jour le fichier de définition de styles CSS d'activeRenderer: outliner.css dans le dossier www/gems/activeRenderer.
9: Crée ou met à jour le fichier de code JavaScript d'activeRenderer: outliner.txt dans le dossier www/gems/ activeRenderer.
10: Crée ou met à jour les feuilles de style XSL d'activeRenderer: outliner_xsl.txt et outliner_js_xsl.txt dans le dossier www/gems/activeRenderer.
Ces fichiers sont utilisés pour générer les inclusions OPML.
11: Crée ou met à jour le fichier de code JavaScript d'activeRenderer: rslite.txt dans le dossier www/gems/activeRenderer.
Ce script est utilisé dans la page de configuration des activeBookmarks.
12: Crée les fichiers images des pivots dans le dossier www/gems/activeRenderer.
ol1.gif (pivot de noeud sans enfant)
ol2.gif (pivot d'expension)
ol3.gif (pivot de fermeture)
ol4.gif (pivot de lien OPML ou RSS)
ol5.gif (pivot de lien d'image)
ol6.gif (pivot de lien HTML)
ol7.gif (pivot de lien multimédia)
13: Crée le dossier outlines dans le dossier www.
14: Crée un fichier de déclaration de variables globales #prefs.txt dans le dossier www/outlines.
15: Crée ou met à jour un fichier modèle original #template.txt dans le dossier www/outlines.
16: S'il le trouve et que la préférence de copie automatique sur le site web est cochée, alors il copie le fichier OPML instant outline dans dossier www/outlines pour qu'il soit immédiatement généré sur le site public.
17: Crée un dossier www/gems/activeRenderer/backup si celui-ci n'existe pas.
18: Crée un dossier www/gems/activeRenderer/backup/custom si celui-ci n'existe pas.
Note: Jusqu'à ce point, aucun des modèles utilisés pour la publication du carnet Web n'a été modifié.
19: Seulement si la préférence 'Outline publication dates' ('publication de plan par date') est cochée (ce qu'elle n'est pas par défaut), le code modifie les modèles principaux du carnet Web, si besoin est.
19.1: Mise à jour du fichier www/#homeTemplate.txt pour insérer les liens vers le code JavaScript et la feuille de style CSS, ainsi que l'appel à la macro daySwitch.
Si la préférence displayLatest est de valeur false (faux), l'appel de daySwitch est évitée.
La version précédente est archivée dans le dossier www/activeRenderer/backup.
Voilà pour l'action de activeRendererSuite.utils.checkHomeTemplate.
19.2: Mise à jour du fichier www/#dayTemplate.txt si une nouvelle version est disponible et que le fichier courant #dayTemplate.txt est déjà un modèle généré par activeRenderer.
La version précédente est archivée dans le dossier www/activeRenderer/backup.
19.3: Mise à jour du fichier www/#itemTemplate.txt si une nouvelle version est disponible et que le fichier courant #itemTemplate.txt est déjà un modèle généré par activeRenderer.
La version précédente est archivée dans le dossier www/activeRenderer/backup.
20: Synchronise le plan des favoris, si besoin est.
21: Installe le code de désintallation dans la table scratchpad.activeRenderer (Radio.root).
22: Corrige les fichiers de préférences générés par liveTopics, si besoin est.
Toutes les étapes de l'installation sont consultables dans le journal des évènements de Radio (Event Log).
Lorsque vous cochez l'option 'Outline publication dates' dans la page des préférences d'activeRenderer: activeRendererSuite.gui.editPrefs.
1: Une déclaration d'appel du code JavaScript de outliner.txt est insérée dans la section d'en-tête du fichier www/#homeTemplate.txt, si ce n'est pas déjà fait.
Si le fichier #homeTemplate.txt doit être complètement modifié, la version originale est d'abord sauvegardée dans le dossier www/gems/activeRenderer/backup.
2: Un lien vers la feuille de style outliner.css est insérée dans la section d'en-tête du fichier www/#homeTemplate.txt, si ce n'est pas déjà fait.
3: Un appel à la macro daySwitch est insérée dans le corps du fichier www/#homeTemplate.txt, si ce n'est pas déjà fait, juste avant l'appel de la macro radio.weblog.drawcalendar.
L'appel à la macro daySwitch est évitée si la préférence displayLatest est de valeur false (faux).
Les étapes 1 à 3 font partie de l'activité de activeRendererSuite.utils.checkHomeTemplate.
4: Les déclarations de diverses variables globales sont ajoutées au fichier www/#prefs.txt, si elles ne s'y trouvent pas.
Les variables actuelles sont :
Si le fichier www/#prefs.txt doit être complètement modifié, sa version originale sera d'abord sauvegardée dans le dossier www/gems/activeRenderer/backup.
5: Toute version du fichier www/#dayTemplate.txt non transformée en plan est sauvegardée dans le dossier www/gems/activeRenderer/backup, puis remplacée par la version de style plan.
La nouvelle version correspond au modèle par défaut d'activerenderer, ou à votre propre modèle personnalisé, si celui-ci est trouvé dans le dossier www/gems/activeRenderer/backup/custom.
Lorsque vous cochez la préférence 'Outline individual posts' (c'est seulement possible si la case 'Outline publication dates' ('publication de plan par dates') est déjà cochée) : activeRendererSuite.gui.editPrefs.
Toute version du fichier www/#itemTemplate.txt non transformée en plan est sauvegardée dans le dossier www/gems/ activeRenderer/backup, puis remplacée par la version de style plan.
Toute version du fichier www/#itemTemplate.txt non transformée en plan est sauvegardée dans le dossier www/gems/ activeRenderer/backup, puis remplacée par la version de style plan.
La nouvelle version correspond au modèle par défaut d'activerenderer, ou à votre propre modèle personnalisé, si celui-ci est trouvé dans le dossier www/gems/activeRenderer/backup/custom
Lorsque vous décochez la préférence 'Outline individual posts' : activeRendererSuite.gui.editPrefs.
1: Si le fichier courant www/#itemTemplate.txt est une version de style plan, et que son numéro de version est supérieur au numéro de version du modèle par défaut d'activeRenderer, alors il est sauvegardé dans le dossier www/gems/activeRenderer/ backup/custom.
2: Si une version, non transformée en plan, du fichier www/ #itemTemplate.txt existe dans www/gems/activeRenderer/backup, elle est copiée dans www et remplace la version courante.
Lorsque vous décochez l'option 'Outline publication dates' dans la page des préférences d'activeRenderer: activeRendererSuite.gui.editPrefs.
1: Si le fichier courant www/#dayTemplate.txt est une version de style plan, et que son numéro de version est supérieur au numéro de version du modèle par défaut d'activeRenderer, alors il est sauvegardé dans le dossier www/gems/activeRenderer/backup/custom
2: Si une version, non transformée en plan, du fichier www/#dayTemplate.txt existe dans www/gems/activeRenderer/backup, elle est copiée dans www et remplace la version courante.
3: Même opération pour #itemTemplate.txt.
4: L'option 'Outline individual posts' est automatiquement décochée.
5: L'appel de la macro daySwitch dans www/#homeTemplate.txt est évitée, si ce n'était déjà pas fait.
Lorsque vous sélectionnez l'option de menu Tools / activeRenderer / Uninstal, ou si vous désélectionnez activeRenderer dans la page locale des outils de Radio, ou si vous déplacez le fichier activeRenderer.root hors du dossier Tools de Radio.
Réinstalle les modèles originaux, sans style plan, dans www, si un style de plan fut utilisé et si ces modèles originaux sont trouvés dans le dossier www/gems/activeRenderer/backup.
Lorsque vous déplacez le fichier activeRenderer.root hors du dossier Tools de Radio : scratchpad.activeRenderer.uninstal and scratchpad.activeRenderer.cleanup.
1: Réinstalle le fichier original #prefs.txt depuis le dossier www/gems/activeRenderer/backup vers le dossier www, s'il a été trouvé.
2: Déplace le dossier activeRenderer hors du dossier www/gems puis l'installe dans le dossier Radio Userland/activeRendererUninstalled/gems.
3: Supprime les liens vers les macros d'activeRenderer dans user.html.macros (Radio.root).
4: Supprime le lien vers le code de transformation (rendering) d'activeRenderer dans user.html.renderer (Radio.root).
5: Supprime la table des paramètres de mise à jour dans user.rootUpdates.servers (Radio.root).
6: Supprime la table des préférences d'activeRenderer dans les préférences de webLogData.root.
7: Supprime le code de désinstallation dans scratchpad de Radio.root.
note:
ce texte est une traduction, faite à un moment donné, du texte original, auquel il convient de se reporter pour prendre en compte les multiples mises à jour et pour ne pas se laisser égarer par de possibles erreurs de traductions.
auteur original: Marc Barrot
adaptation: Le Dréan Gwénaël (les commentaires, critiques et suggestions sont bienvenus ;-))