wiki-2-fr

From Microformats Wiki
Revision as of 05:08, 19 May 2009 by ChristopheDucamp (talk | contribs) ([fr : translation in progress ])
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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

Within documents discussions are often represented through nested lists. They are hard to follow, and hard to differentiate from the actual content of the document. You can now mark them up and have them presented more appropriately, and hopefully more clearly.

  • For discussions: Surround the thread with <div class="discussion"></div>.
  • For raising issues: Surround the thread with <div class="discussion issues"></div>.

The following are examples to show the rendering:

  • I'm not happy with the phrasing of the above. --BenWard 09:50, 17 November 2008 (UTC)
    • I disagree, I think it's fine! --BenWard 09:50, 17 November 2008 (UTC)
  • New wiki does not support declarative creation of animated GIFs on profile pages. This is a big deal for me! --BenWard 09:50, 17 November 2008 (UTC)
    • No. Just… no! --BenWard 09:50, 17 November 2008 (UTC)

Always sign your contributions to discussions using the string --~~~~ at the end of your text.

Mise en Valeur du Code

We've installed a Syntax Highlighting extension. This allows you to have nicer highlighting of many languages used in examples and code snippets on the wiki.

  • To use syntax highlighted source blocks, use the new <source> element. E.g.
  <source lang=html4strict>
  <div class="vcard">
    <a class="fn org" href="http://microformats.org">Microformats.org</a>
  </div>
  </source>

Produces:

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

Note that the language name for HTML is html4strict, not just ‘HTML’. You can find the full list of supported languages on the Syntax Highlighter extension page: 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-issues page.

En rapport