wiki-2-fr

From Microformats Wiki
wiki-2-fr /
Jump to navigation Jump to search

<entry-title>Wiki Microformats.org 2.0</entry-title>

Microformats.org a été servi par un moteur MediaWiki avec un thÚme proche du défaut depuis sa création en 2005. Au fil des années, le type de contenu publié sur le wiki s'est établi, et les pratiques d'édition de notre communauté mieux comprises. Le projet 'Wiki 2.0' est une entreprise pour mettre à jour notre logiciel wiki afin de mieux coller aux besoins de la communauté, et de saisir l'opportunité d'ajouter aussi quelque scintillement visuel.

Résumé des Modifications

  • MediaWiki a Ă©tĂ© mis Ă  jour de la version 1.4 vers la version 1.13.2.
  • Le stylisme visuel du wiki a Ă©tĂ© mis Ă  jour sur une skin complĂštement personnalisĂ©e, fondĂ©e sur le design original de Dan Cederholm sur microformats.org.
  • La fonctionnalitĂ© de recherche est dĂ©sormais localisĂ©e tout en haut et Ă  droite de la page, parce que la voir enterrĂ©e plus bas Ă©tait idiot.
  • L'en-tĂȘte lie maintenant vers d'autres parties vitales du site microformats — le blog et les archives de la liste de discussion.
  • Quelques nouvelles extensions ont Ă©tĂ© ajoutĂ©e Ă  l'installation MediaWiki
    • les Ă©lĂ©ments phrase HTML sont dĂ©sormais complĂštement supportĂ©s
    • Ajout de la mise en valeur de la syntaxe pour le Code
    • Les titres de pages peuvent maintenant ĂȘtre rĂ©crits dans le marquage (par ex. 'hcard' peut devenir 'hCard', ou des transformations plus ambitieuses)
  • Les pages de ‘Discussion’ ont Ă©tĂ© complĂštement dĂ©sactivĂ©es, plutĂŽt que simplement ‘cachĂ©es’.
  • Toutes les pages wiki sont marquĂ©es avec hAtom et hCalendar
  • Nous utiliserons dĂ©sormais la fonctionnalitĂ© des catĂ©gories de MediaWiki pour mieux organiser notre contenu.
    • Les pages placĂ©es Ă  l'intĂ©rieur de la catĂ©gorie Specifications reçoivent un style spĂ©cial ‘spec-like’ (voir hCard).
    • Les pages placĂ©es dans la catĂ©gorie Draft Specification reçoivent un style spĂ©cial ‘spec-like’ (voir hResume)
    • Les pages placĂ©es dans quelque catĂ©gorie de spĂ©cification que ce soit gĂ©nĂšreront des liens vers leurs pages respectives de problĂ©matiques.
  • TOC — table des matiĂšres — est maintenant proprement stylisĂ© dans le thĂšme. Plus besoin d'utiliser les styles dans la ligne pour aligner la table des matiĂšres sur la droite.
  • Il y a dĂ©sormais un support de stylisme pour Ă  la fois les problĂ©matiques de suivi dans la ligne et les discussions dans l'imbricage de liste. Avant il Ă©tait difficile d'identifier la documentation de discussion Ă  partir du contenu proposĂ©, et difficile de suivre les fils de discussion. Le marquage est maintenant supportĂ© pour styliser cela de façon plus appropriĂ©.
  • Votre nom d'utilisateur a maintenant un Gravatar qui s'affiche, comme dans les commentaires de blog.
  • Au moment de modifier une page, les boutons 'Publier' et 'PrĂ©visualiser' ont Ă©tĂ© inversĂ©s pour essayer d'encourager les personnes Ă  prĂ©visualiser avant de publier.

Comment Utiliser Wiki 2.0

Ce qui suit essaye d'expliquer comment mieux utiliser les nouvelles fonctionnalités de Wiki 2.0.

Titres des Pages

Entre la 1.4 et 1.13 MediaWiki a rĂ©parĂ© un bug oĂč les titres marquĂ©s avec des Ă©lĂ©ments HTML Ă©taient exclus de la Table des MatiĂšres sur les pages. Nous utilisions alors les Ă©lĂ©ments H1 pour neutraliser les titres des pages tout en conservant la numĂ©rotation de la Table des MatiĂšres en 1.1, 1.2, 1.3, etc. Depuis que ce bug est rĂ©parĂ©, ce hack a Ă©tĂ© remplacĂ© par un mĂ©canisme plus robuste.

