Ruby-MediaWiki/Documentation: Unterschied zwischen den Versionen

Aus C3D2
Wechseln zu: Navigation, Suche
(I can even document myself :-))
(I can even document myself :-))
Zeile 3: Zeile 3:
 
==MediaWiki==
 
==MediaWiki==
  
===MediaWiki::dotfile===
+
===MediaWiki::dotfile(myrealm=nil)===
 +
 
 
dotfile function reads the user's MediaWiki config and creates a Wiki instance.
 
dotfile function reads the user's MediaWiki config and creates a Wiki instance.
  
Zeile 17: Zeile 18:
 
The Article class represents MediaWiki articles.
 
The Article class represents MediaWiki articles.
  
===MediaWiki::Article#delete===
+
===MediaWiki::Article::new(wiki, name, section = nil, load_text=true)===
 +
 
 +
Create a new Article instance
 +
 
 +
; wiki:
 +
: [Wiki] instance to be used to theive the MiniBrowser
 +
; name:
 +
: [String] Article name
 +
; section:
 +
: [Fixnum] Optional article section number
 +
; load_text:
 +
: [Boolean] Invoke Article#reload to retrieve Article#text
 +
 
 +
 
 +
===MediaWiki::Article#delete(reason)===
 +
 
 
Delete this article
 
Delete this article
  
* '''reason:''' [String] Delete reason
+
; reason:
 +
: [String] Delete reason
 +
 
 +
 
 +
===MediaWiki::Article#protect(reason, moves_only=false)===
  
===MediaWiki::Article#protect===
 
 
Protect this article
 
Protect this article
  
* '''reason:''' [String] Protect reason
+
; reason:
 +
: [String] Protect reason
 +
 
 +
 
 +
===MediaWiki::Article#reload()===
  
===MediaWiki::Article#reload===
 
 
Reload Article#text, should be done by Article#initialize.
 
Reload Article#text, should be done by Article#initialize.
  
  
===MediaWiki::Article#submit===
+
===MediaWiki::Article#submit(summary, minor_edit=false, watch_this=false)===
 +
 
 
Push the '''Submit''' button
 
Push the '''Submit''' button
  
 
Send the modified Article#text to the MediaWiki.
 
Send the modified Article#text to the MediaWiki.
  
* '''summary:''' [String] Change summary
+
; summary:
* '''minor_edit:''' [Boolean] This is a Minor Edit
+
: [String] Change summary
* '''watch_this:''' [Boolean] Watch this article
+
; minor_edit:
 +
: [Boolean] This is a Minor Edit
 +
; watch_this:
 +
: [Boolean] Watch this article
 +
 
 +
 
 +
===MediaWiki::Article#unprotect(reason)===
  
===MediaWiki::Article#unprotect===
 
 
Unprotect this article
 
Unprotect this article
  
* '''reason:''' [String] Unprotect reason
+
; reason:
 +
: [String] Unprotect reason
 +
 
 +
 
 +
===MediaWiki::Article#what_links_here()===
  
===MediaWiki::Article#what_links_here===
 
 
What articles link to this article?
 
What articles link to this article?
  
* '''result:''' [Array] of [String] Article names
+
; result:
 +
: [Array] of [String] Article names
 +
 
 +
 
 +
===MediaWiki::Article#xhtml()===
  
===MediaWiki::Article#xhtml===
 
 
Get the XHTML, will invoke Article#xhtml_reload if not already cached
 
Get the XHTML, will invoke Article#xhtml_reload if not already cached
  
* '''result:''' [REXML::Element] html root element
+
; result:
 +
: [REXML::Element] html root element
  
===MediaWiki::Article#xhtml_reload===
 
Reload the xhtml, will be automatically done by Article#xhtml if not already cached.
 
  
 +
===MediaWiki::Article#xhtml_reload()===
  
===MediaWiki::Article::new===
+
Reload the xhtml, will be automatically done by Article#xhtml if not already cached.
Create a new Article instance
 
  
* '''wiki:''' [Wiki] instance to be used to theive the MiniBrowser
 
* '''name:''' [String] Article name
 
* '''section:''' [Fixnum] Optional article section number
 
* '''load_text:''' [Boolean] Invoke Article#reload to retrieve Article#text
 
  
 
==MediaWiki::Category==
 
==MediaWiki::Category==
Zeile 71: Zeile 100:
 
The Category class represents MediaWiki categories.
 
The Category class represents MediaWiki categories.
  
===MediaWiki::Category#articles===
+
===MediaWiki::Category::new(wiki, name)===
 +
 
 +
Create a new Category instance
 +
 
 +
; wiki:
 +
: [Wiki] instance to be used to theive the MiniBrowser
 +
; name:
 +
: [String] Category name, to be prefixed with "Category:" when being fetched
 +
 
 +
 
 +
===MediaWiki::Category#articles()===
 +
 
 
Which articles belong to this category?
 
Which articles belong to this category?
  
* '''result:''' [Array] of [String] Article names
+
; result:
 +
