twiki: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(Created TWiki implementation brainstorming page.)
 
m (→‎Mark up articles with hAtom: Couple of email->wiki corrections/rephrasings)
Line 11: Line 11:
==Mark up articles with [[hAtom]]==
==Mark up articles with [[hAtom]]==


The microformats wiki (http://microformats.org/wiki)—which runs MediaWiki with a custom skin that I developed—uses microformats in the mark-up of the page. Namely, each wiki page (article) is marked up using hAtom, providing common structure for titles, authors, content and so forth.  
The microformats wiki—which runs MediaWiki with a custom skin—uses microformats in the mark-up of the page. Namely, each wiki page (article) is marked up using hAtom, providing common structure for titles, authors, content and so forth.


==Provide ability to insert microformats into pages==
==Provide ability to insert microformats into pages==

Revision as of 08:22, 15 August 2009

<entry-title>TWiki</entry-title>

TWiki is an enterprise-grade open-source Wiki platform, used internally by companies like BT, Disney and Yahoo.

They have a small amount of developer documentation from 2008 concerning support for microformats in TWiki, see [1].

This page documents ways TWiki can be enhanced using microformats:

Mark up articles with hAtom

The microformats wiki—which runs MediaWiki with a custom skin—uses microformats in the mark-up of the page. Namely, each wiki page (article) is marked up using hAtom, providing common structure for titles, authors, content and so forth.

Provide ability to insert microformats into pages

That is, to mark-up an event, person, business and so forth as part of an article, is super-cumbersome. This is something no-one has solved yet, and requires an update to the wiki shorthand mark-up mechanism to allow people to add `class`, `rel` and `rev` attributes. Some attempts have made toward this: The Link Attributes extension for MediaWiki augments the link syntax to allow class, rel and rev. http://www.mediawiki.org/wiki/Extension:Link_Attributes

I've also been working on a possible Markdown extension for the same purpose, that might look something like this, using braces for attributes:

[Ben Ward](http://benward.me){fn url, rel=me}

To produce:

<a class="fn url" rel="me">

TWiki could actually evolve in a similar way:

[[http://benward.me][Ben Ward][fn url, rel=me]]

It would also be necessary to allow adding class attributes to arbitrary blocks (p, div, spans etc.)

Automatically mark-up recurring data patterns in pages with microformats

You could go further with some common types of data. Mentions of and links to other TWiki users could be fully marked up as hCards.

Mark up TWiki user profile pages with hCard

TWiki profile pages, which already generate a certain amount of structured data for URLs, organizations, locations and so forth, should be marked up with hCard.

These are directions for development that come to mind straight away, I'm happy to help spec more specific implementation details.