xoxo-fr

2008-12-19T22:10:48Z

BogetEllet: covarbocoz

delsitc
<h1> XOXO 1.0 : eXtensible Open XHTML Outlines </h1>

XOXO est un simple format ouvert d'outline Ã©crit en XHTML standard et adaptable pour embarquement dans (X)HTML, Atom, RSS et le XML arbitraire.
XOXO est l'un des nombreux [[microformats-fr|microformats]] standards ouverts .

__TOC__

== SpÃ©cification Brouillon du 01-Octobre-2004 ==

=== Editeur ===
[http://tantek.com/ Tantek Ãelik], ([http://technorati.com Technorati, Inc])

=== Auteurs ===
* [http://epeus.blogspot.com/ Kevin Marks], ([http://technorati.com Technorati, Inc])
* [http://tantek.com/ Tantek Ãelik], ([http://technorati.com Technorati, Inc], formerly of [http://microsoft.com/ Microsoft Corporation])
* [http://diveintomark.org/ Mark Pilgrim], ([http://ibm.com IBM])
* [http://www.blogologue.com/ Morten W. Petersen]

=== Traducteur(s) ===
* [[Christophe Ducamp]]

=== Copyright ===
{{MicroFormatCopyrightStatement2003-fr}}

* [[User:Tantek|Tantek]] : Je "release" toutes mes contributions sur cette spÃ©cification dans domaine public et encourage les autres auteurs Ã faire de mÃªme.
** Quand tous les auteurs/Ã©diteurs auront fait ainsi, nous pourrons retirer le modÃ¨le MicroFormatCopyrightStatement de rÃ©fÃ©ence et le remplacer avec le modÃ¨le MicroFormatPublicDomainContributionStatement.

=== Brevets ===
{{MicroFormatPatentStatement-fr}}

== PrÃ©ambule ==
Quand nous avons discutÃ© d'[http://developers.technorati.com/wiki/attentionxml Attention.xml], Tantek faisait remarquer que XHTML a tout ce qui est nÃ©cessaire pour exprimer sÃ©mantiquement des outlines et des abonnements comme des blogrolls dans un format XML qui soit Ã la fois restituable interactivement par des navigateurs et parsable par des moteurs XML strict. Cette page est ici pour disctuer de cette idÃ©e.

=== Nom ===
XOXO veut dire eXtensible Open XHTML Outlines, et se prononce selon 'icks oh icks oh', 'zho-zho', ou 'cho-cho'.

== Abstract ==
XOXO est l'un des nombreux [[microformats-fr|microformats]]. Cette spÃ©cification dÃ©finit un nouveau type de document XHTML basÃ© sur le squelette module et les modules dÃ©finis dans Modularisation du XHTML ([http://www.w3.org/TR/xhtml-modularization XHTMLMOD]). Le but du type de document XOXO est de servir de base pour des outlines XHTML faciles qui puissent Ãªtre traitÃ©s par les moteurs XML et pour une restitution interactive facile par les navigateurs.

== Le type de Document XOXO ==
Le type de document XOXO est construit sur les modules suivants XHTML.
Les Ã©lÃ©ments, attributs et modÃ¨les de contenu minimal associÃ©s avec ces modules sont dÃ©finis dans "Modularization of XHTML" ([http://www.w3.org/TR/xhtml-modularization XHTMLMOD]).
Les Ã©lÃ©ments sont listÃ©s ici Ã des fins d'information, mais les dÃ©finitions dans "Modularization of XHTML" devraient Ãªtre considÃ©rÃ©es comme dÃ©finitives. Dans la version en ligne de ce document, les noms de modules dans la liste en-dessous pointent dans les dÃ©finitions des modules dans la version actuelle de "Modularization of XHTML".

[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_structuremodule Structure Module]
body, head, html, title
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_hypertextmodule Hypertext Module]
a
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_listmodule List Module]
dl, dt, dd, ol, ul, li
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_metamodule Metainformation Module]
meta
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_stylemodule Stylesheet Module]
style element
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_styleattributemodule Style Attribute Module]
style attribute
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_linkmodule Link Module]
link
[http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_legacymodule Legacy Module]
Attribute compact on ol and ul

=== Le Profil XOXO ===

Voir [[xoxo-profile-fr|xoxo-profile]] pour le profil [http://gmpg.org/xmdp XMDP] de XOXO qui dÃ©finit les valeurs XOXO pour l'attribut class.

== Fragment Simple XOXO ==

=== Balisage ===

<pre><nowiki><ol class='xoxo'>
<li>Sujet 1
<ol>
<li>souspoint a</li>
<li>souspoint b</li>
</ol>
</li>
<li>Sujet 2
<ol compact="compact">
<li>souspoint c</li>
<li>souspoint d</li>
</ol>
</li>
<li>Sujet 3
<ol>
<li>souspoint e</li>
</ol>
</li>
</ol>
</nowiki></pre>

=== Restitution Echantillon ===
<pre><nowiki>
1. Sujet 1
a. souspoint a
b. souspoint b
2. Sujet 2
3. Sujet 3
a. souspoint e
</nowiki></pre>
=== Usage de l'attribut 'compact' ===
Notez l'utilisation de l'attribut 'compact' pour indiquer que les sous-points du titre "Sujet 2"
ne sont pas dans un Ã©tat dÃ©ployÃ©. L'absence de l'attribut 'compact' ailleurs indique que les autres titres
sont en Ã©tat dÃ©ployÃ©.

=== RÃ¨gles de Style par DÃ©faut pour une Restitution Echantillon ===
<pre><nowiki>
ol.xoxo { list-style:decimal; }
ol.xoxo ol { list-style:lower-latin; }
ol[compact="compact"] { display:none; }
</nowiki></pre>

== Plus d'Exemples Simples ==
MarkP a un ensemble d'exemples qui dÃ©montrent Ã la fois la simplicitÃ© du balisage et la richesse de prÃ©sentation possible :

* [http://diveintomark.org/public/2004/01/xo-flat.xo fichier simple XO qui peut Ãªtre directement embarquÃ© Ã l'intÃ©rieur d'une page XHTML]
* [http://diveintomark.org/public/2004/01/xo-embeddable.xo XO avec groupes imbriquÃ©s, aussi directement embarcables dans le XHTML]
* [http://diveintomark.org/public/2004/01/xo-standalone.xo XO comme page XHTML autonome] ([http://validator.w3.org/check?uri=http%3A%2F%2Fdiveintomark.org%2Fpublic%2F2004%2F01%2Fxo-standalone.xo XHTML valide])
* [http://diveintomark.org/public/2004/01/xo-with-style.xo XO comme page XHTML autonome, mise en forme avec CSS] ([http://validator.w3.org/check?uri=http%3A%2F%2Fdiveintomark.org%2Fpublic%2F2004%2F01%2Fxo-with-style.xo aussi valide XHTML])
* [http://homepage.mac.com/ctholland/thelab/outlines/ Chris Holland Outline Helper] : tordu l'un des exemples au-dessus, yanked CSS pour la simplicitÃ©, ajoutÃ© rÃ©fÃ©rence vers [http://homepage.mac.com/ctholland/thelab/outlines/outlines.css outlines.css] et [http://homepage.mac.com/ctholland/thelab/outlines/outlines.js outlines.js], copiÃ© quelques combinaisons diffÃ©rentes de ul/ol/li avec l'attribut compact.
** en essayant de rester compatible avec les principes de l'attribut "compact" pour les Ã©lÃ©ments ol et ul est ce qui conduit Ã l'Ã©tat d'affichage.
Via la programmation, je suis en train d'installer des classes sur l'Ã©lÃ©ment conteneur li pour une flexibilitÃ© ajoutÃ©e de style, mÃªme si les gourous CSS pourraient Ãªtre capables de remplacer "li.expanded" dans outlines.css avec quelque autre sÃ©lecteur CSS qui dise "sÃ©lectionnez un noeud li qui contient un noeud ol avvec un rÃ©glage d'attribut sur 'compact' ".

*** Le sÃ©lecteur CSS pour "un noeud li qui contient un noeud ol avec un ensemble d'attribut 'compact'" serait 'li ol[compact="compact"]'

== PropriÃ©tÃ©s des Items Outline ==
Outlines consiste gÃ©nÃ©ralement en une hiÃ©rarchie de points et sous-points.
Chacun de ces points (items outlines) peut avoir lui-mÃªme quelques propriÃ©tÃ©s (comme des attributs ou des mÃ©ta-donnÃ©es) qui ont besoin d'Ãªtre reprÃ©sentÃ©es. Peut-Ãªtre que la propriÃ©tÃ© supplÃ©mentaire la plus commune sur les items d'outline est en pratique l'URL comme cela est dÃ©montrÃ© dans les exemples de Mark Pilgrim au-dessus. MÃªme le texte label/title d'un item outline pourrait Ãªtre considÃ©rÃ© comme une propriÃ©tÃ© commmune. Quelques propriÃ©tÃ©s communes :
* text
* description
* url (souvent appelÃ© xmlurl ou htmlurl ; parfois appelÃ© permalink)
* title
* type (truc du MIME type de la ressource indiquÃ© par l'URL)

En gÃ©nÃ©ral, les propriÃ©tÃ©s d'un item outline <code><nowiki><li></nowiki></code> sont reprÃ©sentÃ©es par une liste de dÃ©finitions imbriquÃ©es <code><nowiki><dl></nowiki></code>. A strictement parler, c'est le premier <code><nowiki><dl></nowiki></code> Ã l'intÃ©rieur du <code><nowiki><li></nowiki></code> et avant tout <code><nowiki><ol></nowiki></code>, <code><nowiki><ul></nowiki></code>, ou <code><li></code> suivant, par ex. voici un item "item 1" avec une propriÃ©tÃ© de description (les sous-points sont lÃ purement comme un point de rÃ©fÃ©rence vers un exemple antÃ©rieur).

<pre><nowiki>
<ol class='xoxo'>
<li>item 1
<dl>
<dt>description</dt>
<dd>cet item reprÃ©sente le point principal que nous essayons de produire.</dd>
</dl>
<ol>
<li>souspoint a</li>
<li>souspoint b</li>
</ol>
</li>
</nowiki></pre>

=== PropriÃ©tÃ©s SpÃ©ciales ===
Il existe un paquet de propriÃ©tÃ©s spÃ©ciales que nous pouvons reprÃ©senter plus directement
et de faÃ§on commode avec les blocs de construction du XHTML sÃ©mantique que nous avons inclus, au lieu de termes dans une liste de dÃ©finition. La plupart sont extraits de la liste au-dessus des propriÃ©tÃ©s communes, ce sont :
* text, url, title, type, et rel (raccourci de relationship)

Si nous devions les reprÃ©senter simplement comme des termes de dÃ©finition (y compris la propriÃ©tÃ© "description" tirÃ©e du prÃ©cÃ©dent exemple), cela pourrait ressembler Ã quelque chose comme Ã§a :

Exemple pour recherche de discussion seulement / pas un exemple canonique XOXO :

<pre><nowiki>
<ol class='xoxo'>
<li>
<dl>
<dt>text</dt>
<dd>item 1</dd>
<dt>description</dt>
<dd> Cet item reprÃ©sente le point principal que nous essayons de produire.</dd>
<dt>url</dt>
<dd>http://exemple.com/plus.xoxo</dd>
<dt>title</dt>
<dd>titre de item 1</dd>
<dt>type</dt>
<dd>text/xml</dd>
<dt>rel</dt>
<dd>aide</dd>
</dl>
</li>
</nowiki></pre>

NÃ©anmoins, en tirant profit de l'Ã©lÃ©ment sÃ©mantique <code><a href></code>, nous pouvons dramatiquement simplifier les cases communes qui utilisent ces propriÃ©tÃ©s. Du point de vue d'un parseur, ceci s'applique au premier Ã©lÃ©ment <code><a href></code> diretement dans le <code><nowiki><li></nowiki></code>.

Exemple vÃ©ritable XOXO :

<pre><nowiki>
<ol class='xoxo'>
<li><a href="http://exemple.com/more.xoxo"
title="titre item 1"
type="text/xml"
rel="help">item 1</a>

<dl>
<dt>description</dt>
<dd>Cet item prÃ©sente le point principal que nous essayons de produire.</dd>
</dl>
</li>
</nowiki></pre>

Toutes les autres propriÃ©tÃ©s sont simplement ajoutÃ©es Ã la liste de dÃ©finition
de la mÃªme faÃ§on que la propriÃ©tÃ© "description".

=== PropriÃ©tÃ©s Multi-valeurs ===

Les propriÃ©tÃ©s qui ont plusieurs valeurs sont ajoutÃ©es en utilisant une liste, imbriquÃ©e Ã l'intÃ©rieur de l'Ã©lÃ©ment correspondant <code>dl</code> :

<pre><nowiki>
<ol class='xoxo'>
<li>item 1
<dl>
<dt>multivalpropriete1</dt>
<dd><ul>
<li>valeur-a</li>
<li>valeur-b</li>
</ul></dd>
</dl>
</li>
</ol>
</nowiki></pre>

== Publier XOXO ==
XOXO peut Ãªtre pubiÃ© sous deux formes, XHTML valide, et XML simple et bien formÃ©.

=== XOXO XHTML Valide ===
Une page XOXO XHTML Valide est un document XHTML complet.

<pre><nowiki>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>XOXO page</title>
</head>
<body>
<ol class="xoxo">
<li><a href="URL-un">TEXT-un</a></li>
<li><a href="URL-deux">TEXT-deux</a></li>
...
</ol>
</body>
</html>
</nowiki></pre>

=== XOXO XML Simple bien-formÃ© ===
L'Ã©lÃ©ment racine d'une page XOXO XML simple bien formÃ© est soit un <code>ol</code> ou <code>ul</code> avec le nom de classe de "xoxo". Cette variante est idÃ©ale pour la syndication et la transclusion Ã l'intÃ©rieur de pages (X)HTML avec [[rest/ahah|AHAH]].

<pre><nowiki>
<ol class="xoxo">
<li><a href="URL-un">TEXTE-un</a></li>
<li><a href="URL-deux">TEXTE-deux</a></li>
...
</ol>
</nowiki></pre>

=== Content-Type ===
Le XHTML XOXO valide et bien formÃ© DEVRAIT Ãªtre servi avec cet en-tÃªte Content-Type pour une compatibilitÃ© navigateur maximale :
<pre><nowiki>
Content-Type: text/xml; charset=utf-8
</nowiki></pre>

Il DOIT Ãªtre servi avec un de ces en-tÃªtes Content-Type :

<pre><nowiki>
Content-Type: text/html; charset=utf-8
Content-Type: application/xhtml+xml
Content-Type: application/xml
</nowiki></pre>

== Exemples dans la Jungle ==
Cette section est '''informative'''.

Il existe beaucoup trop d'exemples dans la jungle. Presque chaque blogroll sur le web peut Ãªtre parsÃ©e avec XOXO, parce qu'elles sont gÃ©nÃ©ralement une liste non ordonnÃ©e d'items de listes d'hyperliens, ce qui est dans le profil XOXO. Listez ici les exemples et quand la liste sera trop longue, nous la migrerons sur une page dÃ©diÃ©e.

* [http://api.talis.com/bf/stores/ukbib/services/facet?query=feynman&fields=title%2Csubject&top=10&output=html sortie HTML Ã partir d'un service Ã facette pour des donnÃ©es de livres]

== ImplÃ©mentations ==
Cette section est '''informative'''.

* [http://chneukirchen.org/blog/ Christian Neukirchen] a [http://chneukirchen.org/blog/archive/2006/01/xoxo-rb-0-1-released.html Ã©crit un xoxo.rb, un parseur XOXO et un gÃ©nÃ©rateur pour Ruby]
* [http://odeo.com Odeo] publie les liste d'abonnements utilisateurs dans XOXO. Voir la liste de Ryan King [http://odeo.com/profile/RyanKing/xoxo ici].
* [http://www.decafbad.com/blog/ Les Orchard] a [http://www.decafbad.com/blog/2005/07/12/xoxo_outliner_experiment Ã©crit] un [http://www.decafbad.com/2005/07/map-test/tree2.html bel Ã©diteur XOXO en javascript].
* http://homepage.mac.com/ctholland/thelab/outlines/ est une dÃ©monstration gÃ©niale du XOXO dynamique et interactif avec l'utilisation de "compact" et du DHTML pour dÃ©ployer/replier.
* http://tool-man.org/examples/sorting.html est une dÃ©monstration gÃ©niale de listes XOXO "glisser dÃ©poser" triables avec javascript and CSS.
* http://www.joshpeek.com/projects/opmltoxoxo est un convertisseur extensible de OPML vers XOXO.
* http://www.opendarwin.org/~drernie/xoxo-datatypes.html Mapper XOXO en [http://developer.apple.com/documentation/Cocoa/Conceptual/PropertyLists/Concepts/XMLPListsConcept.html listes de propriÃ©tÃ©s Mac OS X]
* [http://weblog.techno-weenie.net/2005/9/30/if_i_had_a_tumblelog ligne unique de rails pour convertir XOXO en HTML]

=== Code Ã©chantillon ===
* Voir la page [[xoxo-sample-code-fr|xoxo-code-Ã©chantillon]] pour un code Ã©chantillon open source afin de lire et Ã©crire des fichiers XOXO.
* Voir aussi la page [[xoxo-compact-sample-fr|xoxo-Ã©chantillon-compact]] avec la source pour le CSS et JS qui altÃ¨re le "look and feel" de quelque XOXO pour avoir des triangles dÃ©pliables dans les listes imbriquÃ©es qui respectent aussi l'attribut compact.

== SchÃ©mas XOXO ==
Cette section est "informative".

Note : ces liens peuvent Ãªtre dÃ©modÃ©s et ont besoin d'Ãªtre mis Ã jour pour reflÃ©ter l'utilisation de <dl> pour l'annotation d'items XOXO avec des propriÃ©tÃ©s arbitraires.
* [[DTDs]]
* [http://www.nidelven-it.no/projects/XOXO/xoxo-0.1.tgz Schemas (Relax NG and DTDs)]

== RÃ©fÃ©rences ==
=== RÃ©fÃ©rences "Normatives" ===
* [http://www.w3.org/TR/xhtml1 XHTML 1.0]
* [http://www.w3.org/TR/xhtml-modularization XHTMLMOD]
* [http://gmpg.org/xmdp/ XMDP]
* [http://gmpg.org/xfn/ XFN]

=== RÃ©fÃ©rences "Informatives" ===
Cette section est '''informative'''.
* [http://developers.technorati.com/wiki/attentionxml Attention.xml]
* [[vote-links-fr|VoteLinks]]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://opml.scripting.com/spec OPML 1.0]
* Contribution provenant de http://developers.technorati.com/wiki/XOXO

=== Travaux similaires ===
* [http://dannyayers.com/archives/001961.html XHTML Outlines] - DannyAyers a sorti indÃ©pendamment l'idÃ©e en octobre 2003 (juste un mois ou deux avant que Kevin et Tantek se sortent indÃ©pendamment XOXO) d'utiliser un simple profil XHTML
pour reprÃ©senter sÃ©mantiquement les outlines en utilisant des blocs de constrution existant provenant du XHTML.
* [http://semtext.org/2004-02/ XOW] - les rend Ã©ditables, produisant des listes de RDF et bookmark Ã partir d'eux (DannyAyers)

=== Lecture en Rapport ===
* [http://patricklogan.blogspot.com/2005/08/lists-really-can-we-expect-better.html Patrick Logan sur pourquoi OPML et une extension Microsoft Lists sont tous deux non nÃ©cessaires].

=== Lecture sans aucun rapport ===
* [http://www.questionablecontent.net/view.php?comic=493 Questionable Content comic #493] - apparemment le personnage Faye est un fan of XOXO.

=== Contenus Promotionnels / Schwag ===
* Il existe toute une ligne de vÃªtements et d'accessoires en ligne. [http://www.xoxo.com/home.php Buy XOXO stuff online].

== Discussions ==
Cette spÃ©cification est un chantier en cours. Au fur et Ã mesure que des aspects supplÃ©mentaires sont discutÃ©s, compris et Ã©crits, ils seront ajoutÃ©s. Il existe un document sÃ©parÃ© oÃ¹ nous gardons traces de nos brainstorms et autres explorations en rapport avec XOXO :

* Voir [[xoxo-brainstorming-fr]] pour des idÃ©es supplÃ©mentaires sur la faÃ§on d'utiliser XOXO pour des usages spÃ©cifiques.
* Voir aussi [http://www.technorati.com/cosmos/referer.html les blogs qui discutent de cette page].
** [http://blogxoxo.blogspot.com/ XOXO Blog]

=== Q&R ===
* Si vous avez quelque question Ã propos de XOXO, regardez les [[xoxo-faq-fr|xoxo-faq]], et si vous ne trouvez pas de rÃ©ponses, ajoutez vos questions !

=== ProblÃ©matiques ===
* ajoutez svp toute problÃ©matique sur la spÃ©cification Ã la page document sÃ©parÃ©e [[xoxo-issues-fr|problÃ©matiques xoxo]].

Microformats Wiki - User contributions [en]

xoxo-fr