H-entry - Historique des versions

Xtof : /* Pourquoi consommer */

2017-02-28T03:57:34Z

Pourquoi consommer

Xtof : /* Comment consommer h-entry */

2017-02-21T05:04:44Z

Comment consommer h-entry

Xtof : /* IndieWeb Examples */

2017-02-21T04:52:51Z

IndieWeb Examples

Xtof : /* How to consume h-entry */

2017-02-21T04:52:27Z

How to consume h-entry

Xtof le 21 février 2017 à 04:32

2017-02-21T04:32:25Z

Xtof : Page créée avec « '''[http://microformats.org/wiki/h-entry h-entry]''' est le vocabulaire microformats2 pour marquer les posts de blog sur les... »

2017-02-20T11:02:37Z

Page créée avec « '''<dfn>[http://microformats.org/wiki/h-entry h-entry]</dfn>''' est le vocabulaire microformats2 pour marquer les posts de blog sur les... »

Nouvelle page

'''<dfn>[http://microformats.org/wiki/h-entry h-entry]</dfn>''' est le vocabulaire [[microformats2-fr|microformats2]] pour marquer les [[posts-fr|posts]] de blog sur les sites web. Il peut aussi s'utiliser pour marquer tout autre contenu basé sur une série épisodique ou chronodatée.

