目次
wikiのためのXMLRPCインターフェイス。
JSP Wikiの規格らしい。
http://www.jspwiki.org/Wiki.jsp?page=WikiRPCInterface2
実装がもうあった。
http://www.donzoko.net/cgi/fswiki_xmlrpc/
しかし今後はAtomなのか?
AtomForWiki
utf8はutf-8のstringの意。
array getRecentChanges( Date timestamp ):
timestamp(UTC)以降に更新されたページのリストを得る。
返りは構造体の配列。それぞれ以下の要素を含む。
- name (utf8) : ページ名。
- lastModified (date) : 更新時刻。UTC。
- author (utf8) : 著者 (あれば).
- version (int) : 現在のversion.
int getRPCVersionSupported():
サポートしているJSPWiki APIのバージョン。2を返す。
utf8 getPage( utf8 pagename ):
ページの最新版の生テキストを返す。
utf8 getPageVersion( utf8 pagename, int version ):
版を指定してページの生テキストを返す。
utf8 getPageHTML( utf8 pagename ):
最新版のページのHTMLを返す。
utf8 getPageHTMLVersion( utf8 pagename, int version ):
版を指定してページのHTMLを返す。
array getAllPages():
全てのページ名からなる配列を返す。
struct getPageInfo( utf8 pagename ) :
ページ情報。以下の要素からなる構造体を返す。
- name (utf8): the canonical page name.
- lastModified (date): Last modification date, UTC.
- author (utf8): author name.
- version (int): current version
struct getPageInfoVersion( utf8 pagename, int version ) :
上のバージョン指定版。返すものは同じ。
array listLinks( utf8 pagename ):
ページ内のすべてのリンクのリスト。
それぞれ以下の要素を含む構造体の配列を返す。
- page (utf8) : リンク先のページ名かURL.
- type (utf8) : リンクのタイプ。以下のどちらか。
- "external" : 外部リンク。
- "local" : このWiki内のほかのページへのリンク。
- href (utf8) : このリンクのHREF属性の値。HTML版からこのリンクを見つけやすいように。
(多分、内部リンクの場合などにはpageではurlがわからないからだと思う。)
API ver2 で追加されたもの。
array getBackLinks( utf8 page )
このページにリンクしているページの配列を返す。
putPage( utf8 page, utf8 content, struct attributes )
ページを編集する。
- attribute構造体は各Wiki独自の用途に使用可。サーバーは未対応のものは無視すること。標準的な要素は以下のとおり。
- comment (utf8): コメント。
- minoredit (Boolean???): マイナーな更新かどうか。
- (更新衝突の解決のため、この関数は本来、どのバージョンを編集したものか自称すべき。)
多分必要なもの
array listAttachments( utf8 page )
添付ファイル名のリスト(utf-8)。
base64 getAttachment( utf8 attachmentName )
base64エンコードされた添付ファイルを返す。
putAttachment( utf8 attachmentName, base64 content )
ファイルを添付、上書きする。