ActiveRenderer tutoriel 4

activeRenderer tutoriel- partie 4

Etape 1: Créez un document de type bloc de liens.

En accord avec la définition de Jake Savin, les blogRolls sont des collections de liens, publiés sur la page d'accueil d'un carnet web, pointant vers les sites qui sont, sous une forme ou une autre, en relation avec le votre.

Ils dirigent les lecteurs vers les sites que vous considérez comme importants et vous servent, accessoirement, de listes de liens favoris.

Ils aident aussi à améliorer la visibilité dans les moteurs de recherches des sites dont vous affichez les liens.

Aussi votre premier usage du générateur de plans de Radio peut être de créer un document OPML avec vos liens.

Voici une copie d'écran de la version originale. (cliquez sur le pivot, en forme de petit triangle, qui se trouve à gauche pour afficher la version actuelle de cette page).

et voici une copie d'écran du même plan, dans la barre de menu qui se trouve à droite de la page d'accueil de Slam.

Généralement, les blogRolls sont organisés en section, le titre de chaque section étant un noeud, un sommet, dont les liens entretenant quelques parentés sont des paragraphes indentés en-decà.

Les liens sont actuellement des noeuds correspondant à la balise attribut XML link.

Dans le générateur de plans de Radio, vous pouvez définir un attribut lien en sélectionnant un noeud dans le plan, puis en ouvrant l'élément de menu 'Outline/Add Link', pour enfin frapper au clavier ou coller une adresse URL (une adresse Web) pour constituer ce lien.

Vous pouvez enregistrer votre plan blogRoll sous un nom quelconque terminé par le suffixe '.opml'.

Rien ne vous interdit de créer plusieurs blogRolls, avec différents noms de fichier.

Si vous créez un fichier blogRoll.opml et l'enregistrez dans le sous-dossier gems de votre dossier www, vous serez en conformité avec les recommandations de UserLand.

Votre blogRoll sera automatiquement scanné si vous utilisez la macro HeadLinks de UserLand.

Etape 2: Insérez un appel de macro activeRoll dans votre modèle principal.

Ouvrez, avec un éditeur de texte, le fichier #homeTemplate.txt qui se trouve dans le dossier www de Radio.

Trouvez un bon emplacement pour insérer la macro activeRoll.

Le bon emplacement est généralement dans la barre de menus, à gauche ou à droite de votre modèle.

Insérez une ligne, telle que celle que vous voyez dans la copie d'écran attachée à ce noeud, en subsituant le chemin d'accès de votre propre fichier blogRoll.

Sur un système Windows, l'adresse URL locale ressemblera à ceci:

file:///C/Program%20Files/Radio%20UserLand/www/gems/blogroll.opml

Ou à cela, si vous faites référence au fichier de votre site public:

http://radio.weblogs.com/0104487/gems/opml/blogroll.opml

Vous pouvez, et devriez, choisir un autre texte pour le titre du blogRoll, le titre "activeRoll" étant seulement un exemple.

Si vous ne fournissez pas d'argument de titre à la macro, votre bolgRoll sera quand même généré, mais sans titre.

important: si vous ne publiez pas actuellement le page d'accueil de votre carnet Web avec un des deux styles de plan d'activeRenderer.

Et ne l'avez fait à aucun moment, dans le passé.

Alors, il y a de fortes chances pour que votre fichier #homeTemplate.txt ne contiennent pas, dans son en-tête, de liens vers les codes JavaScript et vers la feuille de style CSS.

Aussi, insérez un appel de la macro activeRendererHeader dans la section HEAD de votre modèle. Voir la copie d'écran ci-jointe.

Etape 3: Re-publiez votre page d'accueil et vérifiez le résultat.

Sélectionnez l'élément de menu Weblog Home Page du menu Radio/Publish de l'application Radio.

Ensuite, consultez votre journal des évènements après, environ, une minute, et cliquez sur le lien index.html dans le dernier évènement de copie, où il devrait être listé parmi les dernières copies effectuées sur le site public.

Etape 4: Personnalisez le style de votre bloc de liens.

Tous les éléments du bloc de liens sont définis avec des classes CSS, dans la feuille de style outliner.css.

Vous trouverez outliner.css dans le sous-dossier activeRenderer du dossier gems, lui-même intégré dans le dossier www.

Pour en connaitre plus sur les feuilles de style CSS, consultez:

http://safari.oreilly.com/main.asp?bookname=css

les spécifications W3C

rollTitle définit le style de l'élément titre de votre bloc de liens.

roll définit le style du bloc -une balise div HTML - dans lequel le bloc de liens est emboité.

roll1 jusqu'à roll4 définissent le style de chaque niveau d'indentation du bloc de liens.

Vous êtes libre d'ajouter d'autres niveaux d'indentation, si besoin est.