PlutÎt que d'utiliser les éléments H1 pour titrer vos pages, utilisez à la place le nouvel élément entry-title. Ceci est analysé par une extension MediaWiki et passe outre le titre de l'entrée tel qu'affiché sur la page, tout en l'excluant de la Table des MatiÚres. C'est ainsi nommé, parce que cela correspond à l'élément entry-title dans le hAtom inclus dans chaque entrée.

Ecriture des Spécifications

Le nouveau wiki supporte l'affichage spécial des documents de spécifications, différent des pages normales. Les pages sont stylisés plus clairement et le contenu occupe la totalité de la largeur de la page, proche de la documentation provenant du W3C, WHATWG et d'autres corps. La barre latérale est poussée en bas dans un pied de page étendue, de façon à ce que toutes les fonctionnalités demeurent.

Pour permettre ces vues, vous devez ajouter votre page à une catégorie particuliÚre.

  • Les spĂ©cifications devraient ĂȘtre ajoutĂ©es Ă  la catĂ©gorie ‘Specifications’, en ajoutant [[Category:Specifications]] Ă  la base du document.
  • Les 'Draft Specifications' devraient ĂȘtre ajoutĂ©e Ă  la catĂ©gorie ‘Draft Specifications’ en ajoutant [[Category:Draft Specifications]] Ă  la base du document. Vous devez aussi inclure le modĂšle {{DraftSpecification}} dans l'en-tĂȘte de votre document, afin de fournir une diffĂ©renciation textuelle du brouillon.

Remarquez S.V.P. que les pages de problĂ©matiques, les pages de brainstorming, les straw-men et tout ce qu'il y a d'autres non explicitement SpĂ©cification Draft ou Documentation de SpĂ©cification ne devraient pas ĂȘtre ajoutĂ©s Ă  ces catĂ©gories et devraient continuer Ă  ĂȘtre prĂ©sentĂ© comme des pages wiki normales.ar wiki pages.

Les catĂ©gories devraient ĂȘtre dĂ©clarĂ©es Ă  la base des articles, svp.

Discussions et Problématiques

Dans les documents, les discussions sont souvent représentées à travers des listes imbriquées. Elles sont difficiles à suivre et à différencier du véritable contenu du document. Vous pouvez maintenant les marquer et faire qu'elles soient présentées judicieusement, et nous l'espérons plus clairement.

  • Pour les discussions : entourez le fil avec <div class="discussion"></div>.
  • Pour valoriser les problĂ©matiques : entourez le fil avec <div class="discussion issues"></div>.

Voici des exemples pour prĂ©senter le rendu :

  • Je ne suis pas trĂšs satisfait de la traduction ci-dessus. -- 05:19, 19 May 2009 (UTC)
    • Pas d'accord. Je pense que ça pourra suffire pour aujourd'hui ! -- ChristopheDucamp 05:19, 19 May 2009 (UTC)
  • Le nouveau wiki ne supporte pas la crĂ©ation dĂ©clarative de GIFs animĂ©s sur les pages de profil.. Parfait pour moi, belle Ă©volution ! --BenWard 09:50, 17 November 2008 (UTC)
    • Non. Juste
 non ! --BenWard 09:50, 17 November 2008 (UTC)

Signez toujours vos contributions aux discussions en utilisant la chaĂźne --~~~~ Ă  la fin de votre texte.

Mise en Valeur du Code

Nous avons installé une extension Syntax Highlighting. Ceci vous permet d'avoir une mise en valeur plus élégante de bon nombre de langages dans les exemples et de fragments de codes sur le wiki.

  • Pour utiliser des blocs de source mis en valeur, utilisez le nouvel Ă©lĂ©ment <source>. Par exemple :
  <source lang=html4strict>
  <div class="vcard">
    <a class="fn org" href="http://microformats.org">Microformats.org</a>
  </div>
  </source>

Produit

  <div class="vcard">
    <a class="fn org" href="http://microformats.org">Microformats.org</a>
  </div>

Notez que le nom du langage pour le HTML est html4strict, pas juste ‘HTML’. Vous pouvez trouver la liste complĂšte de tous les langages supportĂ©s sur la page d'extension Syntax Highlighter : http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages

Crédits

The Wiki 2.0 project was implemented by User:BenWard. The visual style is derived from the original microformats.org theme by Dan Cederholm. The wiki also uses the wonderfully useful Fam Fam Fam Silk icons by Mark James.

Problématiques

Please report, bugs issues and requests on the Wiki 2.0 Issues page.

En rapport