twiki: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (→‎Mark up articles with hAtom: Couple of email->wiki corrections/rephrasings)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
<entry-title>TWiki</entry-title>
{{DISPLAYTITLE:TWiki}}


[http://twiki.org TWiki] is an enterprise-grade open-source Wiki platform, used internally by companies like BT, Disney and Yahoo.
[http://twiki.org TWiki] is an enterprise-grade open-source Wiki platform, used internally by companies like BT, Disney and Yahoo.
Line 9: Line 9:
__TOC__
__TOC__


==Mark up articles with [[hAtom]]==
== MicroformatsPlugin ==


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.
Supports [[hCalendar]], [[hCard]], and [[XFN]].


==Provide ability to insert microformats into pages==
The TWiki [http://twiki.org/cgi-bin/view/Plugins/MicroformatsPlugin MicroformatsPlugin] supports hCard with a little xfn, and also hCalendar. usage:
* =%HCARD{"WikiName"}% - uses the UserForm data on a user's Topic to create a hCard.
* =%HEVENT{start="" end="" url="" location="" summary="" description=""}% - e.g. %HEVENT{start="2011-11-20" url="http://twiki.org/" location="Cupertino Community Center" summary="TWiki helps the enterprise to be agile" description="TWiki Enterprise Collaboration Platform"}%


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
For more info see: http://twiki.org/cgi-bin/view/Plugins/MicroformatsPlugin
 
I've also been working on a possible Markdown extension for the same purpose, that might look something like this, using braces for attributes:
 
<source lang=text>[Ben Ward](http://benward.me){fn url, rel=me}</source>
 
To produce:
 
<source lang=html4strict><a class="fn url" rel="me"></source>
 
TWiki could actually evolve in a similar way:
 
<source lang=text>[[http://benward.me][Ben Ward][fn url, rel=me]]</source>
 
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==
==Automatically mark-up recurring data patterns in pages with microformats==
Line 40: Line 28:


These are directions for development that come to mind straight away, I'm happy to help spec more specific implementation details.
These are directions for development that come to mind straight away, I'm happy to help spec more specific implementation details.
== see also ==
* [[cms]]
* [[wiki]]
* [[mediawiki]]

Latest revision as of 16:33, 18 July 2020


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:

MicroformatsPlugin

Supports hCalendar, hCard, and XFN.

The TWiki MicroformatsPlugin supports hCard with a little xfn, and also hCalendar. usage:

  • =%HCARD{"WikiName"}% - uses the UserForm data on a user's Topic to create a hCard.
  • =%HEVENT{start="" end="" url="" location="" summary="" description=""}% - e.g. %HEVENT{start="2011-11-20" url="http://twiki.org/" location="Cupertino Community Center" summary="TWiki helps the enterprise to be agile" description="TWiki Enterprise Collaboration Platform"}%

For more info see: http://twiki.org/cgi-bin/view/Plugins/MicroformatsPlugin

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.

see also