Wiki Microformats.org 2.0

From Microformats Wiki
Jump to navigation Jump to search

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. --ChristopheDucamp 05:25, 19 May 2009 (UTC)
    • Pas d'accord. Je pense que ça pourra suffire pour aujourd'hui ! --ChristopheDucamp 05:25, 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

Le projet Wiki 2.0 a été implémenté par User:BenWard. Le style visuel est dérivé du thème original microformats.org de Dan Cederholm. Le wiki utilise aussi les icônes merveilleusement utiles Fam Fam Fam Silk de Mark James.

Problématiques

Rendez compte svp des problématiques de bugs et demandes de fonctionnalités sur la page wiki-2-issues.

En rapport