User:PerfektesChaos/js/versionControl

JavaScript which automatically maintains lists with resource version identification.

The list ist formatted as JavaScript source code. By loading into some context the content is directly available then somewhere else.

Usage edit

Just load the js file within your user script:

mw.loader.load("//en.wikipedia.org/w/index.php?title="
               + "User:PerfektesChaos/js/versionControl/r.js"
               + "&action=raw&ctype=text/javascript",
               "text/javascript");

Standard execution will be performed automatically.

All articles (typically JavaScript or CSS) are checked whether the corresponding list entry is still up to date. If not, the list script will be modified automatically after all, within some 15 or 10 seconds.

In order to get permission for editing it is necessary to be logged in when executing the script.

Loading and execution may be linked to the situation of viewing some resources in the list. This happens immediately after saving the resource. Unfortunatey, there is no after-save-hook in the editing process.

The script is designed to be used across wiki domains. Within the same wiki a query for revision ID via API would be straight, which is denied for cross site security reasons.

Format edit

Every entry is one array with three elements:
1. Path to article (resource)
  - Currently and by default it points to a sub page of the current user.
2. Revision ID revid or curid of the latest resource version.
3. Time stamp (ISO 8601)
The list of entries is stored as an array.
The first entry of this array is an array with one element, a string. It is set to the most recent update of the list.

mw.libs.versionControl.proj.enwiki.PerfektesChaos.rv = [
["Fri, 11 Mar 2011 19:06:55 GMT"],
["js/versionControl/d.js",418336805,"2011-03-11T19:02:06Z"],
["js/versionControl/r.js",418337480,"2011-03-11T19:06:50Z"],
... ];

Example edit

versionControl.js

Configuration edit

All variables have default values, but may be adjusted to particular requirements.

For user specification an application object ist to be defined (best before mw.loader.load) by:

mw.libs.versionControl  =  { opt:  { store:  "User:Usy/vc.js",
                                     signer: "Usy",
                                     symbol: "myVersions"
                                   }
                           };

.opt.store edit

Location of the list script.

Default: User:wgUserName/versionControl.js

.opt.signer edit

Nickname for the hosting user.

Default: wgUserName

.opt.symbol edit

Name of a particular global variable which has to be declared as an object (that includes Array) in advance.

Default: see VersionInfo

VersionInfo edit

Current version information is available as object at

.proj[DBNAME][Nick].rv

DBNAME – wgDBname, like enwiki
Nick – .opt.signer

….rv is just the Array read from stored list page.

Codes edit

ResourceLoader edit

Module ID:

user:PerfektesChaos/versionControl

Sources edit

r.js – compressed code for loading
d.js – commented code for reading by human beings

[ German page ]