Home
Draft version:
v0.4
This is a draft specification for the WT data format (validated against the
WT XML Schema).
<?xml version="1.0" encoding="UTF-8"?>
<wt:rsp xmlns:wt="http://wikitracer.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wikitracer.com http://wikitracer.com/xsd/0.4/wt.xsd">
<ts>2009-07-17T12:20:29-05:00</ts>
<wtformat>0.4</wtformat>
<wtplugin>wt_wikkawiki_0.4</wtplugin>
<wiki wid="1">
<title>Wikka</title>
<url>http://wikkawiki.org/</url>
<engine_type>1</engine_type>
<engine_version>1.1.6.0</engine_version>
<age>
<first_edit>2004-03-07T15:08:46-06:00</first_edit>
<last_edit>2009-07-14T22:05:11-05:00</last_edit>
</age>
<pop>
<users>4112</users>
<admins>9</admins>
</pop>
<cont>
<pages>1663</pages>
<good>1663</good>
<wanted>42</wanted>
<orphaned>14</orphaned>
<namespaces>-1</namespaces>
<comments>4152</comments>
<files>15</files>
<edits anon="10000" user="9000" admin="660">19660</edits>
</cont>
<del>
<pages>-1</pages>
<users>-1</users>
</del>
<access>
<anon_edit>1</anon_edit>
<anon_readable_pages>1598</anon_readable_pages>
<anon_writable_pages>0</anon_writable_pages>
<user_readable_pages>1608</user_readable_pages>
<user_writable_pages>1520</user_writable_pages>
</access>
</wiki>
</wt:rsp>
Fields that are disabled or not available in the client wiki should have a
-1 value. A value of
0 means that the field
is enabled and the actual count is equal to zero.
System information fields
| name | type | required? | description |
|---|
| ts | string | required | ISO 8601 timestamp |
| wtplugin | string | required | wt plugin version |
| wtformat | string | required | wt plugin response format |
Wiki information fields
| name | type | required? | description |
|---|
| wid | int | required | WT Unique identifier of client wiki |
| title | string | required | Name of client wiki |
| url | string | required | Base URL of client wiki |
| engine_type | int | required | WT id for supported engine |
| engine_version | string | required | engine version |
age data fields
| name | type | required? | description |
|---|
| first_edit | timestamp | optional | ISO 8601 timestamp of the oldest edit in the wiki. |
| last_edit | timestamp | optional | ISO 8601 timestamp of the most recent edit in the wiki at the time of the response. |
Population data fields
| name | type | required? | description |
|---|
| users | int | optional | Number of active registered users, including administrators |
| admins | int | optional | Number of wiki admins, including moderators or users with other formal content managing roles |
Content data fields
| name | type | required? | description |
|---|
| pages | int | optional | Number of pages (including system or special pages) |
| good | int | optional | Number of real content pages (excluding system or special pages) |
| wanted | int | optional | Number of WantedPages or missing pages linked to from other wiki pages |
| orphaned | int | optional | Number of OrphanedPages or pages not linked from any other wiki page |
| talk | int | optional | Number of talk pages |
| namespaces | int | optional | Number of available namespaces |
| comments | int | optional | Number of comments |
| files | int | optional | Number of files uploaded |
| edits | int | optional | Total number of edits |
| edits.anon | int | optional | Total number of edits by unregistered users (if any) |
| edits.user | int | optional | Total number of edits by registered users (if any) |
| edits.admin | int | optional | Total number of edits by superusers, including admins (if any) |
Moderation data fields
| name | type | required? | description |
|---|
| pages | int | optional | Number of pages removed |
| users | int | optional | Number of users banned |
Access configuration fields
| name | type | required? | description |
|---|
| anon_edit | [0,1] | optional | Anonymous editing allowed |
| anon_readable_pages | int | optional | Number of pages readable to anonymous users |
| anon_writable_pages | int | optional | Number of pages write-accessible to anonymous users |
| readable_pages | int | optional | Number of pages readable to registered users |
| writable_pages | int | optional | Number of pages write-accessible to registered users |
CategorySpecs
This would also enable an alternative response format as JSON data.
(It would also help if this comment form didn't "lose" the page content it is a comment for - being able to refer to content you are commenting on is essential, imo.)
Re: the possibility of displaying the page on top of the comment form, you should drop a line to Brian, who's the author of this change ;)
shouldn't this be broken down into page edits, comment edits and file edits?
This sounds too "lteral" to me, abstract it and you'll find more commonality, I'm sure. And you don't need data that is shared by all - just shared by some.