include-pattern-fr - Revision history

Aaronpk: Replace with {{DISPLAYTITLE:}}

2020-07-18T16:28:23Z

Replace <entry-title> with {{DISPLAYTITLE:}}

← Older revision		Revision as of 16:28, 18 July 2020
Line 1:		Line 1:
	~~<entry-title>~~ include pattern ~~</entry-title>~~		{{DISPLAYTITLE: include pattern }}

	Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du modèle dans d'autres microformats, et pour que les éditeurs travaillent avec.		Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du modèle dans d'autres microformats, et pour que les éditeurs travaillent avec.

ChristopheDucamp: Reverted edits by I MADE THOUSANDS OF ACCOUNTS IN MICROFORMATS WIKI GO TO CHECK OUT THE USER LIST ([[User talk:I MADE THOUSANDS OF ACCOUNTS IN MICROF

2013-09-22T11:15:14Z

Reverted edits by I MADE THOUSANDS OF ACCOUNTS IN MICROFORMATS WIKI GO TO CHECK OUT THE USER LIST ([[User talk:I MADE THOUSANDS OF ACCOUNTS IN MICROF

Show changes

I MADE THOUSANDS OF ACCOUNTS IN MICROFORMATS WIKI GO TO CHECK OUT THE USER LIST at 03:14, 22 September 2013

2013-09-22T03:14:47Z

Show changes

ChristopheDucamp: [fr: sync'd with original page]

2012-04-20T21:35:37Z

[fr: sync'd with original page]

← Older revision		Revision as of 21:35, 20 April 2012
Line 1:		Line 1:
	<entry-title> include pattern </entry-title>		<entry-title> include pattern </entry-title>

	Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du ~~pattern~~ dans d'autres microformats, et pour que les éditeurs travaillent avec.		Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du modèle dans d'autres microformats, et pour que les éditeurs travaillent avec.

	; Auteurs		; Auteurs
Line 8:		Line 8:

	; Traduction		; Traduction
	: [[User:ChristopheDucamp\|Christophe Ducamp]])		: [[User:ChristopheDucamp\|Christophe Ducamp]]

	== historique ==		== historique ==
	[[hresume-fr\|hResume]] avait besoin de la capacité d'inclure un nom provenant d'une hCard dans le haut d'un curriculum vitae — les détails de contact de la personne — à l'intérieur des hCards séparées utilisées dans l'historique d'emploi de la même personne. Répéter l'information de nom n'aurait pas correspondu aux techniques de publication existantes utilisées dans les résumés et Curriculum Vitæ, ç'aurait été peu commode pour les auteurs, et énervants pour les clients. L'include-pattern est un mécanisme pour référencer les données provenant de la même page, pour éviter la répétition, ou pour ''toute'' information dupliquée.		[[hresume-fr\|hResume]] avait besoin de la capacité d'inclure un nom provenant d'une hCard dans le haut d'un curriculum vitae — les détails de contact de la personne — à l'intérieur des hCards séparées utilisées dans l'historique d'emploi de la même personne. Répéter l'information de nom n'aurait pas correspondu aux techniques de publication existantes utilisées dans les résumés et Curriculum Vitæ, ç'aurait été peu commode pour les auteurs et énervants pour les clients. L'include-pattern est un mécanisme pour référencer les données provenant de la même page, pour éviter la répétition, ou pour ''toute'' information dupliquée.

	== étendue ==		== étendue ==
Line 19:		Line 19:
	L'include-pattern est un mécanisme pour inclure le contenu provenant d'un microformat à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :		L'include-pattern est un mécanisme pour inclure le contenu provenant d'un microformat à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :

	<~~pre><nowiki~~><a class="include" href="#auteur" title="Jean Levin"></a></~~nowiki></pre~~>		<source lang=html4strict><a class="include" href="#auteur" title="Jean Levin"></a></source>
	<~~pre><nowiki~~><object class="include" data="#auteur"></object></~~nowiki></pre~~>		<source lang=html4strict><object class="include" data="#auteur"></object></source>

	Dans les specs qui citent include-pattern, soit l'un des deux morceaux de code au-dessus amèneront le parseur de microformat à remplacer l'élément A ou OBJECT avec le nom de classe "include" par le fragment de contenu avec l'ID "auteur". Des exemples complets suivent.		Dans les specs qui citent include-pattern, soit l'un des deux morceaux de code au-dessus amèneront le parseur de microformat à remplacer l'élément A ou OBJECT avec le nom de classe "include" par le fragment de contenu avec l'ID "auteur". Des exemples complets suivent.
Line 86:		Line 86:
	Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.		Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.

	Les auteurs ~~DEVRaien~~ fournir un texte de contenu ou au moins un texte d'attribut <code>title</code> pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.		Les auteurs DEVRAIENT fournir un texte de contenu ou au moins un texte d'attribut <code>title</code> pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.

	===== accessibilité =====		===== accessibilité =====
Line 102:		Line 102:
	==== exemple Object ====		==== exemple Object ====

	~~Voici la même~~ [[hcard-fr\|hCard]] ~~prise au~~ début ~~du résume~~ dans ~~l'exemple précédent.~~		La [[hcard-fr\|hCard]] du début d'un résumé décrivant la personne dans le résumé est :

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<span class="fn n" id="jean-hcard-nom">		<span class="fn n" id="jean-hcard-nom">
Line 110:		Line 110:
	</span>		</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	Ailleurs sur la page, une seconde hCard ré-utilise le contenu "fn n" extrait de la première hCard :		Ailleurs sur la page, une seconde hCard avec l'information de l'employeur, ré-utilise le contenu "fn n" extrait de la première hCard :

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<object data="#jean-hcard-nom" class="include"></object>		<object data="#jean-hcard-nom" class="include"></object>
Line 120:		Line 120:
	<span class="title">Microformat Brainstormer</span>		<span class="title">Microformat Brainstormer</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément include <code>object</code> remplacé complèteent par le sous-arbre qu'il a référencé :		Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément include <code>object</code> remplacé complèteent par le sous-arbre qu'il a référencé :

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<span class="fn n" id="jean-hcard-nom">		<span class="fn n" id="jean-hcard-nom">
Line 132:		Line 132:
	<span class="title">Microformat Brainstormer</span>		<span class="title">Microformat Brainstormer</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	Cette méthode d'indirection de propriété hCard via un élément object peut s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés-sur-des-classes.		Cette méthode d'indirection de propriété hCard via un élément object peut s'appliquer à n'importe lesquelles/toutes les propriétés dans les microformats fondés-sur-des-classes.

	=== notes et problématiques===		=== notes et problématiques===
	* A la différence du pattern-hyperlien, l' Object Include Pattern n'a pas besoin de quelque recours textuel. Ceci le rend invisible à l'Assistive Technology.		* A la différence du pattern-hyperlien, l'Object Include Pattern n'a pas besoin de quelque recours textuel. Ceci le rend invisible à l'Assistive Technology.
	* Apple~~'s Safari~~ (WebKit~~-based~~) ~~browser has some rendering issues with this use of~~ <code>object</code>: ~~You should set a width and height of~~ "0" ~~for the~~ include ~~elements to resolve this~~ ('''version(s) ~~affected needed~~''').		* Le navigateur Safari d'Apple (basé-sur-WebKit) a quelques problèmes de rendu d'affichage avec cet usage de <code>object</code> : Vous devriez régler une largeur et hauteur à "0" pour les éléments include afin de résoudre ça ('''besoin des version(s) affectées''').
	* ~~Bugs have been reported in some~~ web ~~browsers~~ (Internet Explorer, Safari, Firefox) ~~that~~ <code>object</code> ~~elements referencing~~ fragments ~~of the same~~ document ~~erroneously cause the browser to make additional~~ HTTP ~~requests~~ ('''version(s) ~~affected needed~~'''). ~~For scenarios where~~ HTTP ~~requests are a sensitive~~ performance ~~measure~~, ~~this makes the~~ Object Include Pattern ~~inappropriate~~.		* Des bugs ont été rapportés dans quelques navigateurs web (Internet Explorer, Safari, Firefox) que les éléments <code>object</code> faisant référence à des fragments du même document amenant le navigateur à faire des requêtes additionnelles HTTP ('''besoin des version(s) affectées'''). Pour les scénarii où les requêtes HTTP sont une mesure de performance sensible, ceci rend le Object Include Pattern inapproprié.
	* ~~Versions of~~ Microsoft Internet Explorer ~~with~~ ActiveX ~~controls disabled will throw a warning prompt upon finding an~~ <code>object</code> ~~element~~ ('''version(s) ~~affected needed~~''').		* Les versions de Microsoft Internet Explorer avec les contrôles ActiveX désactivés afficheront un message d'alerte en trouvant un élément <code>object</code> ('''besoin des version(s) affectées''').

	==remerciements ==		==remerciements ==

ChristopheDucamp: [fr: typo - sync'd]

2009-09-06T08:53:06Z

[fr: typo - sync'd]

← Older revision		Revision as of 08:53, 6 September 2009
Line 1:		Line 1:
	<h1> include pattern </h1>		<entry-title> include pattern </entry-title>
	~~{{TOC-right}}~~
	Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du pattern dans d'autres microformats, et pour que les éditeurs travaillent avec.		Initialement développé en tant que section du [[resume-brainstorming-fr\|resume-brainstorming]], l'include-pattern est un mécanisme pour inclure une portion de données dans une autre aire de la même page. Ce qui suit est de la documentation pour réutilisation du pattern dans d'autres microformats, et pour que les éditeurs travaillent avec.

Line 17:		Line 17:

	== référence rapide ==		== référence rapide ==
	L'include-pattern est un mécanisme pour inclure le contenu provenant d'un ~~microfomrat~~ à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :		L'include-pattern est un mécanisme pour inclure le contenu provenant d'un microformat à l'intérieur d'un autre microformat ailleurs dans le même document, en utilisant les hyperliens (recommandé) ou OBJECT. Par exemple :

	<pre><nowiki><a class="include" href="#auteur" title="Jean Levin"></a></nowiki></pre>		<pre><nowiki><a class="include" href="#auteur" title="Jean Levin"></a></nowiki></pre>
Line 46:		Line 46:
	Voici une [[hcard-fr\|hCard]] provenant du début d'un C.V., montrée ici sous une hCard verbeuse.		Voici une [[hcard-fr\|hCard]] provenant du début d'un C.V., montrée ici sous une hCard verbeuse.

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<span class="fn n" id="jean-hcard-nom">		<span class="fn n" id="jean-hcard-nom">
Line 54:		Line 54:
	<span class="title">Microformat Brainstormer</span>		<span class="title">Microformat Brainstormer</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	Ailleurs sur la page, une seconde hCard réutilise le contenu "fn n" tiré de la première hCard :		Ailleurs sur la page, une seconde hCard réutilise le contenu "fn n" tiré de la première hCard :

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<a href="#jean-hcard-nom" class="include" title="Jean Levine"></a>		<a href="#jean-hcard-nom" class="include" title="Jean Levine"></a>
Line 64:		Line 64:
	<span class="title">Microformat Brainstormer</span>		<span class="title">Microformat Brainstormer</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	Notez que le manque de contenu dans l'élément <code>a</code> avec <code>class="include"</code> est délibéré, car il renvoie vers l'exigence de design provenant du [[hresume-fr\|hResume]] de ne pas avoir à répéter <em>quelque</em> information de nom avec chaque entrée de job. L'attribut <code>title</code> est utilisé pour aider les agents-utilisateurs qui désirent étiqueter l'hyperlien en dehors de son élément dans la ligne.		Notez que le manque de contenu dans l'élément <code>a</code> avec <code>class="include"</code> est délibéré, car il renvoie vers l'exigence de design provenant du [[hresume-fr\|hResume]] de ne pas avoir à répéter <em>quelque</em> information de nom avec chaque entrée de job. L'attribut <code>title</code> est utilisé pour aider les agents-utilisateurs qui désirent étiqueter l'hyperlien en dehors de son élément dans la ligne.
Line 71:		Line 71:
	Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément hyperlien include complètement remplacé (y compris le texte-à-l'intérieur) par le sous-arbre qui était référencé :		Un parseur microformat doit traiter la seconde hCard comme suit, avec l'élément hyperlien include complètement remplacé (y compris le texte-à-l'intérieur) par le sous-arbre qui était référencé :

	<~~pre><nowiki~~>		<source lang=html4strict>
	<span class="vcard">		<span class="vcard">
	<span class="fn n" id="jean-hcard-nom">		<span class="fn n" id="jean-hcard-nom">
Line 79:		Line 79:
	<span class="title">Microformat Brainstormer</span>		<span class="title">Microformat Brainstormer</span>
	</span>		</span>
	</~~nowiki></pre~~>		</source>

	==== notes et problématiques ====		==== notes et problématiques ====

	Note : La valeur de l'attribut <code>id</code> dans l'exemple "jean-hcard-nom" a été choisie à des fins de démonstration. Le texte de la valeur n'a pas d'autre sémantique selon l'include-pattern que de connecter la source de l'include vers la destination. Les auteurs {{should-fr}} utiliser de bonnes techniques [[posh-fr\|CHIC]] pour choisir les noms <code>id</code> et <code>class</code>.		Note : La valeur de l'attribut <code>id</code> dans l'exemple "jean-hcard-nom" a été choisie à des fins de démonstration. Le texte de la valeur n'a pas d'autre sémantique selon l'include-pattern que de connecter la source de l'include vers la destination. Les auteurs {{should-fr}} utiliser de bonnes techniques [[posh-fr\|CHIC]] pour choisir les noms <code>id</code> et <code>class</code>.

	Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.		Utiliser l'hyperlien-include-pattern ne provoque pas de problématiques connues dans n'importe quel navigateur, tant que les includes hyperliens sans contenus sont cachés avec CSS. Voir en-dessous pour les détails.

	Les auteurs ~~{{should-fr}}~~ fournir un texte de contenu ou au moins un texte d'attribut <code>title</code> pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.		Les auteurs DEVRaien fournir un texte de contenu ou au moins un texte d'attribut <code>title</code> pour l'hyperlien lui-même. Ceci peut exiger de répéter un petit bout d'information (comme celui du nom d'une personne dans une hCard) ou inclure un texte générique adapté au contexte de la page.

	===== accessibilité =====		===== accessibilité =====
	Les <strong>hyperliens présentés sous une liste extraite.</strong> Deux points de vue là-dessus. Le premier est que l'expérience utilisateur de "Assistive Technology" peuvent (pourraient) être sévèrement dégradés par la présence d'~~hypermiens~~ qui ne contiennent pas de texte (voir [http://yuiblog.com/blog/2008/01/23/empty-links/ Empty Links and Screen Readers] pour les résultats de tests véritables). Le second est que la première déclaration n'est juste qu'un effet de bord de quelques "Assistive Technologies" extrayant les hyperliens dans un document est les présentant sous une liste, et que de telles technologies / fonctionnalités n'ont pas le droit de faire ainsi, et par conséquent ce n'est pas votre problème de vous en soucier. Voir See [http://joeclark.org/appearances/atmedia2007/#context Joe Clark: When accessibility is not your problem: Headings and links read out of context], en particulier :		Les <strong>hyperliens présentés sous une liste extraite.</strong> Deux points de vue là-dessus. Le premier est que l'expérience utilisateur de "Assistive Technology" peuvent (pourraient) être sévèrement dégradés par la présence d'hyperliens qui ne contiennent pas de texte (voir [http://yuiblog.com/blog/2008/01/23/empty-links/ Empty Links and Screen Readers] pour les résultats de tests véritables). Le second est que la première déclaration n'est juste qu'un effet de bord de quelques "Assistive Technologies" extrayant les hyperliens dans un document est les présentant sous une liste, et que de telles technologies / fonctionnalités n'ont pas le droit de faire ainsi, et par conséquent ce n'est pas votre problème de vous en soucier. Voir See [http://joeclark.org/appearances/atmedia2007/#context Joe Clark: When accessibility is not your problem: Headings and links read out of context], en particulier :
	<blockquote><p>As writers, we are not authorizing you or Jaws to pull out our link text and remix it. Why don’t you rearrange the sentences, too?</p></blockquote>		<blockquote><p>As writers, we are not authorizing you or Jaws to pull out our link text and remix it. Why don’t you rearrange the sentences, too?</p></blockquote>

	<strong>Hyperliens et onglets dans les navigateurs communs</strong>. ~~As noted in the~~ [http://microformats.org/wiki/include-pattern-feedback include-pattern feedback ~~page~~], ~~any~~ visible ~~hyperlink used with an~~ <code>href</code> ~~attribute ends up in the~~ browser~~'s tab cycle~~. ~~This affects all keyboard users~~ (~~both sighted users that can't/don't operate a mouse~~, ~~or screen reader users in the extreme case~~). ~~Even empty hyperlinks receive focus~~. ~~This can be tested by modifying the~~ code ~~of the original~~ [http://allinthehead.com/demo/include.html a@include test ~~page~~] ~~to visually follow the tabbing from one hyperlink to the next~~ (~~using CSS or, for test purposes~~, ~~subtly changing the~~ <code>href</code>, ~~tabbing through the~~ page, ~~and observing the change in the~~ URL ~~displayed in the browser's status bar~~). ~~Hyperlinks hidden with~~ CSS <code>display:none</code> ~~do not end up in the browser's tab~~ cycle.		<strong>Hyperliens et onglets dans les navigateurs communs</strong>. Comme cela est noté dans la [http://microformats.org/wiki/include-pattern-feedback page include-pattern feedback], tout hyperlien visible utilisé avec un attribut <code>href</code> finit dans le cycle de tabulation du browser. Ceci affecte tous les utilisateurs de clavier (à la fois les voyants qui ne peuvent pas opérer une souris, ou les utilisateurs de lecteurs écran dans le cas extrême). Même les hyperliens vides reçoivent de l'attention. Ce peut être testé en modifiant le code de la page [http://allinthehead.com/demo/include.html a@include test] pour suivre visuellement la tabulation d'un hyperlien au suivant (en utilisant ou à des fins de tests, de changer subtilement le <code>href</code>, en tabulant à travers la page, et en observant le changement dans l'URL affiché dans la barre de statut du navigateur). Les hyperliens cachés avec CSS <code>display:none</code> ne parviennent pas dans le cycle de tabulation du navigateur.

	~~Thus it is recommended that~~ Hyperlink ~~Include Pattern hyperlinks lacking inline content~~ {{should}} ~~be hidden with~~ CSS. ~~As they have no content~~, ~~this stylistic change has no~~ net ~~effect on the~~ document'~~s content semantics from a user's~~ perspective.		De ce fait, il est recommandé que les hyperliens sur le "Modèle Include Hyperlink" manquant de contenu en ligne {{should-fr}} être caché avec CSS. Du fait qu'ils n'ont pas de contenus, ce changement stylistique n'a pas d'effet net sur le contenu sémantique du document du point de vue d'une perspective utilisateur.

	=== Object ===		=== Object ===