: [Array] of [String] Article names
 +
 
 +
 
 +
===MediaWiki::Category#reload()===
  
===MediaWiki::Category#reload===
 
 
Reload the XML, will be invoked by Category#articles, if not already cached.
 
Reload the XML, will be invoked by Category#articles, if not already cached.
  
  
===MediaWiki::Category::new===
+
==MediaWiki::MiniBrowser==
Create a new Category instance
+
 
 +
===MediaWiki::MiniBrowser::new( url )===
 +
 
 +
 
 +
===MediaWiki::MiniBrowser#add_cookie( cookies )===
  
* '''wiki:''' [Wiki] instance to be used to theive the MiniBrowser
 
* '''name:''' [String] Category name, to be prefixed with "Category:" when being fetched
 
  
==MediaWiki::MiniBrowser==
+
===MediaWiki::MiniBrowser#cookies()===
  
===MediaWiki::MiniBrowser#add_cookie===
 
  
===MediaWiki::MiniBrowser#cookies===
+
===MediaWiki::MiniBrowser#get_content(url)===
  
===MediaWiki::MiniBrowser#get_content===
 
  
===MediaWiki::MiniBrowser#post_content===
+
===MediaWiki::MiniBrowser#post_content( url, data )===
  
===MediaWiki::MiniBrowser::new===
 
  
 
==MediaWiki::Table==
 
==MediaWiki::Table==
  
===MediaWiki::Table#text===
+
===MediaWiki::Table::new( data = [], header = [] )===
 +
 
  
===MediaWiki::Table::new===
+
===MediaWiki::Table::parse( text )===
  
===MediaWiki::Table::parse===
 
 
takes the wiki markup of a table and returns a 2-dimensional array representing the rows and columns of the table
 
takes the wiki markup of a table and returns a 2-dimensional array representing the rows and columns of the table
  
 
TODO: fill member variables according to parsed tables
 
TODO: fill member variables according to parsed tables
 +
 +
 +
===MediaWiki::Table#text()===
  
  
 
==MediaWiki::Wiki==
 
==MediaWiki::Wiki==
  
===MediaWiki::Wiki#allpages===
+
===MediaWiki::Wiki::new(url, user = nil, password = nil)===
 +
 
 +
Initialize a new Wiki instance.
 +
 
 +
; url:
 +
: [String] URL-Path to index.php (without index.php), may containt <em>user:password</em> combination.
 +
; user:
 +