== Pourquoi ==
=== Pourquoi publier ===
Vous devriez ajouter le marquage `h-entry` à votre [[homepage-fr|page d'accueil]] et vos [[permalinks-fr|permaliens]] parce que c'est le moyen le plus simple de faire que ces pages soient facilement lisibles pour les [[readers-fr|lecteurs]] indieweb,

Ajoutez h-entry à vos pages de post permet la [[discovery-fr|découverte]] de l'information de post sur vos permalients, ce qui est utilise pour une diversité de choses, parmi lesquelles :
* contexte de syndication de [[reply-fr|réponse]]
* syndication de vos [[replies-fr|réponses]] à partir de votre site sous forme de commentaires sur les permaliens des sites auxquels vous répondez.

Ajouter h-entry à votre page d'accueil permet :
* de s'abonner à vos posts directement à partir de votre page d'accueil (pas besoin de flux séparé).
* Un bloc de construction pour ajouter le support de [[PuSH-fr|PuSH]] pour des abonnés en temps réel à vos mises à jour.

=== Pourquoi consommer ===
By using a [[microformats2]] parser, and looking for h-entry items, your code will automatically get both h-entry and classic [[hAtom]] post information from people's post pages and home pages, which are published in total in combination by a double digit percentage of the web (thanks to [[WordPress]] default templates including such markup for 5+ years), and especially cutting edge IndieWeb sites.

HTML on a page is historically more accurate than [[feed files]] (see that page for more details on why).

Thus for the best user experience, your consuming code should first consume the h-entry (and by backward compat of such parsers, hAtom) of pages before looking at secondary side files.

== Comment faire ==
=== Comment publier ===
Utilisez h-entry pour marquer :
* [[posts-fr|posts]], y compris:
** [[notes-fr|notes]]
** [[articles-fr|articles]]
** [[comments-fr|commentaires]]
** ... et sous les autres types de post.

h-entries will typically be used in two places: alone on [[post]] permalink pages and in plural on [[feed]] pages. On post permalink pages they should be a top-level microformat (not nested under anything). On feed pages they may also be children of a [[h-feed]] if you wish to add feed-level data like feed name, author.

=== How to consume h-entry ===
For how to consume feeds of multiple h-entry posts, see [[feed#How_To_Consume|How To Consume Feeds]].

To consume a single h-entry:
* look for the first h-entry on the page. If none are found, this page does not represent a post.

For each h-entry, regardless of whether they’re being treated as a single post or part of a feed:
* to find the author of the h-entry, use the [[authorship]] algorithm
* to determine how to display the post as a comment, use the [[comment-presentation#How_to_display|comment presentation]] algorithm
* to determine the published datetime:
** if the h-entry has a <var>published</var> or <var>updated</var> property which is a valid datetime
*** if the datetime is floating (i.e. has no timezone), use the [[datetime#implying_timezone_from_webmentions|implied timezone]] heuristic to determine the timezone
** if the fixed published datetime is in the future, cap it to the present
*** you may wish to preserve the source timezone in the derived time, and optionally also allow a small window within which “future” posts are accepted e.g. 10 minutes
** if there was no datetime, let the published datetime of the post be the datetime it was first seen

When notified of an update to a h-entry, either by [[webmention]] or [[PuSH]] or any other plumbing:
* optionally archive current status of
* update the <var>updated</var> property to be the updated date of the post using the same datetime resolving process given above
* re-apply the above per-h-entry algorithm, ignoring any updates to the <var>published</var>

See also the processes documented on [[comment]] for handling incoming comments, updates and deletions.

==== Problèmes ====
===== move general processing =====
Many of the processes documented on [[comment]] (e.g. deletion) can be applied equally to other cases of h-entry consumption (e.g. in a reader), and some of the detail given here applies to comments processing (e.g. datetime processing). Anything which is applicable to general h-entry processing should be moved here, leaving only anything ''specific'' to the comment use-case on [[comment]], and these algorithm referred to from there --[[User:Waterpigs.co.uk|Barnaby Walters]] 05:33, 9 June 2014 (PDT)
===== bad hentry properties =====
Some h-entrys encountered are missing a "content" property and have just the implied "p-name" property which end up with an inappropriate value for the name. These URLs were sent via pingback to [https://aaronparecki.com/articles/2012/07/29/1/oauth2-simplified a blog post] on aaronparecki.com, and are [[hEntry]] posts rather than the microformats2 version.
* [[WordPress]] classic [[microformats]] "hentry" markup:
** http://raymondhlee.wordpress.com/2014/12/21/implementing-oauth2-with-spring-security/
** http://curiouser.cheshireeng.com/2014/09/10/digression-using-oauth-2-0-at-wordpress-com/
** http://blogmobile.itude.com/2014/04/08/checklist-for-building-an-api/
** Analysis: Hypothesis: Perhaps the default WordPress core "hentry" with broken themes (that lack the rest of the hentry properties) is the source of the problem.
** Proposed resolution: Perhaps classic microformats backcompat parsing should not get any implied properties, since no classic microformats authors ever expect implied properties to happen.

* …add issues with h-entry consumption to be resolved here.

== IndieWeb Examples ==
Pretty much everyone on the IndieWeb publishes [[h-entry]] because it is a fundamental building block for the richer UX of [[Webmentions]] of federating and displaying [[comments]], and showing higher fidelity [[reply-context]]s on reply pages as well.

E.g. see people's personal sites linked from [[irc-people]].

== Qui l'utilise ==
Numerous [[projects]] and sites are parsing and consuming h-entry for various purposes, including:
* [[reply-context]] - see in particular [[reply-context#IndieWeb_Examples|indieweb sites]] that show reply context information parsed from h-entry + [[h-card]]
* [[comment-presentation]] - e.g. see [[comment-presentation#Current_Indiewebcamp_Practices|indieweb sites]] that show comments on posts syndicated in via parsing h-entry from others' reply posts.
In short, [[h-entry]] is <em>the</em> key building block for the indieweb. It represents a unit of content, to be syndicated, for a variety of use-cases.

== Requêtes ==
Requests to add h-entry support. Both publishing and consuming code.
=== Requested consuming code ===
* Firefox reader functionality: https://bugzilla.mozilla.org/show_bug.cgi?id=543630

== Voir aussi ==
* http://microformats.org/wiki/h-entry
* [[microformats2-fr|microformats2]]
* [[in-reply-to-fr|en-réponse-à]]
* [[datetime-fr|datetime]]

← Version précédente		Version du 21 février 2017 à 04:32
Ligne 1 :		Ligne 1 :
		+	{{stub-fr}}
		+
		+	''anti-sèche extraite de [[blocs de construction indieweb]]''
		+
		+	<source lang="html4strict">
		+	<article class="h-entry">
		+
		+	<div class="e-content">
		+
		+	<p>Having fun with @aaronpk, helping @border_none attendees mark up their sites with rel="me" links, h-entry classes, and webmention endpoints.</p>
		+
		+	</div>
		+
		+	<time class="dt-published" datetime="2014-10-18 08:42:37">8:42am</time>
		+
		+	</article>
		+
		+	</source>
		+	---
		+	Cette page a démarré sur [[iwc:h-entry]] et migrera sur [[iwc:h-entry-fr]]
		+
	'''<dfn>[http://microformats.org/wiki/h-entry h-entry]</dfn>''' est le vocabulaire [[microformats2-fr\|microformats2]] pour marquer les [[posts-fr\|posts]] de blog sur les sites web. Il peut aussi s'utiliser pour marquer tout autre contenu basé sur une série épisodique ou chronodatée.		'''<dfn>[http://microformats.org/wiki/h-entry h-entry]</dfn>''' est le vocabulaire [[microformats2-fr\|microformats2]] pour marquer les [[posts-fr\|posts]] de blog sur les sites web. Il peut aussi s'utiliser pour marquer tout autre contenu basé sur une série épisodique ou chronodatée.

@@ Ligne 35 : / Ligne 35 : @@
 === Pourquoi consommer ===
-By using a [[microformats2]] parser, and looking for h-entry items, your code will automatically get both h-entry and classic [[hAtom]] post information from people's post pages and home pages, which are published in total in combination by a double digit percentage of the web (thanks to [[WordPress]] default templates including such markup for 5+ years), and especially cutting edge IndieWeb sites.
+En utilisant un parseur [[microformats2]], et en cherchant des items h-entry, votre code recevra automatiquement à la fois h-entry et l'information de post classique [[hAtom]] de la part des pages de posts et pages d'accueil des personnes, qui sont publiés au total par une combinaison à deux chiffres en pourcentage sur le web (grâce aux gabarits par défaut de [[WordPress]] qui inclut un tel marquage depuis plus de 5 ans) et tout spécialement les sites IndieWeb.
-HTML on a page is historically more accurate than [[feed files]] (see that page for more details on why).
+Le HTML sur une page est historiquement plus précis que les [[feed files|fichiers feed]] (voir cette page pour plus de détails sur la raison).
-Thus for the best user experience, your consuming code should first consume the h-entry (and by backward compat of such parsers, hAtom) of pages before looking at secondary side files.
+Ainsi, pour une meilleure expérience utilisateur, votre code consommateur devrait d'abord consommer le h-entry (et par compatibilité ascendante de ces parseurs, hAtom) des pages avant de regarder les fichiers secondaires.
 == Comment faire ==

@@ Ligne 56 : / Ligne 56 : @@
 Pour consommer un unique h-entry :
-* look for the first h-entry on the page. If none are found, this page does not represent a post.
+* chercher le premier h-entry sur la page. Si aucun n'est trouvé, cette page ne représente pas un post.
-For each h-entry, regardless of whether they’re being treated as a single post or part of a feed:
+Pour chaque h-entry, Indépendamment du fait qu'il soit traité comme un seul post ou une partie d'un flux :
 * to find the author of the h-entry, use the [[authorship]] algorithm
 * to determine how to display the post as a comment, use the [[comment-presentation#How_to_display|comment presentation]] algorithm

@@ Ligne 89 : / Ligne 89 : @@
 *  …add issues with h-entry consumption to be resolved here.
-== IndieWeb Examples ==
+== Exemples IndieWeb ==
 Pretty much everyone on the IndieWeb publishes [[h-entry]] because it is a fundamental building block for the richer UX of [[Webmentions]] of federating and displaying [[comments]], and showing higher fidelity [[reply-context]]s on reply pages as well.

@@ Ligne 52 : / Ligne 52 : @@
 h-entries will typically be used in two places: alone on [[post]] permalink pages and in plural on [[feed]] pages. On post permalink pages they should be a top-level microformat (not nested under anything). On feed pages they may also be children of a [[h-feed]] if you wish to add feed-level data like feed name, author.
-=== How to consume h-entry ===
+=== Comment consommer h-entry ===
-For how to consume feeds of multiple h-entry posts, see [[feed#How_To_Consume|How To Consume Feeds]].
+Pour savoir comment consommer des flux sur plusieurs posts h-entry, voir [[flux#Comment_consommer|Comment Consommer des Flux]].
-To consume a single h-entry:
+Pour consommer un unique h-entry :
 * look for the first h-entry on the page. If none are found, this page does not represent a post.