xfolk-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
Line 109: Line 109:
== Beaucoup plus d'exemples ==
== Beaucoup plus d'exemples ==


We have numerous examples to help developers incorporate xFolk into their sites.
Nous avons de nombreux exemples pour aider les développeurs à incorporer xFold dans leurs sites.


=== Dans la jungle ===
=== Dans la jungle ===


These are real live examples of functioning systems that publish bookmarks in xFolk. These are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If you publish using xFolk, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.
Ce sont de vrais exemples de systèmes qui fonctionnent qui publient les signets dans xFolk. Ceci est une endroit idéal pour commencer à regarder des exemples "dans la jungle" pour essayer de parser, indexer, organiser, etc. Si vous publiez en utilisant xFolk, sentez-vous à l'aise pour ajouter en haut de cette liste. Une fois que la liste sera trop grosse, nous ferons une page wiki séparée.


* [http://waferbaby.com/hussy waferbaby's Hussy] currently publishes links using xFolk.
* [http://waferbaby.com/hussy waferbaby's Hussy] publie actuellement des liens en utilisant xFolk.
* [http://smarking.com/ Smarking] currently publishes all shared links (including search results) using xFolk.
* [http://smarking.com/ Smarking] publie actuellement tous les liens partagés (y compris les résultas de recherche) en utilisant xFolk.
* [http://unalog.com unalog] currently publishes all shared links (including search results) using xFolk.
* [http://unalog.com unalog] publie actuellement tous les liens partagés (y compris les résultats de rechreche) en utilisant xFolk.
* [http://de.lirio.us de.lirio.us] currently publishes its bookmarks using xFolk (with the deprecated class attribute <code>extended</code> in place of <code>description</code>, see [[xfolk-profile | the XMDP]]).
* [http://de.lirio.us de.lirio.us] publie actuellement ses signets en utilisant xFolk (avec l'attribut de classe déprécié  <code>extended</code> a lieu de <code>description</code>, voir [[xfolk-profile-fr| le XMDP]]).
* [http://dev.blogmarks.net/wiki/BlogSync blogmarks] currently exports bookmarks to blogs in xFolk (scroll down to the export example on the page; the deprecated class attribute <code>extended</code> is used in place of <code>description</code>, see [[xfolk-profile | the XMDP]]).
* [http://dev.blogmarks.net/wiki/BlogSync blogmarks] exporte actuellement les signets vers les blogs en xFolk (défilez plus bas pour voir l'exemple d'export sur la page ; l'attribut de classe déprécié <code>extended</code> est utilisé au lieu de <code>description</code>, voir [[xfolk-profile-fr| le XMDP]]).
* [http://thecommunityengine.com The Community Engine] uses xFolk (with the deprecated class attribute <code>extended</code> in place of <code>description</code>, see [[xfolk-profile | the XMDP]]) for its [http://thecommunityengine.com/home main entries] and for its [http://thecommunityengine.com/webcites republished bookmarks].
* [http://thecommunityengine.com The Community Engine] utilise xFolk (avec l'attribut de classe déprécié <code>extended</code> utilisé au lieu de <code>description</code>, voir [[xfolk-profile-fr| le XMDP]]) pour ses [http://thecommunityengine.com/home entrées principales] et pour ses [http://thecommunityengine.com/webcites signets republiés].


=== Services de signets sociaux supplémentaires ===
=== Services de signets sociaux supplémentaires ===


This example illustrates how xFolk may be applied to one additional service:
Cet exemple illustre comment xFolk peut être appliqué à un service additionnel :  


* [[xfolk-scuttle | scuttle]]
* [[xfolk-scuttle-fr| scuttle]]


=== Blogs de liens ===
=== Blogs de liens ===


Social bookmarking services are only the most recent examples of people publishing links. Link blogs have been around almost since the beginning of blogging. They represent somewhat more of a challenge for xFolk because their markup tends to be less semantic from the outset. The following examples illustrate some particular challenges and how they can be overcome.
Les services de signets sociaux sont seulement les exemples les plus récents de personnes publiant des liens. Les blogs de liens ont presque toujours existé depuis le début du blogging. Ils représentent en quelque sorte plus qu'un défi pour xFolk parce que leurs balisages tendent à être moins sémantique qu'au début. Les exemples suivants illustrent quelques défis particulies et comment ils peuvent être surmontés.


* [[xfolk-kottke | kottke]]
* [[xfolk-kottke | kottke]]

Revision as of 06:01, 27 June 2006

xFolk (RC1)

xFolk est un format simple et ouvert pour publier des colletions de signets. Il permet aux services de mieux améliorer l'expérience utilisateur et de partager des données dans un logiciel de signet basé sur le web. xFolk peut être embarqué dans (X)HTML, Atom, RSS et du XML arbitraire. C'est l'un des nombreux microformats standards ouverts.

Spécification Brouillon

Editeur/Auteur

Bud Gibson, The Community Engine

Copyright

Cette spécification est (C) 2005-2024 par les auteurs. Néanmoins, les auteurs ont pour but de soumettre cette spécification à un corps de standards avec une politique libérale de copyright/licence telle que GMPG, IETF, et/ou W3C. Quiconque souhaite contribuer devrait lire avant de contribuer leurs principes de copyright, politiques et licences (par ex. les Principes GMPG) et être d'accord avec eux, y compris le fait de licencier toutes les contributions sous les licences nécessaires (par ex. CC-by 1.0 et suivantes).

Brevets

Cette spécification est sujette à une politique de brevets libres de droits, par ex. pour la Politique de Brevet du W3C, IETF RFC3667 et RFC3668.

Inspiration et Reconnaissances

Merci à : David Plaut qui m'a présenté l'idée que les items peuvent appartenir partiellement à beaucoup de catégories en une fois. Plus récemment, merci à : Tantek Çelik, Kevin Marks, Steve Mallet, Brian DelVecchio et François Hodierne qui ont contribué au développement de xFolk avec des critiques sensées et des implémentations.

Introduction

Les services de signets sociaux laissent les utilisateurs sauvegarder et taguer leurs signets pour les partager avec d'autres utilisateurs. Durant la dernière année, le nombre de ces services a poussé comme des champignons (plus de 20, avec des exemples comprenant : del.icio.us, furl, de.lirio.us, jots et blogmarks.

Le manque d'un standard ouvert et interopérable de données est une problématique majeure à utiliser les services de signets sociaux. Un standard ouvert ferait qu'il est possible de collecter facilement des données signets et de les remixer pour inventer de nouveaux services le long de la ligne du moteur expérimental de recherche de signet gataga. Un standard ouvert ferait qu'il serait aussi possible d'écrire des javascripts qui fonctionne transversalement sur les services comme le font certains actuellement pour del.icio.us, permettant des améliorations en expérience utiliateur.

xFolk est un standard ouvert de signet social qui a pour but de parvenir à tous ces avantages. Les services de signets sociaux qui adoptent xFolk continueront à se différencier eux-mêmes des services de données. Mais, la donnée elle-même sera facile à manipuler par des scripts tiers et sera facile à partager. En tant que résultats, les services de signets pourront offir à leurs utilisateurs un ensemble plus large d'options à un moindre coût et se concentrer sur ce qui les différencie vraiment. Les individus ou les groupes opérant seul des répertoires de signets auront accès à un plus large ensemble de fonctionnalités que celles qu'ils pourraient produire seuls.

Principes de Design XHTML Sémantique

Note : les Principes de Design XHTML Sémantique ont été écrits initialement dans le contexte de développement de hCard et hCalendar, par conséquent il peut être plus facile de comprendre ces principes dans le contexte de la méthodologie de design hCard (ce qui veut dire, lisez ça d'abord). Tantek

XHTML est construit sur du XML, et par conséquent les formats fondés sur XHTML peuvent être utilisés non seulement pour une présentation d'affichage pratique, mais aussi à des fins d'échanges de données. A bien des façons, les formats fondés sur XHTML illustrent le meilleur des mondes tant du HTML que du XML. Néanmoins au moment de construire des formats basés sur XHTML, cela aide d'avoir un ensemble de principes directeurs.

  1. Réutilisez autant que possible le schéma (noms, objets, propriétés, valeurs, types, hiérarchies, contraintes) à partir des standards de référence établis et bien supportés. Evitez de redéclarer les contraintes exprimées dans le standard source. Des mentions à titre d'information peuvent passer.
    1. Pour les types avec plusieurs composants, utilisez des éléments imbriqués avec des noms de classe équivalents aux noms des composants.
    2. Les composants pluriels sont produits au singulier, et par conséquent plusieurs éléments imbriqués sont utilisés pour représenter plusieurs valeurs de texte qui sont délimitées par des virgules.
  2. Utilisez la sémantique XHTML la plus précise pour construire des blocs pour chaque objet, etc.
  3. Autrement utilisez un élément générique structurel (par ex. <span> ou <div>), ou l'élément contextuel approprié (par ex. un <li> dans un <ul> ou <ol>).
  4. Utilisez des noms de classes basés sur des noms extraits du schéma original, à moins que le XHTML sémantique de construction de bloc ne représente précisément cette partie du schéma original. Si les noms dans le schéma original ne sont pas sensibles la casse, alors mettez tout dans un équivalent en bas de casse. Les noms de composants implicites en prose (plutôt qu'explicites dans le schéma défini) devraient aussi utiliser les équivalents bas de casse pour une facilité d'utilisation. Les espaces dans les noms des composants deviennent des caractères tiret '-'.
  5. Pour finir, si le format de la donnée selon le schéma original est trop long et/ou non amical sur le plan humain, utilisez <abbr> au lieu d'un élément générique structurel, et placez les données littérales dans l'attribut 'title' (là où vont les expansions abbr), et l'équivalent le plus bref et le plus lisible humainement dans l'élément lui-même. De plus amples explications de cet usage de <abbr> : Human vs. ISO8601 dates problem solved

Format

Une analyse extensive des services de signets sociaux et des linkblogs, déposée aileurs, révèle que les données publiées par tous les services de signets et beaucoup de linkblogs différents sont décrites par les schéma implicite suivant :

  • Un lien bookmarké ou tagué.
  • Un titre pour l'entrée.
  • Les tags pour le lien.
  • Une description étendue ou un résumé du lien.

Comme démontré dans les premières itérations du standard xFolk, ce schéma général peut être traduit en balisage par :

  1. créer un élément conteneur pour chaque entrée de la classe xfolkentry,
  2. utiliser un élément <a> pour le lien bookmarké ou tagué de la classe taggedlink,
  3. utiliser l'attribut title pour l'élément lien tagué <a>, s'il existe, comme l'entrée title, autrement utiliser la valeur de l'élément,
  4. utiliser RelTag pour les tags, et
  5. utiliser un élément conteneur de classe description, tel que <p>, pour toute autre description étendue ou résumé.

Une entrée donnée xFolk contiendra toujours un lien tagué comprenant un 'title' avec d'autres éléments optionnels. Les entrées peuvent avoir plus d'un tag tout comme plus d'un élément de classe description. Plusieurs éléments de classe description sont triés par l'ordre du document par défaut. Les éléments sémantiques dans les entrées xFolk peuvent être imbriqués à des profondeurs abritraires.

Beaucoup de systèmes de signets sociaux existent, chacun d'eux avec se propres conventions de balisage. En outre, beaucoup de personnes publient déjà des blogs de liens. xFolk est conçu en priorité pour faciliter l'adoption de ces pratiques actuelles. Par conséquent, peu d'hypothèses ont été faites comme les types exacts des éléments utilisés pour une entrée xFolk. Le travail de définir la sémantique est entièrement laissé à la casse et aux valeurs d'attribut rel (dans le cas de reltag).

Il est attendu que les développeurs utiliseront XPath ou une syntaxe éqivalente en accédant à des éléments d'entrée xFolk. Une exigence pour xPath est que le document (X)HTML soit bien formé mais pas nécessairement valide. Par conséquent, bien que non désirable, il est possible d'utiliser xFolk dans un document (X)HTML qui ne valide pas.

XMDP Profile

Voir le xFolk profile pour le profil XMDP de xFolk.

Exemple

Voilà un signet échantillon comme affiché dans la syntaxe standard de del.icio.us. Les lignes où les attributs de classe d'éléments doivent changer pour se conformer à xFolk sont marquées avec un commentaire à la fin.

<div class="post"> <!--changera-->
  <div>
    <a class="delLink" href="http://www.sifry.com/alerts/archives/000306.html"> <!--changera-->
      Sifry's Alerts: Technorati launches Related Tags
    </a> 
  </div>
  <div class="extended"> <!--will change-->
    Ever wanted to see what posts are related to other posts, what tags 
    are related to others? Now you can! Just check under the Tag 
    description on most tag pages, like this one, or this one, and you'll
    see the patterns. Can you smell the emergence?
  </div>
  <div class="meta">
    to
    <a class="delNav" href="/fpgibson/folksonomy">folksonomy</a> <!--changera-->
    <a class="delNav" href="/fpgibson/technorati">technorati</a> <!--changera-->
    ... <a class="delNav" href="/url/cbcabf7de070fdb46598ee679367be49">
    and 1 other person
    </a>
    ... on 2005-04-09
  </div>
</div>

The equivalent in xFolk is as follows. Comments are placed at the end of lines where class attribute changes were required.

<div class="xfolkentry"> <!-- changé -->
  <div>
    <a class="taggedlink" href="http://www.sifry.com/alerts/archives/000306.html"> <!-- changé -->
      Sifry's Alerts: Technorati launches Related Tags
    </a> 
  </div>
  <div class="description"> <!-- changed -->
    Ever wanted to see what posts are related to other posts, what tags 
    are related to others? Now you can! Just check under the Tag 
    description on most tag pages, like this one, or this one, and you'll
    see the patterns. Can you smell the emergence?
  </div>
  <div class="meta">
    to
    <a rel="tag" href="/fpgibson/folksonomy">folksonomy</a> <!-- changé -->
    <a rel="tag" href="/fpgibson/technorati">technorati</a> <!-- changé -->
    ... <a class="delNav" href="/url/cbcabf7de070fdb46598ee679367be49">
    and 1 other person
    </a>
    ... on 2005-04-09
  </div>
</div>

Convertir le balisage pour être conforme à xFolk est presque toujours aussi facile. L'avantage de xFolk est que cela fournit un ensemble d'attributs de classe qui peuvent être réutilisés sur tous les services et blogs de liens, presque toujours sans aucune perte de granularité. La prochaine section présenter plusieurs autres exemples pour illustrer ce point.

Beaucoup plus d'exemples

Nous avons de nombreux exemples pour aider les développeurs à incorporer xFold dans leurs sites.

Dans la jungle

Ce sont de vrais exemples de systèmes qui fonctionnent qui publient les signets dans xFolk. Ceci est une endroit idéal pour commencer à regarder des exemples "dans la jungle" pour essayer de parser, indexer, organiser, etc. Si vous publiez en utilisant xFolk, sentez-vous à l'aise pour ajouter en haut de cette liste. Une fois que la liste sera trop grosse, nous ferons une page wiki séparée.

  • waferbaby's Hussy publie actuellement des liens en utilisant xFolk.
  • Smarking publie actuellement tous les liens partagés (y compris les résultas de recherche) en utilisant xFolk.
  • unalog publie actuellement tous les liens partagés (y compris les résultats de rechreche) en utilisant xFolk.
  • de.lirio.us publie actuellement ses signets en utilisant xFolk (avec l'attribut de classe déprécié extended a lieu de description, voir le XMDP).
  • blogmarks exporte actuellement les signets vers les blogs en xFolk (défilez plus bas pour voir l'exemple d'export sur la page ; l'attribut de classe déprécié extended est utilisé au lieu de description, voir le XMDP).
  • The Community Engine utilise xFolk (avec l'attribut de classe déprécié extended utilisé au lieu de description, voir le XMDP) pour ses entrées principales et pour ses signets republiés.

Services de signets sociaux supplémentaires

Cet exemple illustre comment xFolk peut être appliqué à un service additionnel :

Blogs de liens

Les services de signets sociaux sont seulement les exemples les plus récents de personnes publiant des liens. Les blogs de liens ont presque toujours existé depuis le début du blogging. Ils représentent en quelque sorte plus qu'un défi pour xFolk parce que leurs balisages tendent à être moins sémantique qu'au début. Les exemples suivants illustrent quelques défis particulies et comment ils peuvent être surmontés.

Implémentations

The following implementations have been developed which generate or use xFolk. If you have an xFolk implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

Références

Références Normatives

Références Informatives

Travaux similaires

Chantier en cours

Although this specification has recently begun to stabilize as indicated by the version RC1, it is still a work in progress. If warranted, I am prepared to go through multiple release candidates to achieve the narrow purpose of making bookmark entries more genrally accessible with as with as light weight a format as possible. All changes since the last iteration have been motivated by the implementation experience of developers attempting to achieve this narrow aim. Further changes will also most likely be motivated by implementation concerns. See "future directions" below for additional microformat possibilities.

Changements depuis xFolk 0.4

The class attribute value extended was deprecated in favor description to better conform with other microformat usage and some requests during implementation. The other change has been to allow use of multiple elements of class extended based on some use cases discovered in implementation.

Directions futures

There are several extensions one might imagine for xFolk. Frequently, these extensions are best achieved by combining xFolk with another microformat. For instance, one might want to indicate his or her evaluation of the bookmarked item. This might be achieved by using Vote Links or hReview with xFolk.

One can also imagine extending xFolk to provide data conformant with various social bookmarking service APIs, for instance to provide all bookmarks by tag. These APIs are currently too fluid for specification in any kind of standard. The APIs and the functionality they provide represent one way social bookmarking services and meta services can differentiate themselves.

A companion format called "xFolk definition" is under development. xFolk definition will provide a means of explicitly defining the tags used in social bookmarks.

Brainstorming

Discussions

Q&R

  • If you have any questions about xFolk, check the xFolk FAQ, and if you don't find answers, add your questions!

Problématiques

  • Please add any issues with the specification to the separate xFolk issues document.