: [String] If not nil, log in with that MediaWiki username (see Wiki#login)
 +
; password:
 +
: [String] If not nil, log in with that MediaWiki password (see Wiki#login)
 +
 
 +
 
 +
===MediaWiki::Wiki#allpages()===
 +
 
 
Returns the pages listed on "Special:Allpages"
 
Returns the pages listed on "Special:Allpages"
  
* '''result:''' [Array] of [String] Articlenames
+
; result:
 +
: [Array] of [String] Articlenames
 +
 
 +
 
 +
===MediaWiki::Wiki#article(name, section = nil)===
  
===MediaWiki::Wiki#article===
 
 
Return a new Article instance with given name, will be constructed with [self] (for MiniBrowser usage)
 
Return a new Article instance with given name, will be constructed with [self] (for MiniBrowser usage)
  
* '''name:''' [String] Article name
+
; name:
* '''section:''' [Fixnum] Optional section number
+
: [String] Article name
 +
; section:
 +
: [Fixnum] Optional section number
 +
 
 +
 
 +
===MediaWiki::Wiki#article_url(name, section = nil)===
  
===MediaWiki::Wiki#article_url===
 
 
Construct the URL to a specific article
 
Construct the URL to a specific article
  
Zeile 130: Zeile 195:
 
Often called by Article, Category, ...
 
Often called by Article, Category, ...
  
* '''name:''' [String] Article name
+
; name:
* '''section:''' [Fixnum] Optional section number
+
: [String] Article name
 +
; section:
 +
: [Fixnum] Optional section number
 +
 
 +
 
 +
===MediaWiki::Wiki#category(name)===
  
===MediaWiki::Wiki#category===
 
 
Return a new Category instance with given name, will be constructed with [self] (for MiniBrowser usage)
 
Return a new Category instance with given name, will be constructed with [self] (for MiniBrowser usage)
  
* '''name:''' [String] Category name (to be prepended with "Category:")
+
; name:
 +
: [String] Category name (to be prepended with "Category:")
 +
 
 +
 
 +
===MediaWiki::Wiki#login( username, password )===
  
===MediaWiki::Wiki#login===
 
 
Log in into MediaWiki
 
Log in into MediaWiki
  
 
This is '''not''' HTTP authentication (put HTTP-Auth into [url] of Wiki#initialize!)
 
This is '''not''' HTTP authentication (put HTTP-Auth into [url] of Wiki#initialize!)
  
* '''user:''' [String] MediaWiki username
+
; user:
* '''password:''' [String] MediaWiki password
+
: [String] MediaWiki username
 +
; password:
 +
: [String] MediaWiki password
 +
 
 
May raise an exception if cannot authenticate
 
May raise an exception if cannot authenticate
 
 
===MediaWiki::Wiki::new===
 
Initialize a new Wiki instance.
 
 
* '''url:''' [String] URL-Path to index.php (without index.php), may containt <tt>user:password</tt> combination.
 
* '''user:''' [String] If not nil, log in with that MediaWiki username (see Wiki#login)
 
* '''password:''' [String] If not nil, log in with that MediaWiki password (see Wiki#login)
 

Version vom 14. Dezember 2005, 02:24 Uhr

Ruby-MediaWiki Documentation

MediaWiki

MediaWiki::dotfile(myrealm=nil)

dotfile function reads the user's MediaWiki config and creates a Wiki instance.

The filename is determined by the environment variable MEDIAWIKI_RC or defaults to ~/.mediawikirc .

A configured wiki can be chosen with the MEDIAWIKI_WIKI environment variable, or defaults to the wiki pointed by default.

A robot may set [myrealm] to retrieve a second result output: a section with this name in the current wiki's configuration file for configuration of specific robot tasks.


MediaWiki::Article

The Article class represents MediaWiki articles.

MediaWiki::Article::new(wiki, name, section = nil, load_text=true)

Create a new Article instance

wiki
[Wiki] instance to be used to theive the MiniBrowser
name
[String] Article name
section
[Fixnum] Optional article section number
load_text
[Boolean] Invoke Article#reload to retrieve Article#text


MediaWiki::Article#delete(reason)

Delete this article

reason
[String] Delete reason


MediaWiki::Article#protect(reason, moves_only=false)

Protect this article

reason
[String] Protect reason


MediaWiki::Article#reload()

Reload Article#text, should be done by Article#initialize.


MediaWiki::Article#submit(summary, minor_edit=false, watch_this=false)

Push the Submit button

Send the modified Article#text to the MediaWiki.

summary
[String] Change summary
minor_edit
[Boolean] This is a Minor Edit
watch_this
[Boolean] Watch this article


MediaWiki::Article#unprotect(reason)

Unprotect this article

reason
[String] Unprotect reason


MediaWiki::Article#what_links_here()

What articles link to this article?

result
[Array] of [String] Article names


MediaWiki::Article#xhtml()

Get the XHTML, will invoke Article#xhtml_reload if not already cached

result
[REXML::Element] html root element


MediaWiki::Article#xhtml_reload()

Reload the xhtml, will be automatically done by Article#xhtml if not already cached.


MediaWiki::Category

The Category class represents MediaWiki categories.

MediaWiki::Category::new(wiki, name)

Create a new Category instance

wiki
[Wiki] instance to be used to theive the MiniBrowser
name
[String] Category name, to be prefixed with "Category:" when being fetched


MediaWiki::Category#articles()

Which articles belong to this category?

result
[Array] of [String] Article names


MediaWiki::Category#reload()

Reload the XML, will be invoked by Category#articles, if not already cached.


MediaWiki::MiniBrowser

MediaWiki::MiniBrowser::new( url )

MediaWiki::MiniBrowser#add_cookie( cookies )

MediaWiki::MiniBrowser#cookies()

MediaWiki::MiniBrowser#get_content(url)

MediaWiki::MiniBrowser#post_content( url, data )

MediaWiki::Table

MediaWiki::Table::new( data = [], header = [] )

MediaWiki::Table::parse( text )

takes the wiki markup of a table and returns a 2-dimensional array representing the rows and columns of the table

TODO: fill member variables according to parsed tables


MediaWiki::Table#text()

MediaWiki::Wiki

MediaWiki::Wiki::new(url, user = nil, password = nil)

Initialize a new Wiki instance.

url
[String] URL-Path to index.php (without index.php), may containt user:password combination.
user
[String] If not nil, log in with that MediaWiki username (see Wiki#login)
password
[String] If not nil, log in with that MediaWiki password (see Wiki#login)


MediaWiki::Wiki#allpages()

Returns the pages listed on "Special:Allpages"

result
[Array] of [String] Articlenames


MediaWiki::Wiki#article(name, section = nil)

Return a new Article instance with given name, will be constructed with [self] (for MiniBrowser usage)

name
[String] Article name
section
[Fixnum] Optional section number


MediaWiki::Wiki#article_url(name, section = nil)

Construct the URL to a specific article

Uses the [url] the Wiki instance was constructed with, appends "index.php", the name parameter and, optionally, the section.

Often called by Article, Category, ...

name
[String] Article name
section
[Fixnum] Optional section number


MediaWiki::Wiki#category(name)

Return a new Category instance with given name, will be constructed with [self] (for MiniBrowser usage)

name
[String] Category name (to be prepended with "Category:")


MediaWiki::Wiki#login( username, password )

Log in into MediaWiki

This is not HTTP authentication (put HTTP-Auth into [url] of Wiki#initialize!)

user
[String] MediaWiki username
password
[String] MediaWiki password

May raise an exception if cannot authenticate