User:Whiteknight/designer3.js
Jump to navigation
Jump to search
Note: After saving, changes may not occur immediately. Click here to learn how to bypass your browser's cache.
- Mozilla / Firefox / Safari: hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac);
- Internet Explorer: hold Ctrl while clicking Refresh, or press Ctrl-F5;
- Konqueror: simply click the Reload button, or press F5;
- Opera users may need to completely clear their cache in Tools→Preferences.
Warning: Malicious code can compromise your account. Page preview will cause your web browser to execute this page's content as code under some skins, including Monobook. If you have any questions about any code you plan to add, you can ask at the appropriate reading room. |
Documentation for this script can be added at User:Whiteknight/designer3. |
//Visual Book designer (vbd) class
var vbd = {
// Version numbers
_require: 2.81,
version: 3.73,
bookpageversion: 0.00,
pageheadversion: 0.00,
// default name of all new books:
pageTree: null,
defName: 'New Book',
defpagename: 'New Page',
defheadname: 'New Heading',
newpagecnt: 1,
newheadcnt: 1,
//div IDs where the gadget is inserted into the page
formspan: "WKVBDSpan",
statspan: "WKVBDStatSpan",
// Navigation templates and configuration parameters
templates: new Array(
["Simple Header", 0, 0, "Simple header"],
["Page Nav Header", 1, 0, "Header with forward/back links"],
["Page Nav Header2", 1, 0, "Header with forward/back links (2)"],
["Page List Header", 0, 1, "Header with page list"],
["Page List Nav", 1, 1, "Header with page list and forward/back links"]
),
template: 0,
// Reading levels
readingLevels: new Array(
'Pre-Reader',
'Beginner',
'Intermediate',
'Advanced',
'Professional'
),
readingLevel: 2,
// Prerequisite and corequisite books
prerequisites: new Array(),
corequisites: new Array(),
// Subjects for categorization
subjects: new Array(),
// whether to include certain special pages in the book by default
useresources: false,
uselicensing: false,
useintroduction: false,
usecollectionpreface: true,
// other options
defaultinherit: false,
defaultcollapse: false,
commentsaspages: false,
useexternaledit: false,
// Drag-n-drop values
lastClicked: null,
offsetX: 0,
offsetY: 0,
startX: 0,
startY: 0,
box: null
};
//Basic array management functions
vbd.CopyArray = function(array) { return array.slice(0); }
vbd.FindPageNameInArray = function (array, name) {
for(var i = 0; i < array.length; i++) {
if(array[i].pagename == name) return i;
}
return -1;
}
vbd.FindHeadNameInArray = function(array, name) {
for(var i = 0; i < array.length; i++) {
if(array[i].label == name) return i;
}
return -1;
}
//Make a checkbox that corresponds to a boolean flag in vbd
vbd.makeOptionsCheckbox = function (field) {
var cbox = wk.makeElement('input', {type: "checkbox"});
cbox.checked = vbd[field];
cbox.onclick = function () { vbd[field] = cbox.checked; }
return cbox;
}
//Initialization functions. If the wk object is not found, the noinit method is called. Otherwise, the
//initialize method is called to start the gadget.
vbd.noinit = function() {
wk.spanText(vbd.formspan, "Cannot load VBD. WKGadgetsCore is missing or is wrong version. "
+ "Please install WKGadgetsCore, or update it to version " + vbd._require + ".");
}
vbd.initialize = function () {
vbd.pageTree = new BookPage(vbd.defName);
vbd.status = wk.spanEditor(vbd.statspan);
vbd.status("Use the outline tool below to create a new book");
var query = wk.getQueryHash();
if(typeof query["book"] == "undefined") {
vbd.visual();
return;
}
vbd.status("Loading the outline for " + query["book"] + "...");
wk.loadWikiText(query["book"], function (text) {
var start = text.indexOf('{{User:Whiteknight/SavedOutlineStart}}');
var end = text.indexOf('{{User:Whiteknight/SavedOutlineEnd}}');
if(start == -1 || end == -1) {
vbd.visual();
return;
}
vbd.loadNodeTree(text.substring(start + 38, end));
vbd.status("Use the outline tool below to create a new book");
});
}
if(typeof wk == 'object' && wk.testVersion(vbd._require)) {
addOnloadHook(vbd.initialize);
} else {
addOnloadHook(vbd.noinit);
}
//rebuild the outline
vbd.visual = function() {
vbd.box = wk.spanText(vbd.formspan, "");
if(vbd.box == null) return;
vbd.box.appendChild(vbd.pageTree.makeNode());
}
//Clear the outline completely and create a new one
vbd.clear = function() {
vbd.pageTree = new BookPage(vbd.defName);
vbd.subjects = new Array();
vbd.readingLevel = 2;
vbd.newpagecnt = 1;
vbd.newheadcnt = 1;
vbd.visual();
}
//Load a saved outline from a save page
vbd.loadNodeTree = function (text) {
vbd.clear();
var lastn = 0;
var last = new Array();
last[0] = vbd.pageTree;
var lines = text.split("\n");
for(i = 0; i < lines.length; i++) {
lines[i] = lines[i].replace(/^[ \t]+/, "");
lines[i] = lines[i].replace(/[ \t]+$/, "");
lines[i] = lines[i].replace(/\r\n/g, "");
if(lines[i] == "") continue;
if(lines[i].match(/^=/)) { //heading
var levels = lines[i].match(/^=+/);
var n = levels[0].length;
var k = n - 1;
var head = new PageHeading(lines[i].substr(n));
last[k].addHeading(head);
last[k] = head;
lastn = k;
} else if(lines[i].match(/^\*+/)) { //subpage
var stars = lines[i].match(/^\*+/);
var n = stars[0].length;
var k = n - 1;
if(last[k] == null) { k = 0; }
last[n] = new BookPage(lines[i].substr(n));
last[k].addSubpage(last[n]);
lastn = n;
} else if(lines[i].match(/^&/)) { //pagetext
last[lastn].pagetext += lines[i].substr(1);
} else if(lines[i].match(/^%/)) { //comment
last[lastn].comments += lines[i].substr(1);
} else { //main title
vbd.pageTree.pagename = lines[i];
lastn = 0;
}
}
vbd.pageTree.formspan.innerHTML = "";
vbd.visual();
vbd.pageTree.formspan.appendChild(document.createTextNode(
'Successfully loaded saved outline'
));
}
//Try to load in a saved collection
vbd.loadNodeTreeCollection = function(text) {
vbd.clear();
var last = vbd.pageTree;
var lines = text.split("\n");
for(var i = 0; i < lines.length; i++) {
if(lines[i].match(/^===/) || lines[i].match(/\[\[category:/i)) {
continue;
} else if(lines[i].match(/^==.+==/)) {
vbd.pageTree.pagename = vbd.extractHeadingName(lines[i]);
} else if(lines[i].match(/^;/)) {
var head = new PageHeading(lines[i].substring(1));
last.addHeading(head);
last = head;
} else if(lines[i].match(/^:\[\[/)) {
if(lines[i].match(/Resources/)) { vbd.useresources = true; continue; }
if(lines[i].match(/Licensing/)) { vbd.uselicensing = true; continue; }
if(lines[i].match(/Wikibooks:/)) { vbd.usecollectionpreface = true; continue; }
var page = new BookPage(vbd.extractLinkPageName(lines[i], vbd.pageTree.pagename));
last.addSubpage(page);
}
}
vbd.visual();
vbd.pageTree.formspan.innerHTML = 'Successfully loaded collection!';
}
//take the wikitext of an arbitrary page and try to load a reasonable outline from it.
vbd.loadNodeTreeTOC = function (text, title) {
vbd.clear();
var lastn = 0;
var last = new Array();
last[0] = vbd.pageTree;
vbd.pageTree.pagename = title;
var lines = text.split("\n");
for(i = 0; i < lines.length; i++) {
lines[i] = lines[i].replace(/^[ \t]+/, "");
lines[i] = lines[i].replace(/[ \t]+$/, "");
lines[i] = lines[i].replace(/\r\n/g, "");
if(lines[i] == "") continue;
if(lines[i].match(/^===.+===/)) { //heading
var head = new PageHeading(vbd.extractHeadingName(lines[i]));
last[0].addHeading(head);
last[0] = head;
} else if(lines[i].match(/^[\*\#]*\s*\[\[.+\]\]/)) { //subpage
if(lines[i].match(/Resources/)) { vbd.useresources = true; continue; }
if(lines[i].match(/Licensing/)) { vbd.uselicensing = true; continue; }
if(lines[i].match(/Category:/i)) continue;
var stars = lines[i].match(/^[\*\#]*/);
var n = stars[0].length;
if(n == 0) n = 1;
var k = n - 1;
if(last[k] == null) { k = 0; }
last[n] = new BookPage(vbd.extractLinkPageName(lines[i], title));
last[k].addSubpage(last[n]);
lastn = n;
}
}
vbd.pageTree.formspan.innerHTML = "";
vbd.visual();
vbd.pageTree.formspan.appendChild(document.createTextNode(
'Successfully loaded outline from ' + title + ' TOC!'
));
}
//try to get the name of a level-3 heading
vbd.extractHeadingName = function(line) {
line = line.substring(3);
line = line.substring(0, line.indexOf("==="));
return line;
}
//Try to get the page name from a link. Very limited ability to deal with relative links
vbd.extractLinkPageName = function(line, title) {
line = line.substring(line.indexOf("[[") + 2);
var end = line.indexOf("|");
if(end == -1) {
end = line.indexOf("]]");
}
line = line.substring(0, end)
if(line.charAt(line.length - 1) == '/') line = line.substring(0, line.length - 1);
if(line.charAt(0) == '/') line = title + line;
for(end = line.indexOf("/") ; end != -1; end = line.indexOf("/")) {
line = line.substring(end + 1);
}
return line;
}
//when saving an outline, find and remove an old save, if one is located on the page.
vbd.killOldSaves = function(text) {
var start = text.indexOf('{{User:Whiteknight/SavedOutlineStart}}');
var end = text.indexOf('{{User:Whiteknight/SavedOutlineEnd}}');
if(start == -1 || end == -1) return text; //no previous save
var prefix = text.slice(0, start);
var suffix = text.slice(end + 36);
return prefix + suffix;
}
//force a page name to use appropriate capitalization
vbd.forceCaps = function(title, isRoot) {
if(isRoot) return vbd.forceTitleCaps(title);
else return vbd.forceFirstCaps(title);
}
//determines if the word needs to be capitalized. Returns 1 if it should be, 0 otherwise.
vbd.isRealWord = function (word) {
var preps = new Array('the', 'in', 'of', 'for', 'to', 'is', 'a', 'an');
for(var i = 0; i < preps.length; i++) {
if(word == preps[i]) return 0;
}
return 1;
}
//book names are forced to title caps
vbd.forceTitleCaps = function(title) {
title.replace("_", " ");
var words = title.split(" ");
for(var i = 0; i < words.length; i++) {
if(words[i].length > 3 || i == 0 || vbd.isRealWord(words[i]))
words[i] = words[i].charAt(0).toUpperCase() + words[i].slice(1);
}
title = words.join(" ");
return title;
}
//page names are forced to have the first letter capitalized, but are not forced to have title-caps
vbd.forceFirstCaps = function(title) {
title.replace("_", " ");
return title.charAt(0).toUpperCase() + title.slice(1);
}
//Create the wikitext of the selected navigation template
vbd.makeTemplateText = function () {
var template = vbd.templates[vbd.template];
var book = vbd.pageTree.pagename;
var text = "{"+"{subst:User:Whiteknight/" + template[0] + "|" +
((template[1])?("book="):("")) + book;
if(template[2] == 1) {
text += "|" + ((template[1] == 1)?("list="):("")) + vbd.pageTree.makeTemplateLinks();
text += "[[" + book + "/Resources|Resources]] - " +
"[[" + book + "/Licensing|Licensing]] - " +
"[[Talk:" + book + "|Discuss]]";
}
return text + "}}";
}
//<noinclude>
// XXX: Drop-down menu utilities. These aren't implemented yet.
//vbd.createDropMenu = function(parent, children) {
// var menu = wk.makeElement('div', {style:"position:absolute; top: 0px; left: 0px; z-index: 10; background-color: white;"});
// wk.appendChildren(menu, children);
// menu.onmouseout = function() {
// parent.removeChild(menu);
// }
// parent.appendChild(menu);
//}
// XXX: Drag'n'Drop utilities. These aren't implemented yet.
//document.addEventListener("mouseup", function(event) {
// if(vbd.lastClicked &&
// event.eventPhase == Event.BUBBLING_PHASE &&
// event.currentTarget == event.target) {
// vbd.lastClicked.box.style.border = "none";
// vbd.lastClicked = null;
// }
//}, false);
//vbd.extractNumber = function(value) {
// var n = parseInt(value);
// return n == null || isNaN(n) ? 0 : n;
//}
//vbd.moveMouse = function(e) {
// vbd.lastClicked.box.style.left = (vbd.offsetX + e.clientX - vbd.startX) + 'px';
// vbd.lastClicked.box.style.top = (vbd.offsetY + e.clientY - vbd.startY) + 'px';
// vbd.status("x:" + vbd.lastClicked.box.style.left + " y: " + vbd.lastClicked.box.style.top);
//}
//</noinclude>