mirror of
https://github.com/kennethreitz/dive-into-python3.git
synced 2026-06-05 15:00:18 +00:00
Mark Pilgrim
247 lines
9.0 KiB
JavaScript
247 lines
9.0 KiB
JavaScript
/*
|
|
The following three functions are taken from
|
|
http://code.google.com/p/javascript-search-term-highlighter/
|
|
Copyright 2004 Dave Lemen
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
function parseTerms(query) {
|
|
var s = query + '';
|
|
s = s.replace(/(^|\s)(site|related|link|info|cache):[^\s]*(\s|$)/ig, ' ');
|
|
s = s.replace(/[^a-z0-9_\-]/ig, ' '); // word chars only.
|
|
s = s.replace(/(^|\s)-/g, ' '); // +required -excluded ~synonyms
|
|
s = s.replace(/\b(and|not|or)\b/ig, ' ');
|
|
s = s.replace(/\b[a-z0-9]\b/ig, ' '); // one char terms
|
|
return s.split(/\s+/);
|
|
}
|
|
|
|
function getParamValues(url, parameters) {
|
|
var params = [];
|
|
var p = parameters.replace(/,/, ' ').split(/\s+/);
|
|
if (url.indexOf('?') > 0) {
|
|
var qs = url.substr(url.indexOf('?') + 1);
|
|
var qsa = qs.split('&');
|
|
for (i = 0; i < qsa.length; i++) {
|
|
nameValue = qsa[i].split('=');
|
|
if (nameValue.length != 2) { continue; }
|
|
for (j = 0; j < p.length; j++) {
|
|
if (nameValue[0] == p[j]) {
|
|
params.push(unescape(nameValue[1]).toLowerCase().replace(/\+/g, ' '));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return params;
|
|
}
|
|
|
|
function getSearchTerms() {
|
|
var highlighterParameters = 'q as_q as_epq as_oq query search';
|
|
var a = [];
|
|
var params = getParamValues(document.referrer/*document.location.href*/, highlighterParameters);
|
|
var terms;
|
|
for (i = 0; i < params.length; i++) {
|
|
terms = parseTerms(params[i]);
|
|
for (j = 0; j < terms.length; j++) {
|
|
if (terms[j] !== '') {
|
|
a.push(terms[j].toLowerCase());
|
|
}
|
|
}
|
|
}
|
|
return a;
|
|
}
|
|
|
|
/*
|
|
|
|
The rest of this script is
|
|
Copyright (c) 2009, Mark Pilgrim, All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without modification,
|
|
are permitted provided that the following conditions are met:
|
|
|
|
* Redistributions of source code must retain the above copyright notice,
|
|
this list of conditions and the following disclaimer.
|
|
* Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
var HS = {'visible': 'hide', 'hidden': 'show'};
|
|
|
|
function hideTOC() {
|
|
var toc = '<span class="nm u">‣</span> <a href="javascript:showTOC()">show table of contents</a>';
|
|
$("#toc").html(toc);
|
|
}
|
|
|
|
function showTOC() {
|
|
var toc = '';
|
|
var old_level = 1;
|
|
var level;
|
|
$('h2,h3').each(function(i, h) {
|
|
level = parseInt(h.tagName.substring(1), 10);
|
|
if (level < old_level) {
|
|
toc += '</ol>';
|
|
} else if (level > old_level) {
|
|
toc += '<ol>';
|
|
}
|
|
toc += '<li><a href=#' + h.id + '>' + h.innerHTML + '</a>';
|
|
old_level = level;
|
|
});
|
|
while (level > 1) {
|
|
toc += '</ol>';
|
|
level -= 1;
|
|
}
|
|
toc = '<span class="nm u">▾</span> <a href="javascript:hideTOC()">hide table of contents</a><ol start=0><li><a href=table-of-contents.html><span class=u>↑</span> Full table of contents</a></li>' + toc.substring(4);
|
|
$("#toc").html(toc);
|
|
}
|
|
|
|
$(document).ready(function() {
|
|
hideTOC();
|
|
prettyPrint();
|
|
|
|
/* on-hover permalink markers on each section header */
|
|
$('*:header[id]').each(function() {
|
|
$('<a class=hl>#</a>').
|
|
attr('href', '#' + this.id).
|
|
appendTo(this);
|
|
});
|
|
|
|
/* "hide", "open in new window", and (optionally) "download" widgets on code & screen blocks */
|
|
$("pre > code").each(function(i) {
|
|
var pre = $(this.parentNode);
|
|
if (pre.parents("table").length === 0) {
|
|
pre.addClass("code");
|
|
}
|
|
});
|
|
$("pre.code:not(.nd), pre.screen:not(.nd)").each(function(i) {
|
|
/* give each code block a unique ID */
|
|
this.id = "autopre" + i;
|
|
|
|
/* wrap code block in a div and insert widget block */
|
|
$(this).wrapInner('<div class=b></div>');
|
|
var widgetHTML = '<div class=w>[<a class=toggle href="javascript:toggleCodeBlock(\'' + this.id + '\')">' + HS.visible + '</a>] [<a href="javascript:plainTextOnClick(\'' + this.id + '\')">open in new window</a>]';
|
|
if ($(this).hasClass('cmdline')) {
|
|
widgetHTML += ' [<a href="troubleshooting.html#getting-to-the-command-line">command line help</a>]';
|
|
}
|
|
widgetHTML += '</div>';
|
|
$(this).prepend(widgetHTML);
|
|
|
|
/* move download link into widget block */
|
|
$(this).prev("p.d").each(function(i) {
|
|
$(this).next("pre").find("div.w").append(" " + $(this).html());
|
|
this.parentNode.removeChild(this);
|
|
});
|
|
|
|
/* create skip links */
|
|
var postelm = $(this).next().get(0);
|
|
var postid = postelm.id || ("postautopre" + i);
|
|
postelm.id = postid;
|
|
$(this).before('<p class=skip><a href=#' + postid + '>skip over this code listing</a>');
|
|
});
|
|
|
|
$("pre.screen.cmdline:not(.nd)").each(function(i) {
|
|
/* add link to command-line help */
|
|
this.id = "autopre" + i;
|
|
});
|
|
|
|
/* make skip links disappear until you tab to them */
|
|
$(".skip a").blur(function() {
|
|
$(this).css({'position':'absolute','left':'0px','top':'-500px','width':'1px','height':'1px','overflow':'hidden'});
|
|
});
|
|
$(".skip a").blur();
|
|
$(".skip a").focus(function() {
|
|
$(this).css({'position':'static','width':'auto','height':'auto'});
|
|
});
|
|
|
|
if (!$.browser.msie) {
|
|
/* synchronized highlighting on callouts and their associated lines within code & screen blocks */
|
|
var hip = {'background-color':'#eee','cursor':'default'};
|
|
var unhip = {'background-color':'inherit','cursor':'inherit'};
|
|
$("pre.code, pre.screen").each(function() {
|
|
var _this = $(this);
|
|
window.setTimeout(function() {
|
|
var s = '';
|
|
var ol = _this.next("ol");
|
|
var refs = _this.find("a:not([href])");
|
|
refs.each(function(i) {
|
|
var li = ol.find("li:nth-child(" + (i+1) + ")");
|
|
s += "<tr><td style='text-align:center;vertical-align:baseline;margin:0;padding:0;width:2em;border:0'><span class='u'>&#x" + (parseInt('2460', 16) + i).toString(16) + ";</span></td><td style='vertical-align:top;margin:0;padding:0;width:auto;border:0'>" + li.html() + "</td></tr>";
|
|
});
|
|
ol.replaceWith("<table style='width:100%;border-collapse:collapse;margin:0;border:0'>" + s + "</table>");
|
|
refs.each(function(i) {
|
|
var a = $(this);
|
|
var li = a.parents("pre").next("table").find("tr:nth-child(" + (i+1) + ") td:nth-child(2)");
|
|
li.add(a).hover(function() { a.css(hip); li.css(hip); },
|
|
function() { a.css(unhip); li.css(unhip); });
|
|
});
|
|
}, 0);
|
|
});
|
|
|
|
/* synchronized highlighting on callouts and their associated table rows */
|
|
$("table").each(function() {
|
|
$(this).find("tr:gt(0)").each(function(i) {
|
|
var tr = $(this);
|
|
window.setTimeout(function() {
|
|
var li = tr.parents("table").next("ol").find("li:nth-child(" + (i+1) + ")");
|
|
if (li.length > 0) {
|
|
li.add(tr).hover(function() { tr.css(hip); li.css(hip); },
|
|
function() { tr.css(unhip); li.css(unhip); });
|
|
}
|
|
}, 0);
|
|
});
|
|
});
|
|
}
|
|
|
|
/* match <dfn> terms with incoming search keywords and jump to the containing section */
|
|
var searchTerms = getSearchTerms();
|
|
$("dfn").each(function() {
|
|
var dfn = $(this);
|
|
var dfnTerm = dfn.text().toLowerCase();
|
|
if ($.inArray(dfnTerm, searchTerms) != -1) {
|
|
var section = dfn.parents("p,table,ul,ol,blockquote").prevAll("*:header").get(0);
|
|
if (section) {
|
|
window.setTimeout(function() {document.location.hash = section.id;}, 0);
|
|
return false;
|
|
}
|
|
}
|
|
});
|
|
|
|
}); /* document.ready */
|
|
|
|
function toggleCodeBlock(id) {
|
|
$("#" + id).find("div.b").toggle();
|
|
var a = $("#" + id).find("a.toggle");
|
|
a.text(a.text() == HS.visible ? HS.hidden : HS.visible);
|
|
}
|
|
|
|
function plainTextOnClick(id) {
|
|
var clone = $("#" + id).clone();
|
|
clone.find("div.w, span.u").remove();
|
|
var win = window.open("about:blank", "plaintext", "toolbar=0,scrollbars=1,location=0,statusbar=0,menubar=0,resizable=1,width=600,height=400,left=35,top=75");
|
|
win.document.open();
|
|
win.document.write('<pre>' + clone.html());
|
|
win.document.close();
|
|
}
|