rollHelp définit le style du lien 'how this work' ('comment cela fonctionne').

Si vous personnalisez la feuille de style outliner.css, faites une mise à jour du numéro de version (actuellement 1.0.4), au sommet du fichier, avec une valeur supérieure, comme je l'ai fait.

En faisant ainsi, votre version personnalisée ne sera pas écrasée automatiquement la prochaine fois que je mettrai à jour la feuille de style disponible par défaut dans activeRenderer.

Etape 5: Utilisez les paramètres optionnels d'activeRenderer.

Dans l'étape précédente, vous avez appris que le style par défaut de votre blogroll est défini avec des classes CSS dont les noms commencent par roll.

Vous pouvez spécifier un autre nom lors de l'appel de la macro activeRoll dans votre modèle.

Dans l'exemple attaché, le titre -Navigation- aura un style navsLinksTitle, le bloc du blogRoll sera défini dans navLinks, les niveaux d'indentation commenceront à navLinks1.

De cette manière, vous pouvez avoir plusieurs activeRolls avec différents styles sur la même page.

Si vous êtes Rick Klau, et insérez votre blogroll dans une balise iframe HTML, vous pouvez spécifier un paramètre optionnel de cible:"_parent" pour avoir tous les liens dans votre principale frame.

Cela fonctionnera même si votre nom n'est pas Rick Klau.

Vous n'avez même pas l'obligation d'être avocat, quoique cela aide...

Vous pouvez aussi utiliser la cible:"unNomQuelconqueDeFenêtre" pour avoir tous les liens ouverts dans une même fenêtre distinct.

Par défaut, tous les liens de votre blogroll s'ouvre dans une nouvelle fenêtre.

Les activeRolls sont semblables aux blogRolls (blocs de liens); avec un avantage: la possibilité de déployer et refermer les niveaux d'indentation des collections de liens améliore sensiblement la lisibilité.

Maintenant, vous devriez être convaincu de la facilité d'intégrer les activeRolls (blocs de liens) à votre carnet Web. Mais attendez, ne serait-il pas encore plus agréable de pouvoir publier, dans un activeRoll, les liens favoris de votre navigateur, et même directement vos favoris Yahoo ? Consultez le Tutoriel 5 pour cela.

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

document original: Tutoriel 4

adaptation: Le Dréan Gwénaël (les commentaires, critiques et suggestions sont bienvenus ;-))

opml 1.0
mise à jour: 11/03/06; 16:49:02

accueil

tout fermer
tout déployer

prévisualiser
cacher les onglets

comment cela fonctionne

feedster et activerenderer

Pas de fil RSS trouvé à http://www.feedster.com/rss.php?q=activerenderer

comment cela fonctionne

Aide activeRenderer

Tutoriels

Tutoriel 4 - activeRoll

Tutoriel 5 - signets

Tutoriel 6

Tutoriel 7 - transclusion

Tutoriel 8 - rssBox

Divers

FAQ

Annexes

Assistants

rssBox

A propos de...

Radio Userland

WebOutliner

comment cela fonctionne

nouvelles d'activeRenderer

Impossible de retrouver http://www.activerenderer.com/rss.xml - erreur: Can't open stream because TCP/IP error code -3259 - Connection timed out.

comment cela fonctionne

blogdigger et activerenderer

(No Title)

amy, i believe those icons came from the fabulous Radio UserLand tool, activeRenderer. marc, the creator of the tool has been down this icon node path already. that's party why i pointed to that page. i guess i should be joining in the fun on the email list. unfortunately, activeRenderer site isn't ...

6/03/06 - 10:25 pm GMT

(No Title)

i wonder if marc has abandoned activerenderer? site is down. i was going to look to it for prior art regarding inclusion links for our outline nodes. he's been down this path already and had individual node type icons already whipped Up.

was really cool....

6/03/06 - 5:12 pm GMT

(No Title)

take a gander at my outline based production notes for iceplant radio. here's the OPML file i created them in. it was cool and i used radio userland to do it. i created my outline in radio and saved it as an opml file. activerenderer took that file and rendered it into a neat collapsible web page. i...

6/03/06 - 4:54 pm GMT

Coolness is starting to flow out of Yahoo

I ran into Joy Mountford the other day in Yahoo's cafeteria - at the salad bar (yes - I'm starting to eat salad....).

She's working for her old boss - Larry Tessler.

Not sure if it's Joy or any of her team - but we discovered a couple of coolio user interface widgets yesterday - which are part of th...

Coolness is starting to flow out of Yahoo

I ran into Joy Mountford the other day in Yahoo’s cafeteria - at the salad bar (yes - I’m starting to eat salad….).[sgl dagger] She’s working for her old boss - Larry Tessler.

Not sure if it’s Joy or any of her team - but we discovered a couple of coolio user interface widgets yes...