mirror of https://github.com/freeCodeCamp/devdocs
Simon Legner
3 years ago
commit
885783f36d
@ -1 +1 @@
|
||||
2.7.4
|
||||
2.7.6
|
||||
|
||||
@ -1,240 +0,0 @@
|
||||
/*
|
||||
* classList.js: Cross-browser full element.classList implementation.
|
||||
* 1.1.20170427
|
||||
*
|
||||
* By Eli Grey, http://eligrey.com
|
||||
* License: Dedicated to the public domain.
|
||||
* See https://github.com/eligrey/classList.js/blob/master/LICENSE.md
|
||||
*/
|
||||
|
||||
/*global self, document, DOMException */
|
||||
|
||||
/*! @source http://purl.eligrey.com/github/classList.js/blob/master/classList.js */
|
||||
|
||||
if ("document" in self) {
|
||||
|
||||
// Full polyfill for browsers with no classList support
|
||||
// Including IE < Edge missing SVGElement.classList
|
||||
if (!("classList" in document.createElement("_"))
|
||||
|| document.createElementNS && !("classList" in document.createElementNS("http://www.w3.org/2000/svg","g"))) {
|
||||
|
||||
(function (view) {
|
||||
|
||||
"use strict";
|
||||
|
||||
if (!('Element' in view)) return;
|
||||
|
||||
var
|
||||
classListProp = "classList"
|
||||
, protoProp = "prototype"
|
||||
, elemCtrProto = view.Element[protoProp]
|
||||
, objCtr = Object
|
||||
, strTrim = String[protoProp].trim || function () {
|
||||
return this.replace(/^\s+|\s+$/g, "");
|
||||
}
|
||||
, arrIndexOf = Array[protoProp].indexOf || function (item) {
|
||||
var
|
||||
i = 0
|
||||
, len = this.length
|
||||
;
|
||||
for (; i < len; i++) {
|
||||
if (i in this && this[i] === item) {
|
||||
return i;
|
||||
}
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
// Vendors: please allow content code to instantiate DOMExceptions
|
||||
, DOMEx = function (type, message) {
|
||||
this.name = type;
|
||||
this.code = DOMException[type];
|
||||
this.message = message;
|
||||
}
|
||||
, checkTokenAndGetIndex = function (classList, token) {
|
||||
if (token === "") {
|
||||
throw new DOMEx(
|
||||
"SYNTAX_ERR"
|
||||
, "An invalid or illegal string was specified"
|
||||
);
|
||||
}
|
||||
if (/\s/.test(token)) {
|
||||
throw new DOMEx(
|
||||
"INVALID_CHARACTER_ERR"
|
||||
, "String contains an invalid character"
|
||||
);
|
||||
}
|
||||
return arrIndexOf.call(classList, token);
|
||||
}
|
||||
, ClassList = function (elem) {
|
||||
var
|
||||
trimmedClasses = strTrim.call(elem.getAttribute("class") || "")
|
||||
, classes = trimmedClasses ? trimmedClasses.split(/\s+/) : []
|
||||
, i = 0
|
||||
, len = classes.length
|
||||
;
|
||||
for (; i < len; i++) {
|
||||
this.push(classes[i]);
|
||||
}
|
||||
this._updateClassName = function () {
|
||||
elem.setAttribute("class", this.toString());
|
||||
};
|
||||
}
|
||||
, classListProto = ClassList[protoProp] = []
|
||||
, classListGetter = function () {
|
||||
return new ClassList(this);
|
||||
}
|
||||
;
|
||||
// Most DOMException implementations don't allow calling DOMException's toString()
|
||||
// on non-DOMExceptions. Error's toString() is sufficient here.
|
||||
DOMEx[protoProp] = Error[protoProp];
|
||||
classListProto.item = function (i) {
|
||||
return this[i] || null;
|
||||
};
|
||||
classListProto.contains = function (token) {
|
||||
token += "";
|
||||
return checkTokenAndGetIndex(this, token) !== -1;
|
||||
};
|
||||
classListProto.add = function () {
|
||||
var
|
||||
tokens = arguments
|
||||
, i = 0
|
||||
, l = tokens.length
|
||||
, token
|
||||
, updated = false
|
||||
;
|
||||
do {
|
||||
token = tokens[i] + "";
|
||||
if (checkTokenAndGetIndex(this, token) === -1) {
|
||||
this.push(token);
|
||||
updated = true;
|
||||
}
|
||||
}
|
||||
while (++i < l);
|
||||
|
||||
if (updated) {
|
||||
this._updateClassName();
|
||||
}
|
||||
};
|
||||
classListProto.remove = function () {
|
||||
var
|
||||
tokens = arguments
|
||||
, i = 0
|
||||
, l = tokens.length
|
||||
, token
|
||||
, updated = false
|
||||
, index
|
||||
;
|
||||
do {
|
||||
token = tokens[i] + "";
|
||||
index = checkTokenAndGetIndex(this, token);
|
||||
while (index !== -1) {
|
||||
this.splice(index, 1);
|
||||
updated = true;
|
||||
index = checkTokenAndGetIndex(this, token);
|
||||
}
|
||||
}
|
||||
while (++i < l);
|
||||
|
||||
if (updated) {
|
||||
this._updateClassName();
|
||||
}
|
||||
};
|
||||
classListProto.toggle = function (token, force) {
|
||||
token += "";
|
||||
|
||||
var
|
||||
result = this.contains(token)
|
||||
, method = result ?
|
||||
force !== true && "remove"
|
||||
:
|
||||
force !== false && "add"
|
||||
;
|
||||
|
||||
if (method) {
|
||||
this[method](token);
|
||||
}
|
||||
|
||||
if (force === true || force === false) {
|
||||
return force;
|
||||
} else {
|
||||
return !result;
|
||||
}
|
||||
};
|
||||
classListProto.toString = function () {
|
||||
return this.join(" ");
|
||||
};
|
||||
|
||||
if (objCtr.defineProperty) {
|
||||
var classListPropDesc = {
|
||||
get: classListGetter
|
||||
, enumerable: true
|
||||
, configurable: true
|
||||
};
|
||||
try {
|
||||
objCtr.defineProperty(elemCtrProto, classListProp, classListPropDesc);
|
||||
} catch (ex) { // IE 8 doesn't support enumerable:true
|
||||
// adding undefined to fight this issue https://github.com/eligrey/classList.js/issues/36
|
||||
// modernie IE8-MSW7 machine has IE8 8.0.6001.18702 and is affected
|
||||
if (ex.number === undefined || ex.number === -0x7FF5EC54) {
|
||||
classListPropDesc.enumerable = false;
|
||||
objCtr.defineProperty(elemCtrProto, classListProp, classListPropDesc);
|
||||
}
|
||||
}
|
||||
} else if (objCtr[protoProp].__defineGetter__) {
|
||||
elemCtrProto.__defineGetter__(classListProp, classListGetter);
|
||||
}
|
||||
|
||||
}(self));
|
||||
|
||||
}
|
||||
|
||||
// There is full or partial native classList support, so just check if we need
|
||||
// to normalize the add/remove and toggle APIs.
|
||||
|
||||
(function () {
|
||||
"use strict";
|
||||
|
||||
var testElement = document.createElement("_");
|
||||
|
||||
testElement.classList.add("c1", "c2");
|
||||
|
||||
// Polyfill for IE 10/11 and Firefox <26, where classList.add and
|
||||
// classList.remove exist but support only one argument at a time.
|
||||
if (!testElement.classList.contains("c2")) {
|
||||
var createMethod = function(method) {
|
||||
var original = DOMTokenList.prototype[method];
|
||||
|
||||
DOMTokenList.prototype[method] = function(token) {
|
||||
var i, len = arguments.length;
|
||||
|
||||
for (i = 0; i < len; i++) {
|
||||
token = arguments[i];
|
||||
original.call(this, token);
|
||||
}
|
||||
};
|
||||
};
|
||||
createMethod('add');
|
||||
createMethod('remove');
|
||||
}
|
||||
|
||||
testElement.classList.toggle("c3", false);
|
||||
|
||||
// Polyfill for IE 10 and Firefox <24, where classList.toggle does not
|
||||
// support the second argument.
|
||||
if (testElement.classList.contains("c3")) {
|
||||
var _toggle = DOMTokenList.prototype.toggle;
|
||||
|
||||
DOMTokenList.prototype.toggle = function(token, force) {
|
||||
if (1 in arguments && !this.contains(token) === !force) {
|
||||
return force;
|
||||
} else {
|
||||
return _toggle.call(this, token);
|
||||
}
|
||||
};
|
||||
|
||||
}
|
||||
|
||||
testElement = null;
|
||||
}());
|
||||
|
||||
}
|
||||
@ -1,841 +0,0 @@
|
||||
;(function () {
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* @preserve FastClick: polyfill to remove click delays on browsers with touch UIs.
|
||||
*
|
||||
* @codingstandard ftlabs-jsv2
|
||||
* @copyright The Financial Times Limited [All Rights Reserved]
|
||||
* @license MIT License (see LICENSE.txt)
|
||||
*/
|
||||
|
||||
/*jslint browser:true, node:true*/
|
||||
/*global define, Event, Node*/
|
||||
|
||||
|
||||
/**
|
||||
* Instantiate fast-clicking listeners on the specified layer.
|
||||
*
|
||||
* @constructor
|
||||
* @param {Element} layer The layer to listen on
|
||||
* @param {Object} [options={}] The options to override the defaults
|
||||
*/
|
||||
function FastClick(layer, options) {
|
||||
var oldOnClick;
|
||||
|
||||
options = options || {};
|
||||
|
||||
/**
|
||||
* Whether a click is currently being tracked.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
this.trackingClick = false;
|
||||
|
||||
|
||||
/**
|
||||
* Timestamp for when click tracking started.
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.trackingClickStart = 0;
|
||||
|
||||
|
||||
/**
|
||||
* The element being tracked for a click.
|
||||
*
|
||||
* @type EventTarget
|
||||
*/
|
||||
this.targetElement = null;
|
||||
|
||||
|
||||
/**
|
||||
* X-coordinate of touch start event.
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.touchStartX = 0;
|
||||
|
||||
|
||||
/**
|
||||
* Y-coordinate of touch start event.
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.touchStartY = 0;
|
||||
|
||||
|
||||
/**
|
||||
* ID of the last touch, retrieved from Touch.identifier.
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.lastTouchIdentifier = 0;
|
||||
|
||||
|
||||
/**
|
||||
* Touchmove boundary, beyond which a click will be cancelled.
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.touchBoundary = options.touchBoundary || 10;
|
||||
|
||||
|
||||
/**
|
||||
* The FastClick layer.
|
||||
*
|
||||
* @type Element
|
||||
*/
|
||||
this.layer = layer;
|
||||
|
||||
/**
|
||||
* The minimum time between tap(touchstart and touchend) events
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.tapDelay = options.tapDelay || 200;
|
||||
|
||||
/**
|
||||
* The maximum time for a tap
|
||||
*
|
||||
* @type number
|
||||
*/
|
||||
this.tapTimeout = options.tapTimeout || 700;
|
||||
|
||||
if (FastClick.notNeeded(layer)) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Some old versions of Android don't have Function.prototype.bind
|
||||
function bind(method, context) {
|
||||
return function() { return method.apply(context, arguments); };
|
||||
}
|
||||
|
||||
|
||||
var methods = ['onMouse', 'onClick', 'onTouchStart', 'onTouchMove', 'onTouchEnd', 'onTouchCancel'];
|
||||
var context = this;
|
||||
for (var i = 0, l = methods.length; i < l; i++) {
|
||||
context[methods[i]] = bind(context[methods[i]], context);
|
||||
}
|
||||
|
||||
// Set up event handlers as required
|
||||
if (deviceIsAndroid) {
|
||||
layer.addEventListener('mouseover', this.onMouse, true);
|
||||
layer.addEventListener('mousedown', this.onMouse, true);
|
||||
layer.addEventListener('mouseup', this.onMouse, true);
|
||||
}
|
||||
|
||||
layer.addEventListener('click', this.onClick, true);
|
||||
layer.addEventListener('touchstart', this.onTouchStart, false);
|
||||
layer.addEventListener('touchmove', this.onTouchMove, false);
|
||||
layer.addEventListener('touchend', this.onTouchEnd, false);
|
||||
layer.addEventListener('touchcancel', this.onTouchCancel, false);
|
||||
|
||||
// Hack is required for browsers that don't support Event#stopImmediatePropagation (e.g. Android 2)
|
||||
// which is how FastClick normally stops click events bubbling to callbacks registered on the FastClick
|
||||
// layer when they are cancelled.
|
||||
if (!Event.prototype.stopImmediatePropagation) {
|
||||
layer.removeEventListener = function(type, callback, capture) {
|
||||
var rmv = Node.prototype.removeEventListener;
|
||||
if (type === 'click') {
|
||||
rmv.call(layer, type, callback.hijacked || callback, capture);
|
||||
} else {
|
||||
rmv.call(layer, type, callback, capture);
|
||||
}
|
||||
};
|
||||
|
||||
layer.addEventListener = function(type, callback, capture) {
|
||||
var adv = Node.prototype.addEventListener;
|
||||
if (type === 'click') {
|
||||
adv.call(layer, type, callback.hijacked || (callback.hijacked = function(event) {
|
||||
if (!event.propagationStopped) {
|
||||
callback(event);
|
||||
}
|
||||
}), capture);
|
||||
} else {
|
||||
adv.call(layer, type, callback, capture);
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
// If a handler is already declared in the element's onclick attribute, it will be fired before
|
||||
// FastClick's onClick handler. Fix this by pulling out the user-defined handler function and
|
||||
// adding it as listener.
|
||||
if (typeof layer.onclick === 'function') {
|
||||
|
||||
// Android browser on at least 3.2 requires a new reference to the function in layer.onclick
|
||||
// - the old one won't work if passed to addEventListener directly.
|
||||
oldOnClick = layer.onclick;
|
||||
layer.addEventListener('click', function(event) {
|
||||
oldOnClick(event);
|
||||
}, false);
|
||||
layer.onclick = null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Windows Phone 8.1 fakes user agent string to look like Android and iPhone.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsWindowsPhone = navigator.userAgent.indexOf("Windows Phone") >= 0;
|
||||
|
||||
/**
|
||||
* Android requires exceptions.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsAndroid = navigator.userAgent.indexOf('Android') > 0 && !deviceIsWindowsPhone;
|
||||
|
||||
|
||||
/**
|
||||
* iOS requires exceptions.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsIOS = /iP(ad|hone|od)/.test(navigator.userAgent) && !deviceIsWindowsPhone;
|
||||
|
||||
|
||||
/**
|
||||
* iOS 4 requires an exception for select elements.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsIOS4 = deviceIsIOS && (/OS 4_\d(_\d)?/).test(navigator.userAgent);
|
||||
|
||||
|
||||
/**
|
||||
* iOS 6.0-7.* requires the target element to be manually derived
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsIOSWithBadTarget = deviceIsIOS && (/OS [6-7]_\d/).test(navigator.userAgent);
|
||||
|
||||
/**
|
||||
* BlackBerry requires exceptions.
|
||||
*
|
||||
* @type boolean
|
||||
*/
|
||||
var deviceIsBlackBerry10 = navigator.userAgent.indexOf('BB10') > 0;
|
||||
|
||||
/**
|
||||
* Determine whether a given element requires a native click.
|
||||
*
|
||||
* @param {EventTarget|Element} target Target DOM element
|
||||
* @returns {boolean} Returns true if the element needs a native click
|
||||
*/
|
||||
FastClick.prototype.needsClick = function(target) {
|
||||
switch (target.nodeName.toLowerCase()) {
|
||||
|
||||
// Don't send a synthetic click to disabled inputs (issue #62)
|
||||
case 'button':
|
||||
case 'select':
|
||||
case 'textarea':
|
||||
if (target.disabled) {
|
||||
return true;
|
||||
}
|
||||
|
||||
break;
|
||||
case 'input':
|
||||
|
||||
// File inputs need real clicks on iOS 6 due to a browser bug (issue #68)
|
||||
if ((deviceIsIOS && target.type === 'file') || target.disabled) {
|
||||
return true;
|
||||
}
|
||||
|
||||
break;
|
||||
case 'label':
|
||||
case 'iframe': // iOS8 homescreen apps can prevent events bubbling into frames
|
||||
case 'video':
|
||||
return true;
|
||||
}
|
||||
|
||||
return (/\bneedsclick\b/).test(target.className);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Determine whether a given element requires a call to focus to simulate click into element.
|
||||
*
|
||||
* @param {EventTarget|Element} target Target DOM element
|
||||
* @returns {boolean} Returns true if the element requires a call to focus to simulate native click.
|
||||
*/
|
||||
FastClick.prototype.needsFocus = function(target) {
|
||||
switch (target.nodeName.toLowerCase()) {
|
||||
case 'textarea':
|
||||
return true;
|
||||
case 'select':
|
||||
return !deviceIsAndroid;
|
||||
case 'input':
|
||||
switch (target.type) {
|
||||
case 'button':
|
||||
case 'checkbox':
|
||||
case 'file':
|
||||
case 'image':
|
||||
case 'radio':
|
||||
case 'submit':
|
||||
return false;
|
||||
}
|
||||
|
||||
// No point in attempting to focus disabled inputs
|
||||
return !target.disabled && !target.readOnly;
|
||||
default:
|
||||
return (/\bneedsfocus\b/).test(target.className);
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Send a click event to the specified element.
|
||||
*
|
||||
* @param {EventTarget|Element} targetElement
|
||||
* @param {Event} event
|
||||
*/
|
||||
FastClick.prototype.sendClick = function(targetElement, event) {
|
||||
var clickEvent, touch;
|
||||
|
||||
// On some Android devices activeElement needs to be blurred otherwise the synthetic click will have no effect (#24)
|
||||
if (document.activeElement && document.activeElement !== targetElement) {
|
||||
document.activeElement.blur();
|
||||
}
|
||||
|
||||
touch = event.changedTouches[0];
|
||||
|
||||
// Synthesise a click event, with an extra attribute so it can be tracked
|
||||
clickEvent = document.createEvent('MouseEvents');
|
||||
clickEvent.initMouseEvent(this.determineEventType(targetElement), true, true, window, 1, touch.screenX, touch.screenY, touch.clientX, touch.clientY, false, false, false, false, 0, null);
|
||||
clickEvent.forwardedTouchEvent = true;
|
||||
targetElement.dispatchEvent(clickEvent);
|
||||
};
|
||||
|
||||
FastClick.prototype.determineEventType = function(targetElement) {
|
||||
|
||||
//Issue #159: Android Chrome Select Box does not open with a synthetic click event
|
||||
if (deviceIsAndroid && targetElement.tagName.toLowerCase() === 'select') {
|
||||
return 'mousedown';
|
||||
}
|
||||
|
||||
return 'click';
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {EventTarget|Element} targetElement
|
||||
*/
|
||||
FastClick.prototype.focus = function(targetElement) {
|
||||
var length;
|
||||
|
||||
// Issue #160: on iOS 7, some input elements (e.g. date datetime month) throw a vague TypeError on setSelectionRange. These elements don't have an integer value for the selectionStart and selectionEnd properties, but unfortunately that can't be used for detection because accessing the properties also throws a TypeError. Just check the type instead. Filed as Apple bug #15122724.
|
||||
if (deviceIsIOS && targetElement.setSelectionRange && targetElement.type.indexOf('date') !== 0 && targetElement.type !== 'time' && targetElement.type !== 'month') {
|
||||
length = targetElement.value.length;
|
||||
targetElement.setSelectionRange(length, length);
|
||||
} else {
|
||||
targetElement.focus();
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Check whether the given target element is a child of a scrollable layer and if so, set a flag on it.
|
||||
*
|
||||
* @param {EventTarget|Element} targetElement
|
||||
*/
|
||||
FastClick.prototype.updateScrollParent = function(targetElement) {
|
||||
var scrollParent, parentElement;
|
||||
|
||||
scrollParent = targetElement.fastClickScrollParent;
|
||||
|
||||
// Attempt to discover whether the target element is contained within a scrollable layer. Re-check if the
|
||||
// target element was moved to another parent.
|
||||
if (!scrollParent || !scrollParent.contains(targetElement)) {
|
||||
parentElement = targetElement;
|
||||
do {
|
||||
if (parentElement.scrollHeight > parentElement.offsetHeight) {
|
||||
scrollParent = parentElement;
|
||||
targetElement.fastClickScrollParent = parentElement;
|
||||
break;
|
||||
}
|
||||
|
||||
parentElement = parentElement.parentElement;
|
||||
} while (parentElement);
|
||||
}
|
||||
|
||||
// Always update the scroll top tracker if possible.
|
||||
if (scrollParent) {
|
||||
scrollParent.fastClickLastScrollTop = scrollParent.scrollTop;
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {EventTarget} targetElement
|
||||
* @returns {Element|EventTarget}
|
||||
*/
|
||||
FastClick.prototype.getTargetElementFromEventTarget = function(eventTarget) {
|
||||
|
||||
// On some older browsers (notably Safari on iOS 4.1 - see issue #56) the event target may be a text node.
|
||||
if (eventTarget.nodeType === Node.TEXT_NODE) {
|
||||
return eventTarget.parentNode;
|
||||
}
|
||||
|
||||
return eventTarget;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* On touch start, record the position and scroll offset.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.onTouchStart = function(event) {
|
||||
var targetElement, touch, selection;
|
||||
|
||||
// Ignore multiple touches, otherwise pinch-to-zoom is prevented if both fingers are on the FastClick element (issue #111).
|
||||
if (event.targetTouches.length > 1) {
|
||||
return true;
|
||||
}
|
||||
|
||||
targetElement = this.getTargetElementFromEventTarget(event.target);
|
||||
touch = event.targetTouches[0];
|
||||
|
||||
if (deviceIsIOS) {
|
||||
|
||||
// Only trusted events will deselect text on iOS (issue #49)
|
||||
selection = window.getSelection();
|
||||
if (selection.rangeCount && !selection.isCollapsed) {
|
||||
return true;
|
||||
}
|
||||
|
||||
if (!deviceIsIOS4) {
|
||||
|
||||
// Weird things happen on iOS when an alert or confirm dialog is opened from a click event callback (issue #23):
|
||||
// when the user next taps anywhere else on the page, new touchstart and touchend events are dispatched
|
||||
// with the same identifier as the touch event that previously triggered the click that triggered the alert.
|
||||
// Sadly, there is an issue on iOS 4 that causes some normal touch events to have the same identifier as an
|
||||
// immediately preceding touch event (issue #52), so this fix is unavailable on that platform.
|
||||
// Issue 120: touch.identifier is 0 when Chrome dev tools 'Emulate touch events' is set with an iOS device UA string,
|
||||
// which causes all touch events to be ignored. As this block only applies to iOS, and iOS identifiers are always long,
|
||||
// random integers, it's safe to to continue if the identifier is 0 here.
|
||||
if (touch.identifier && touch.identifier === this.lastTouchIdentifier) {
|
||||
event.preventDefault();
|
||||
return false;
|
||||
}
|
||||
|
||||
this.lastTouchIdentifier = touch.identifier;
|
||||
|
||||
// If the target element is a child of a scrollable layer (using -webkit-overflow-scrolling: touch) and:
|
||||
// 1) the user does a fling scroll on the scrollable layer
|
||||
// 2) the user stops the fling scroll with another tap
|
||||
// then the event.target of the last 'touchend' event will be the element that was under the user's finger
|
||||
// when the fling scroll was started, causing FastClick to send a click event to that layer - unless a check
|
||||
// is made to ensure that a parent layer was not scrolled before sending a synthetic click (issue #42).
|
||||
this.updateScrollParent(targetElement);
|
||||
}
|
||||
}
|
||||
|
||||
this.trackingClick = true;
|
||||
this.trackingClickStart = event.timeStamp;
|
||||
this.targetElement = targetElement;
|
||||
|
||||
this.touchStartX = touch.pageX;
|
||||
this.touchStartY = touch.pageY;
|
||||
|
||||
// Prevent phantom clicks on fast double-tap (issue #36)
|
||||
if ((event.timeStamp - this.lastClickTime) < this.tapDelay) {
|
||||
event.preventDefault();
|
||||
}
|
||||
|
||||
return true;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Based on a touchmove event object, check whether the touch has moved past a boundary since it started.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.touchHasMoved = function(event) {
|
||||
var touch = event.changedTouches[0], boundary = this.touchBoundary;
|
||||
|
||||
if (Math.abs(touch.pageX - this.touchStartX) > boundary || Math.abs(touch.pageY - this.touchStartY) > boundary) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return false;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Update the last position.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.onTouchMove = function(event) {
|
||||
if (!this.trackingClick) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// If the touch has moved, cancel the click tracking
|
||||
if (this.targetElement !== this.getTargetElementFromEventTarget(event.target) || this.touchHasMoved(event)) {
|
||||
this.trackingClick = false;
|
||||
this.targetElement = null;
|
||||
}
|
||||
|
||||
return true;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Attempt to find the labelled control for the given label element.
|
||||
*
|
||||
* @param {EventTarget|HTMLLabelElement} labelElement
|
||||
* @returns {Element|null}
|
||||
*/
|
||||
FastClick.prototype.findControl = function(labelElement) {
|
||||
|
||||
// Fast path for newer browsers supporting the HTML5 control attribute
|
||||
if (labelElement.control !== undefined) {
|
||||
return labelElement.control;
|
||||
}
|
||||
|
||||
// All browsers under test that support touch events also support the HTML5 htmlFor attribute
|
||||
if (labelElement.htmlFor) {
|
||||
return document.getElementById(labelElement.htmlFor);
|
||||
}
|
||||
|
||||
// If no for attribute exists, attempt to retrieve the first labellable descendant element
|
||||
// the list of which is defined here: http://www.w3.org/TR/html5/forms.html#category-label
|
||||
return labelElement.querySelector('button, input:not([type=hidden]), keygen, meter, output, progress, select, textarea');
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* On touch end, determine whether to send a click event at once.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.onTouchEnd = function(event) {
|
||||
var forElement, trackingClickStart, targetTagName, scrollParent, touch, targetElement = this.targetElement;
|
||||
|
||||
if (!this.trackingClick) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Prevent phantom clicks on fast double-tap (issue #36)
|
||||
if ((event.timeStamp - this.lastClickTime) < this.tapDelay) {
|
||||
this.cancelNextClick = true;
|
||||
return true;
|
||||
}
|
||||
|
||||
if ((event.timeStamp - this.trackingClickStart) > this.tapTimeout) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Reset to prevent wrong click cancel on input (issue #156).
|
||||
this.cancelNextClick = false;
|
||||
|
||||
this.lastClickTime = event.timeStamp;
|
||||
|
||||
trackingClickStart = this.trackingClickStart;
|
||||
this.trackingClick = false;
|
||||
this.trackingClickStart = 0;
|
||||
|
||||
// On some iOS devices, the targetElement supplied with the event is invalid if the layer
|
||||
// is performing a transition or scroll, and has to be re-detected manually. Note that
|
||||
// for this to function correctly, it must be called *after* the event target is checked!
|
||||
// See issue #57; also filed as rdar://13048589 .
|
||||
if (deviceIsIOSWithBadTarget) {
|
||||
touch = event.changedTouches[0];
|
||||
|
||||
// In certain cases arguments of elementFromPoint can be negative, so prevent setting targetElement to null
|
||||
targetElement = document.elementFromPoint(touch.pageX - window.pageXOffset, touch.pageY - window.pageYOffset) || targetElement;
|
||||
targetElement.fastClickScrollParent = this.targetElement.fastClickScrollParent;
|
||||
}
|
||||
|
||||
targetTagName = targetElement.tagName.toLowerCase();
|
||||
if (targetTagName === 'label') {
|
||||
forElement = this.findControl(targetElement);
|
||||
if (forElement) {
|
||||
this.focus(targetElement);
|
||||
if (deviceIsAndroid) {
|
||||
return false;
|
||||
}
|
||||
|
||||
targetElement = forElement;
|
||||
}
|
||||
} else if (this.needsFocus(targetElement)) {
|
||||
|
||||
// Case 1: If the touch started a while ago (best guess is 100ms based on tests for issue #36) then focus will be triggered anyway. Return early and unset the target element reference so that the subsequent click will be allowed through.
|
||||
// Case 2: Without this exception for input elements tapped when the document is contained in an iframe, then any inputted text won't be visible even though the value attribute is updated as the user types (issue #37).
|
||||
if ((event.timeStamp - trackingClickStart) > 100 || (deviceIsIOS && window.top !== window && targetTagName === 'input')) {
|
||||
this.targetElement = null;
|
||||
return false;
|
||||
}
|
||||
|
||||
this.focus(targetElement);
|
||||
this.sendClick(targetElement, event);
|
||||
|
||||
// Select elements need the event to go through on iOS 4, otherwise the selector menu won't open.
|
||||
// Also this breaks opening selects when VoiceOver is active on iOS6, iOS7 (and possibly others)
|
||||
if (!deviceIsIOS || targetTagName !== 'select') {
|
||||
this.targetElement = null;
|
||||
event.preventDefault();
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
if (deviceIsIOS && !deviceIsIOS4) {
|
||||
|
||||
// Don't send a synthetic click event if the target element is contained within a parent layer that was scrolled
|
||||
// and this tap is being used to stop the scrolling (usually initiated by a fling - issue #42).
|
||||
scrollParent = targetElement.fastClickScrollParent;
|
||||
if (scrollParent && scrollParent.fastClickLastScrollTop !== scrollParent.scrollTop) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
// Prevent the actual click from going though - unless the target node is marked as requiring
|
||||
// real clicks or if it is in the whitelist in which case only non-programmatic clicks are permitted.
|
||||
if (!this.needsClick(targetElement)) {
|
||||
event.preventDefault();
|
||||
this.sendClick(targetElement, event);
|
||||
}
|
||||
|
||||
return false;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* On touch cancel, stop tracking the click.
|
||||
*
|
||||
* @returns {void}
|
||||
*/
|
||||
FastClick.prototype.onTouchCancel = function() {
|
||||
this.trackingClick = false;
|
||||
this.targetElement = null;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Determine mouse events which should be permitted.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.onMouse = function(event) {
|
||||
|
||||
// If a target element was never set (because a touch event was never fired) allow the event
|
||||
if (!this.targetElement) {
|
||||
return true;
|
||||
}
|
||||
|
||||
if (event.forwardedTouchEvent) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Programmatically generated events targeting a specific element should be permitted
|
||||
if (!event.cancelable) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Derive and check the target element to see whether the mouse event needs to be permitted;
|
||||
// unless explicitly enabled, prevent non-touch click events from triggering actions,
|
||||
// to prevent ghost/doubleclicks.
|
||||
if (!this.needsClick(this.targetElement) || this.cancelNextClick) {
|
||||
|
||||
// Prevent any user-added listeners declared on FastClick element from being fired.
|
||||
if (event.stopImmediatePropagation) {
|
||||
event.stopImmediatePropagation();
|
||||
} else {
|
||||
|
||||
// Part of the hack for browsers that don't support Event#stopImmediatePropagation (e.g. Android 2)
|
||||
event.propagationStopped = true;
|
||||
}
|
||||
|
||||
// Cancel the event
|
||||
event.stopPropagation();
|
||||
event.preventDefault();
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
// If the mouse event is permitted, return true for the action to go through.
|
||||
return true;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* On actual clicks, determine whether this is a touch-generated click, a click action occurring
|
||||
* naturally after a delay after a touch (which needs to be cancelled to avoid duplication), or
|
||||
* an actual click which should be permitted.
|
||||
*
|
||||
* @param {Event} event
|
||||
* @returns {boolean}
|
||||
*/
|
||||
FastClick.prototype.onClick = function(event) {
|
||||
var permitted;
|
||||
|
||||
// It's possible for another FastClick-like library delivered with third-party code to fire a click event before FastClick does (issue #44). In that case, set the click-tracking flag back to false and return early. This will cause onTouchEnd to return early.
|
||||
if (this.trackingClick) {
|
||||
this.targetElement = null;
|
||||
this.trackingClick = false;
|
||||
return true;
|
||||
}
|
||||
|
||||
// Very odd behaviour on iOS (issue #18): if a submit element is present inside a form and the user hits enter in the iOS simulator or clicks the Go button on the pop-up OS keyboard the a kind of 'fake' click event will be triggered with the submit-type input element as the target.
|
||||
if (event.target.type === 'submit' && event.detail === 0) {
|
||||
return true;
|
||||
}
|
||||
|
||||
permitted = this.onMouse(event);
|
||||
|
||||
// Only unset targetElement if the click is not permitted. This will ensure that the check for !targetElement in onMouse fails and the browser's click doesn't go through.
|
||||
if (!permitted) {
|
||||
this.targetElement = null;
|
||||
}
|
||||
|
||||
// If clicks are permitted, return true for the action to go through.
|
||||
return permitted;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Remove all FastClick's event listeners.
|
||||
*
|
||||
* @returns {void}
|
||||
*/
|
||||
FastClick.prototype.destroy = function() {
|
||||
var layer = this.layer;
|
||||
|
||||
if (deviceIsAndroid) {
|
||||
layer.removeEventListener('mouseover', this.onMouse, true);
|
||||
layer.removeEventListener('mousedown', this.onMouse, true);
|
||||
layer.removeEventListener('mouseup', this.onMouse, true);
|
||||
}
|
||||
|
||||
layer.removeEventListener('click', this.onClick, true);
|
||||
layer.removeEventListener('touchstart', this.onTouchStart, false);
|
||||
layer.removeEventListener('touchmove', this.onTouchMove, false);
|
||||
layer.removeEventListener('touchend', this.onTouchEnd, false);
|
||||
layer.removeEventListener('touchcancel', this.onTouchCancel, false);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Check whether FastClick is needed.
|
||||
*
|
||||
* @param {Element} layer The layer to listen on
|
||||
*/
|
||||
FastClick.notNeeded = function(layer) {
|
||||
var metaViewport;
|
||||
var chromeVersion;
|
||||
var blackberryVersion;
|
||||
var firefoxVersion;
|
||||
|
||||
// Devices that don't support touch don't need FastClick
|
||||
if (typeof window.ontouchstart === 'undefined') {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Chrome version - zero for other browsers
|
||||
chromeVersion = +(/Chrome\/([0-9]+)/.exec(navigator.userAgent) || [,0])[1];
|
||||
|
||||
if (chromeVersion) {
|
||||
|
||||
if (deviceIsAndroid) {
|
||||
metaViewport = document.querySelector('meta[name=viewport]');
|
||||
|
||||
if (metaViewport) {
|
||||
// Chrome on Android with user-scalable="no" doesn't need FastClick (issue #89)
|
||||
if (metaViewport.content.indexOf('user-scalable=no') !== -1) {
|
||||
return true;
|
||||
}
|
||||
// Chrome 32 and above with width=device-width or less don't need FastClick
|
||||
if (chromeVersion > 31 && document.documentElement.scrollWidth <= window.outerWidth) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
// Chrome desktop doesn't need FastClick (issue #15)
|
||||
} else {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
if (deviceIsBlackBerry10) {
|
||||
blackberryVersion = navigator.userAgent.match(/Version\/([0-9]*)\.([0-9]*)/);
|
||||
|
||||
// BlackBerry 10.3+ does not require Fastclick library.
|
||||
// https://github.com/ftlabs/fastclick/issues/251
|
||||
if (blackberryVersion[1] >= 10 && blackberryVersion[2] >= 3) {
|
||||
metaViewport = document.querySelector('meta[name=viewport]');
|
||||
|
||||
if (metaViewport) {
|
||||
// user-scalable=no eliminates click delay.
|
||||
if (metaViewport.content.indexOf('user-scalable=no') !== -1) {
|
||||
return true;
|
||||
}
|
||||
// width=device-width (or less than device-width) eliminates click delay.
|
||||
if (document.documentElement.scrollWidth <= window.outerWidth) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// IE10 with -ms-touch-action: none or manipulation, which disables double-tap-to-zoom (issue #97)
|
||||
if (layer.style.msTouchAction === 'none' || layer.style.touchAction === 'manipulation') {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Firefox version - zero for other browsers
|
||||
firefoxVersion = +(/Firefox\/([0-9]+)/.exec(navigator.userAgent) || [,0])[1];
|
||||
|
||||
if (firefoxVersion >= 27) {
|
||||
// Firefox 27+ does not have tap delay if the content is not zoomable - https://bugzilla.mozilla.org/show_bug.cgi?id=922896
|
||||
|
||||
metaViewport = document.querySelector('meta[name=viewport]');
|
||||
if (metaViewport && (metaViewport.content.indexOf('user-scalable=no') !== -1 || document.documentElement.scrollWidth <= window.outerWidth)) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
// IE11: prefixed -ms-touch-action is no longer supported and it's recommended to use non-prefixed version
|
||||
// http://msdn.microsoft.com/en-us/library/windows/apps/Hh767313.aspx
|
||||
if (layer.style.touchAction === 'none' || layer.style.touchAction === 'manipulation') {
|
||||
return true;
|
||||
}
|
||||
|
||||
return false;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Factory method for creating a FastClick object
|
||||
*
|
||||
* @param {Element} layer The layer to listen on
|
||||
* @param {Object} [options={}] The options to override the defaults
|
||||
*/
|
||||
FastClick.attach = function(layer, options) {
|
||||
return new FastClick(layer, options);
|
||||
};
|
||||
|
||||
|
||||
if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) {
|
||||
|
||||
// AMD. Register as an anonymous module.
|
||||
define(function() {
|
||||
return FastClick;
|
||||
});
|
||||
} else if (typeof module !== 'undefined' && module.exports) {
|
||||
module.exports = FastClick.attach;
|
||||
module.exports.FastClick = FastClick;
|
||||
} else {
|
||||
window.FastClick = FastClick;
|
||||
}
|
||||
}());
|
||||
File diff suppressed because one or more lines are too long
@ -0,0 +1,5 @@
|
||||
._gnu_make {
|
||||
dl dt {
|
||||
@extend %block-label, %label-blue;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,4 @@
|
||||
._jasmine {
|
||||
.subsection-title, h2 { @extend %block-heading; }
|
||||
h4 { @extend %block-label, %label-blue; }
|
||||
}
|
||||
@ -0,0 +1,4 @@
|
||||
._kubectl {
|
||||
@extend %simple;
|
||||
|
||||
}
|
||||
@ -0,0 +1,4 @@
|
||||
._kubernetes {
|
||||
@extend %simple;
|
||||
|
||||
}
|
||||
@ -1,4 +1,43 @@
|
||||
._scala {
|
||||
@extend %simple;
|
||||
|
||||
.deprecated { @extend %label-red; }
|
||||
|
||||
.attributes dl,
|
||||
.attributes pre {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.related-types {
|
||||
@extend %pre;
|
||||
margin: 0;
|
||||
white-space: normal;
|
||||
}
|
||||
|
||||
.links {
|
||||
@extend %box;
|
||||
margin-left: -1rem;
|
||||
text-align: center;
|
||||
padding: .5em;
|
||||
|
||||
a { padding: .4em }
|
||||
|
||||
@include print {
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
|
||||
.source-link {
|
||||
float: right;
|
||||
font-size: .75rem;
|
||||
color: var(--linkColor);
|
||||
cursor: pointer;
|
||||
@extend %user-select-none;
|
||||
|
||||
&:hover { text-decoration: underline; }
|
||||
|
||||
@include print {
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@ -0,0 +1,48 @@
|
||||
._tailwindcss {
|
||||
// Styling for customizing-colors page - color swatches (based on original tailwind display design)
|
||||
.colors {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 1.2rem;
|
||||
|
||||
// Text offset
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
// Color swatch title
|
||||
.color > div:first-child {
|
||||
font-weight: bold;
|
||||
}
|
||||
|
||||
.color-swatch-group {
|
||||
display: flex;
|
||||
gap: 1rem;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.color-swatch-container {
|
||||
display: inline-block;
|
||||
}
|
||||
|
||||
// Tiny box with the color set as background
|
||||
.color-swatch {
|
||||
width: 120px;
|
||||
height: 40px;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
.color-tone-information {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
}
|
||||
|
||||
// Styling for large quick-reference lookup tables
|
||||
.long-quick-reference {
|
||||
max-height: 40vh;
|
||||
width: fit-content;
|
||||
overflow-y: auto;
|
||||
padding: .3rem;
|
||||
border-top: 1px solid var(--textColor);
|
||||
border-bottom: 1px solid var(--textColor);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,22 @@
|
||||
module Docs
|
||||
class Deno
|
||||
class CleanHtmlFilter < Filter
|
||||
def call
|
||||
if root_page?
|
||||
@doc = at_css('h2[id]').parent.parent
|
||||
else
|
||||
@doc = at_css('article')
|
||||
end
|
||||
|
||||
css('*[aria-label="Anchor"]').remove
|
||||
css('*[class]').remove_attribute('class')
|
||||
css('pre').each do |node|
|
||||
node['data-language'] = 'typescript'
|
||||
end
|
||||
xpath('//a[text()="[src]"]').remove
|
||||
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,15 @@
|
||||
module Docs
|
||||
class Deno
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
|
||||
def get_name
|
||||
at_css('h1').content
|
||||
end
|
||||
|
||||
def get_type
|
||||
'Deno CLI APIs'
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,37 +0,0 @@
|
||||
module Docs
|
||||
class Docker
|
||||
class CleanHtmlOldFilter < Filter
|
||||
def call
|
||||
if root_page?
|
||||
doc.inner_html = "<h1>Docker Documentation</h1>"
|
||||
return doc
|
||||
end
|
||||
|
||||
@doc = at_css('#DocumentationText')
|
||||
|
||||
at_css('h2').name = 'h1' unless at_css('h1')
|
||||
|
||||
css('.anchorLink', '.reading-time', 'hr', '> div[style*="margin-top"]:last-child').remove
|
||||
|
||||
css('h1 + h1').each do |node|
|
||||
node.name = 'h2'
|
||||
end
|
||||
|
||||
css('pre').each do |node|
|
||||
node.content = node.content
|
||||
node['data-language'] = node.parent['class'][/language-(\w+)/, 1] if node.parent['class']
|
||||
end
|
||||
|
||||
css('div.highlighter-rouge').each do |node|
|
||||
node.before(node.children).remove
|
||||
end
|
||||
|
||||
css('code.highlighter-rouge').each do |node|
|
||||
node.content = node.content.gsub(/\s+/, ' ').strip
|
||||
end
|
||||
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,22 +0,0 @@
|
||||
module Docs
|
||||
class Docker
|
||||
class CleanHtmlVeryOldFilter < Filter
|
||||
def call
|
||||
if root_page?
|
||||
doc.inner_html = "<h1>Docker Documentation</h1>"
|
||||
return doc
|
||||
end
|
||||
|
||||
@doc = at_css('#content')
|
||||
|
||||
at_css('h2').name = 'h1' unless at_css('h1')
|
||||
|
||||
css('pre').each do |node|
|
||||
node.content = node.content
|
||||
end
|
||||
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,75 +0,0 @@
|
||||
module Docs
|
||||
class Docker
|
||||
class EntriesOldFilter < Docs::EntriesFilter
|
||||
NAME_BY_SUBPATH = {
|
||||
'engine/' => 'Engine',
|
||||
'compose/' => 'Compose',
|
||||
'machine/' => 'Machine'
|
||||
}
|
||||
|
||||
def get_name
|
||||
return NAME_BY_SUBPATH[subpath] if NAME_BY_SUBPATH[subpath]
|
||||
return at_css('h1').content unless nav_link
|
||||
|
||||
name = nav_link.content.strip
|
||||
name.capitalize! if name == 'exoscale'
|
||||
name.remove! ' (base command)'
|
||||
|
||||
if name =~ /\A[a-z\-\s]+\z/
|
||||
name.prepend 'docker-compose ' if subpath =~ /compose\/reference\/./
|
||||
name.prepend 'docker-machine ' if subpath =~ /machine\/reference\/./
|
||||
else
|
||||
name << " (#{product})" if name !~ /#{product}/i
|
||||
end
|
||||
|
||||
name
|
||||
end
|
||||
|
||||
TYPE_BY_SUBPATH = {
|
||||
'engine/' => 'Engine',
|
||||
'compose/' => 'Compose',
|
||||
'machine/' => 'Machine'
|
||||
}
|
||||
|
||||
def get_type
|
||||
return TYPE_BY_SUBPATH[subpath] if TYPE_BY_SUBPATH[subpath]
|
||||
return 'Engine: CLI' if subpath.start_with?('engine/reference/commandline/')
|
||||
return 'Engine: Admin Guide' if subpath.start_with?('engine/admin/')
|
||||
return 'Engine: Security' if subpath.start_with?('engine/security/')
|
||||
return 'Engine: Extend' if subpath.start_with?('engine/extend/')
|
||||
return 'Engine: Get Started' if subpath.start_with?('engine/getstarted')
|
||||
return 'Engine: Tutorials' if subpath.start_with?('engine/tutorials/')
|
||||
return product if !nav_link && subpath =~ /\A\w+\/[\w\-]+\/\z/
|
||||
|
||||
leaves = nav_link.ancestors('li.leaf').reverse
|
||||
return product if leaves.length <= 2
|
||||
|
||||
type = leaves[0..1].map { |node| node.at_css('> a').content.strip }.join(': ')
|
||||
type.remove! %r{\ADocker }
|
||||
type.remove! ' Engine'
|
||||
type.sub! %r{Command[\-\s]line reference}i, 'CLI'
|
||||
type.sub! 'CLI reference', 'CLI'
|
||||
type
|
||||
end
|
||||
|
||||
def nav_link
|
||||
return @nav_link if defined?(@nav_link)
|
||||
@nav_link = at_css('.currentPage')
|
||||
|
||||
unless @nav_link
|
||||
link = at_css('#DocumentationText li a')
|
||||
return unless link
|
||||
link = at_css(".docsidebarnav_section a[href='#{link['href']}']")
|
||||
return unless link
|
||||
@nav_link = link.ancestors('.menu-closed').first.at_css('a')
|
||||
end
|
||||
|
||||
@nav_link
|
||||
end
|
||||
|
||||
def product
|
||||
@product ||= subpath.split('/').first.capitalize
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -1,56 +0,0 @@
|
||||
module Docs
|
||||
class Docker
|
||||
class EntriesVeryOldFilter < Docs::EntriesFilter
|
||||
def get_name
|
||||
name = nav_link ? nav_link.content.strip : at_css('#content h1').content.strip
|
||||
name.capitalize! if name == 'exoscale'
|
||||
|
||||
if name =~ /\A[a-z\-\s]+\z/
|
||||
name.prepend 'docker ' if subpath =~ /engine\/reference\/commandline\/./
|
||||
name.prepend 'docker-compose ' if subpath =~ /compose\/reference\/./
|
||||
name.prepend 'docker-machine ' if subpath =~ /machine\/reference\/./
|
||||
name.prepend 'swarm ' if subpath =~ /swarm\/reference\/./ && name != 'swarm'
|
||||
else
|
||||
name << " (#{product})" if name !~ /#{product}/i
|
||||
end
|
||||
|
||||
name
|
||||
end
|
||||
|
||||
def get_type
|
||||
unless nav_link
|
||||
return 'Engine: User guide' if subpath.start_with?('engine/userguide')
|
||||
end
|
||||
|
||||
type = nav_link.ancestors('article').to_a.reverse.to_a[0..1].map do |node|
|
||||
node.at_css('> button').content.strip
|
||||
end.join(': ')
|
||||
|
||||
type.remove! %r{\ADocker }
|
||||
type.remove! %r{ Engine}
|
||||
type.sub! %r{Command[\-\s]line reference}i, 'CLI'
|
||||
type = 'Engine: Reference' if type == 'Engine: reference'
|
||||
type
|
||||
end
|
||||
|
||||
def nav_link
|
||||
return @nav_link if defined?(@nav_link)
|
||||
@nav_link = at_css('#multiple .active')
|
||||
|
||||
unless @nav_link
|
||||
link = at_css('#content li a')
|
||||
return unless link
|
||||
link = at_css("#multiple a[href='#{link['href']}']")
|
||||
return unless link
|
||||
@nav_link = link.ancestors('article').first.at_css('button')
|
||||
end
|
||||
|
||||
@nav_link
|
||||
end
|
||||
|
||||
def product
|
||||
@product ||= subpath.split('/').first.capitalize
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,25 @@
|
||||
module Docs
|
||||
class Eigen3
|
||||
class CleanHtmlFilter < Filter
|
||||
|
||||
def call
|
||||
@doc = at_css('#doc-content')
|
||||
css('#MSearchSelectWindow').remove
|
||||
css('#MSearchResultsWindow').remove
|
||||
css('.directory .levels').remove
|
||||
css('.header .summary').remove
|
||||
css('.ttc').remove
|
||||
css('.top').remove
|
||||
css('.dynheader.closed').remove
|
||||
css('.permalink').remove
|
||||
css('.groupheader').remove
|
||||
css('.header').remove
|
||||
css('#details').remove
|
||||
css('*').each do |node|
|
||||
node.remove_attribute('class')
|
||||
end
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,123 @@
|
||||
module Docs
|
||||
class Eigen3
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
def get_type
|
||||
group = at_css('.title .ingroups')
|
||||
content = at_css('.contents').content
|
||||
title = get_title()
|
||||
downtitle = title.downcase
|
||||
name = get_name
|
||||
|
||||
if slug.include?('unsupported')
|
||||
return 'Unsupported'
|
||||
elsif slug.start_with?('Topic') || downtitle.end_with?("topics")
|
||||
return 'Topics'
|
||||
elsif downtitle.end_with?("class template reference") || downtitle.end_with?("class reference")
|
||||
return 'Classes'
|
||||
elsif downtitle.end_with?("struct reference")
|
||||
return 'Structs'
|
||||
elsif downtitle.end_with?("typedefs")
|
||||
return 'Typedefs'
|
||||
elsif downtitle.end_with?("namespace reference")
|
||||
return 'Namespaces'
|
||||
elsif not group.nil? and group.content.include?('Reference') and (downtitle.end_with?("module") || downtitle.end_with?("modules"))
|
||||
return "Modules"
|
||||
elsif not group.nil?
|
||||
if group.children.length > 0
|
||||
return 'Chapter: ' + group.children[-1].content
|
||||
else
|
||||
return 'Chapter: ' + group.content
|
||||
end
|
||||
else
|
||||
return 'Eigen'
|
||||
end
|
||||
end
|
||||
|
||||
def get_name
|
||||
title = get_title().gsub(/[<(].*/, '').gsub(/(Class|Class Template|Namespace|Struct) Reference/, '').strip
|
||||
end
|
||||
|
||||
def get_title
|
||||
unless at_css('.title').nil?
|
||||
group = at_css('.title .ingroups')
|
||||
title = at_css('.title').content
|
||||
if not group.nil?
|
||||
title = title.delete_suffix(group.content)
|
||||
end
|
||||
return title.strip
|
||||
else
|
||||
return slug
|
||||
end
|
||||
end
|
||||
|
||||
|
||||
def additional_entries
|
||||
# return [] if slug.include?('unsupported')
|
||||
name = get_name()
|
||||
entries = []
|
||||
|
||||
css('table.memberdecls').map do |table|
|
||||
doxygen_type = table.at_css("tr.heading").text.strip
|
||||
case doxygen_type
|
||||
when "Functions"
|
||||
type = "Functions"
|
||||
when "Public Member Functions", "Static Public Member Functions", "Public Types", "Additional Inherited Members"
|
||||
type = nil
|
||||
when "Classes"
|
||||
type = "Classes"
|
||||
when "Typedefs"
|
||||
type = "Typedefs"
|
||||
when "Variables"
|
||||
type = "Variables"
|
||||
else
|
||||
next
|
||||
end
|
||||
|
||||
tmp_entries = []
|
||||
|
||||
table.css('td.memItemRight,td.memTemplItemRight').map do |node_r|
|
||||
node_l = node_r.parent.at_css('memItemLeft')
|
||||
if (not node_l.nil? and node_l.text.strip == 'enum') || node_r.content.include?('{')
|
||||
node_r.css("a").each {|n| tmp_entries << [n.content, n.attr('href')]}
|
||||
else
|
||||
n = node_r.at_css("a")
|
||||
next if n.nil?
|
||||
tmp_entries << [node_r.content, n.attr('href')]
|
||||
end
|
||||
end
|
||||
|
||||
tmp_entries.each do |args|
|
||||
(content, href) = args
|
||||
next if href.nil?
|
||||
if not href.include?("#") and (name == 'Eigen' || type == "Classes") then
|
||||
next
|
||||
end
|
||||
|
||||
if slug.include?('unsupported')
|
||||
if not (href.include?('unsupported') || href.include?('#'))
|
||||
next
|
||||
elsif href.include?('#') and not href.include?('unsupported')
|
||||
href = 'unsupported/' + href
|
||||
end
|
||||
end
|
||||
|
||||
if doxygen_type == "Typedefs"
|
||||
content = content.sub(/\s*=.*$/, "")
|
||||
end
|
||||
|
||||
if not (name.end_with?('module') || name.end_with?('typedefs')) \
|
||||
and not content.start_with?("Eigen::")
|
||||
content = name + "::" + content
|
||||
end
|
||||
content.gsub! /^\s+/, ''
|
||||
content.gsub! /\s+,\s+/, ', '
|
||||
content.gsub! /\s\s+/, ' '
|
||||
entries << [content, href, type]
|
||||
end
|
||||
|
||||
end
|
||||
entries
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,19 @@
|
||||
module Docs
|
||||
class Esbuild
|
||||
class CleanHtmlFilter < Filter
|
||||
def call
|
||||
css('figure.bench').remove
|
||||
css('.permalink').remove
|
||||
css('.switcher').remove
|
||||
css('pre').each do |node|
|
||||
node.content = node.content
|
||||
node['data-language'] = 'javascript'
|
||||
node['data-language'] = 'sh' if node['class'] && node['class'].include?('cli')
|
||||
node['data-language'] = 'go' if node['class'] && node['class'].include?('go')
|
||||
node['class'] = nil
|
||||
end
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,21 @@
|
||||
module Docs
|
||||
class Esbuild
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
def name
|
||||
at_css('h1').content
|
||||
end
|
||||
def type
|
||||
at_css('h1').content
|
||||
end
|
||||
|
||||
def additional_entries
|
||||
entries = []
|
||||
type = at_css('h1').content
|
||||
css('h2[id], h3[id]').each do |node|
|
||||
entries << [node.content.gsub(/^#/, ''), node['id'], type]
|
||||
end
|
||||
entries
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,54 @@
|
||||
module Docs
|
||||
class GnuMake
|
||||
class CleanHtmlFilter < Filter
|
||||
def call
|
||||
|
||||
if current_url == root_url
|
||||
# Remove short table contents
|
||||
css('.shortcontents').remove
|
||||
css('.shortcontents-heading').remove
|
||||
css('.contents-heading').remove
|
||||
css('.contents').remove
|
||||
css('.settitle').remove
|
||||
|
||||
# remove copyright
|
||||
css('blockquote').remove
|
||||
end
|
||||
|
||||
css('hr').remove
|
||||
|
||||
css('.header').remove
|
||||
|
||||
# Remove undesirable in headers
|
||||
css('.chapter', '.section', '.subsection', '.subsubsection', '.appendix').each do |node|
|
||||
|
||||
node.content = node.content.slice(/[[:alpha:]]...*/)
|
||||
|
||||
node.content = node.content.sub(/Appendix.{2}/, '') if node.content.include?('Appendix')
|
||||
|
||||
if node.content.match?(/[[:upper:]]\./)
|
||||
node.content = node.content.sub(/[[:upper:]]\./, '')
|
||||
node.content = node.content.gsub(/\./, '')
|
||||
node.content = node.content.gsub(/[[:digit:]]/, '')
|
||||
end
|
||||
|
||||
node.name = "h1"
|
||||
end
|
||||
|
||||
css('dt code').each do |node|
|
||||
node.parent['id'] = node.content
|
||||
end
|
||||
|
||||
css('dt > samp').each do |node|
|
||||
node.parent['id'] = node.content
|
||||
end
|
||||
|
||||
css('br').remove
|
||||
|
||||
css('.footnote').remove
|
||||
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,97 @@
|
||||
module Docs
|
||||
class GnuMake
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
|
||||
NO_ADDITIONAL_ENTRIES = [
|
||||
'Quick Reference', 'Instead of Executing Recipes',
|
||||
'Loaded Object Interface', 'Conversion of Guile Types',
|
||||
'Arguments to Specify the Goals', 'Standard Targets for Users',
|
||||
'Variables for Installation Directories', 'Errors Generated by Make',
|
||||
'The origin Function', 'The vpath Directive',
|
||||
'Interfaces from Guile to make', 'Output During Parallel Execution',
|
||||
'How to Run make', 'The flavor Function', 'Catalogue of Built-In Rules'
|
||||
]
|
||||
|
||||
DL_DT_TABLE = {
|
||||
'Automatic Variables' => 'Automatic Variables',
|
||||
'Other Special Variables' => 'Automatic Variables',
|
||||
'Variables Used by Implicit Rules' => 'Automatic Variables',
|
||||
'Special Built-in Target Names' => 'Built-in targets',
|
||||
'Functions for File Names' => 'File Names Functions',
|
||||
'Functions for String Substitution and Analysis' => 'String Substitution and Analysis Functions',
|
||||
'Functions for Conditionals' => 'Conditionals Functions',
|
||||
'Functions That Control Make' => 'Make Control Functions',
|
||||
'Syntax of Conditionals' => 'Conditionals Syntax'
|
||||
}
|
||||
|
||||
def get_name
|
||||
name = at_css('.chapter', '.section', '.subsection', '.subsubsection', '.appendix')
|
||||
|
||||
if name.nil?
|
||||
name = at_css('h1, h2, h3').content.slice(/[[:alpha:]]...*/)
|
||||
else
|
||||
name = name.content.slice(/[[:alpha:]]...*/)
|
||||
end
|
||||
|
||||
name.gsub!(/Appendix.{2}/, '') if name.include?('Appendix')
|
||||
# remove withespace at the beginning left when "Appendix" is removed
|
||||
name.gsub!(/\G\s/, '')
|
||||
|
||||
name
|
||||
end
|
||||
|
||||
def get_type
|
||||
return 'Transforming text functions' if name =~ /The [a-z]+ Function/
|
||||
return 'Directives' if name =~ /The [a-z]+ Directive/
|
||||
'Manual'
|
||||
end
|
||||
|
||||
def additional_entries
|
||||
entries = []
|
||||
|
||||
return entries if NO_ADDITIONAL_ENTRIES.include?(name)
|
||||
|
||||
css('dl dt').each do |node|
|
||||
|
||||
break if name == 'Summary of Options'
|
||||
|
||||
entry_type = ""
|
||||
|
||||
if DL_DT_TABLE.key?(name)
|
||||
entry_type = DL_DT_TABLE[name]
|
||||
else
|
||||
entry_type = "Entry type missing"
|
||||
end
|
||||
|
||||
entry_name = node.at_css('code')
|
||||
|
||||
if entry_name.nil?
|
||||
next
|
||||
end
|
||||
|
||||
entry_name = entry_name.content
|
||||
entry_path = slug.downcase + '#' + entry_name
|
||||
|
||||
entries << [entry_name, entry_path, entry_type]
|
||||
end
|
||||
|
||||
css('dt > samp').each do |node|
|
||||
|
||||
break if name == 'Other Special Variables'
|
||||
|
||||
entry_type = 'Automatic Variables' if name == 'Automatic Variables'
|
||||
entry_type = 'Functions for File Names' if name == 'Functions for File Names'
|
||||
entry_type = 'Make Cli Options' if name == 'Summary of Options'
|
||||
|
||||
entry_name = node.content
|
||||
entry_path = slug.downcase + '#' + entry_name
|
||||
|
||||
entries << [entry_name, entry_path, entry_type]
|
||||
end
|
||||
|
||||
entries
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,12 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
module Docs
|
||||
class Go
|
||||
class AttributionFilter < Docs::AttributionFilter
|
||||
def attribution_link
|
||||
url = current_url.to_s.sub! 'localhost:6060', 'golang.org'
|
||||
%(<a href="#{url}" class="_attribution-link">#{url}</a>)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,17 @@
|
||||
module Docs
|
||||
class I3
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
def additional_entries
|
||||
entries = []
|
||||
type = nil
|
||||
css('h2[id], h3[id]').each do |node|
|
||||
if node.name == 'h2' && node['id']
|
||||
type = node.content
|
||||
end
|
||||
entries << [node.content, node['id'], type]
|
||||
end
|
||||
entries
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,15 @@
|
||||
module Docs
|
||||
class Kubectl
|
||||
class CleanHtmlFilter < Filter
|
||||
|
||||
def call
|
||||
css('pre').each do |node|
|
||||
node.content = node.content.squish
|
||||
node['data-language'] = 'bash'
|
||||
end
|
||||
doc
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,38 @@
|
||||
module Docs
|
||||
class Kubectl
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
|
||||
def get_name
|
||||
name
|
||||
end
|
||||
|
||||
def get_type
|
||||
name
|
||||
end
|
||||
|
||||
def additional_entries
|
||||
entries = []
|
||||
group = 'kubectl'
|
||||
commands = css('h1').to_a()
|
||||
commands.map do |node|
|
||||
# handle titles differnetly by converting them into sidebar groups (types)
|
||||
new_group = at_css("##{node['id']} > strong")
|
||||
if new_group
|
||||
group = new_group.content.titleize
|
||||
else
|
||||
# prepend kubectl before every command
|
||||
command_name = 'kubectl ' + node.content
|
||||
entries << [command_name, node['id'], group]
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
entries
|
||||
end
|
||||
|
||||
def include_default_entry?
|
||||
false
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,22 @@
|
||||
module Docs
|
||||
class Kubernetes
|
||||
class CleanHtmlFilter < Filter
|
||||
|
||||
def call
|
||||
|
||||
# remove the API Operations section from the docs
|
||||
# by removing the h2 of id=Opetations
|
||||
# and all the preceding elements
|
||||
css('#Operations ~ *').remove
|
||||
css('#Operations').remove
|
||||
# remove horizontal rules
|
||||
css('hr').remove
|
||||
# remove footer (1.20)
|
||||
css('.pre-footer').remove
|
||||
|
||||
doc
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,37 @@
|
||||
module Docs
|
||||
class Kubernetes
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
|
||||
def get_name
|
||||
at_css('h1').content
|
||||
end
|
||||
|
||||
def get_type
|
||||
@doc.parent.css('nav .breadcrumb-item:not(.active)')[-1].content
|
||||
end
|
||||
|
||||
def additional_entries
|
||||
entries = css('h2').to_a()
|
||||
# remove the Feedback section
|
||||
entries.filter! {|node| node.content.strip != 'Feedback' }
|
||||
# remove the Operations section
|
||||
entries.filter! {|node| node['id'] != 'Operations' }
|
||||
# remove the ObjectList section
|
||||
entries.filter! {|node| node['id'] != name + 'List' }
|
||||
# remove the Object section, most of the documents start with (h1.Pod => h2.Pod h2.PodSpec ...)
|
||||
entries.filter! {|node| node['id'] != name }
|
||||
|
||||
entries.map do |node|
|
||||
# split all names into YAML object notation (ConfigMapSpec) ==> (ConfigMap.Spec)
|
||||
child_name = node.content
|
||||
if child_name.starts_with?(name) && child_name.length > name.length
|
||||
child_name = name + child_name.sub(name, '.')
|
||||
end
|
||||
|
||||
[child_name, node['id']]
|
||||
end
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,121 @@
|
||||
module Docs
|
||||
class Nix
|
||||
class CleanHtmlFilter < Filter
|
||||
def call
|
||||
if subpath == 'nixpkgs/stable/index.html'
|
||||
new_root = Nokogiri::XML::Node.new 'div', doc.document
|
||||
|
||||
# lib functions
|
||||
lib_sections = xpath("//*[@id='sec-functions-library']/ancestor::section[1]/section/section")
|
||||
lib_sections.css('.titlepage .title').each do |title|
|
||||
title.name = 'h2'
|
||||
strip_section_number(title.children)
|
||||
title['id'] = title.content.gsub(/[^a-zA-Z0-9]/, '-')
|
||||
end
|
||||
lib_sections.css('.example .title strong').each do |title|
|
||||
title.content = title.content.sub(/^Example ([0-9.]+)/, 'Example: ')
|
||||
end
|
||||
new_root.add_child(lib_sections)
|
||||
|
||||
# fetchers
|
||||
fetcher_sections = xpath("//*[@id='chap-pkgs-fetchers']/ancestor::section[1]/section[position()>1]")
|
||||
fetcher_sections.css('.titlepage .title').each do |title|
|
||||
strip_section_number(title.children)
|
||||
prefix_with(title, 'pkgs') if title.name == 'h2'
|
||||
end
|
||||
new_root.add_child(fetcher_sections)
|
||||
|
||||
# trivial builders
|
||||
trivial_sections = xpath("//*[@id='chap-trivial-builders']/ancestor::section[1]/section")
|
||||
trivial_sections.css('.titlepage .title').each do |title|
|
||||
strip_section_number(title.children)
|
||||
prefix_with(title, 'pkgs') if title.name == 'h2'
|
||||
end
|
||||
new_root.add_child(trivial_sections)
|
||||
|
||||
# special builders
|
||||
special_sections = xpath("//*[@id='chap-special']/ancestor::section[1]/section")
|
||||
special_sections.css('.titlepage .title').each do |title|
|
||||
strip_section_number(title.children)
|
||||
if title.name == 'h2'
|
||||
title.children[0].wrap('<code>')
|
||||
prefix_with(title, 'pkgs')
|
||||
end
|
||||
end
|
||||
new_root.add_child(special_sections)
|
||||
|
||||
# image builders
|
||||
image_sections = xpath("//*[@id='chap-images']/ancestor::section[1]/section")
|
||||
image_sections.css('.titlepage .title').each do |title|
|
||||
strip_section_number(title.children)
|
||||
title.children[0].wrap('<code>')
|
||||
end
|
||||
image_sections.each do |section|
|
||||
prefix = section.at_xpath('*[@class="titlepage"]//*[@class="title"]').content
|
||||
next unless ["pkgs.dockerTools", "pkgs.ociTools"].include?(prefix)
|
||||
section.xpath('section/*[@class="titlepage"]//*[@class="title"]').each do |title|
|
||||
prefix_with(title, prefix)
|
||||
title['data-add-to-index'] = ''
|
||||
end
|
||||
end
|
||||
new_root.add_child(image_sections)
|
||||
|
||||
new_root.css('pre.programlisting').attr('data-language', 'nix')
|
||||
|
||||
new_root
|
||||
elsif subpath == 'nix/stable/expressions/builtins.html'
|
||||
@doc = doc.at_css('main dl')
|
||||
|
||||
# strip out the first entry, `derivation`, the actual documentation
|
||||
# exists in a separate page
|
||||
derivation_dt = doc.children.at_css('dt')
|
||||
if derivation_dt.content.starts_with?('derivation')
|
||||
derivation_dt.remove
|
||||
doc.children.at_css('dd').remove
|
||||
else
|
||||
raise RuntimeError.new('First entry is not derivation, update the scraper')
|
||||
end
|
||||
|
||||
doc.css('dt').each do |title|
|
||||
title.name = 'h2'
|
||||
unwrap(title.at_css('a'))
|
||||
title.children[0].children.before('builtins.')
|
||||
end
|
||||
doc.css('dd').each do |description|
|
||||
description.name = 'div'
|
||||
end
|
||||
|
||||
doc.css('pre > code').each do |code|
|
||||
code.parent['data-language'] = 'nix' if code['class'] == 'language-nix'
|
||||
code.parent['data-language'] = 'xml' if code['class'] == 'language-xml'
|
||||
unwrap(code)
|
||||
end
|
||||
|
||||
doc
|
||||
else
|
||||
doc
|
||||
end
|
||||
end
|
||||
|
||||
def strip_section_number(title_children)
|
||||
while title_children.first.content == ''
|
||||
title_children.shift.remove
|
||||
end
|
||||
first_text = title_children.first
|
||||
return unless first_text.text?
|
||||
first_text.content = first_text.content.sub(/[0-9.]+ ?/, '')
|
||||
first_text.remove if first_text.blank?
|
||||
end
|
||||
|
||||
def prefix_with(title_node, text)
|
||||
title_node.css('code').each do |code|
|
||||
code.content = "#{text}.#{code.content}" unless code.content.starts_with?("#{text}.")
|
||||
end
|
||||
end
|
||||
|
||||
def unwrap(node)
|
||||
node.replace(node.inner_html)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,22 @@
|
||||
module Docs
|
||||
class Nix
|
||||
class EntriesFilter < Docs::EntriesFilter
|
||||
def include_default_entry?
|
||||
false
|
||||
end
|
||||
|
||||
def additional_entries
|
||||
css('h2, h3[data-add-to-index]').flat_map do |node|
|
||||
node.css('code').map do |code|
|
||||
title = code.content
|
||||
index = title.rindex('.')
|
||||
type = title[0...index]
|
||||
name = title.match(/^[^\s]+/)[0]
|
||||
|
||||
[name, node['id'], type]
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
@ -0,0 +1,12 @@
|
||||
module Docs
|
||||
class PointCloudLibrary
|
||||
class CleanHtmlFilter < Filter
|
||||
def call
|
||||
@doc = at_css('.contents')
|
||||
css('.dynheader.closed').remove
|
||||
css('.permalink').remove
|
||||
doc
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue