mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-29 12:59:56 +00:00
Move the permalink handling to its own file
This commit is contained in:
Scott Sauyet
parent
c59b316df3
commit
686cfd3058
128
core/modules/utils/twuri-encoding.js
Normal file
128
core/modules/utils/twuri-encoding.js
Normal file
@ -0,0 +1,128 @@
|
|||||||
|
/*\
|
||||||
|
title: $:/core/modules/utils/twuri-encoding.js
|
||||||
|
type: application/javascript
|
||||||
|
module-type: utils
|
||||||
|
|
||||||
|
Utility functions related to permalink/permaview encoding/decoding.
|
||||||
|
|
||||||
|
\*/
|
||||||
|
(function(){
|
||||||
|
|
||||||
|
// The character that will substitute for a space in the URL
|
||||||
|
var SPACE_SUBSTITUTE = "_";
|
||||||
|
|
||||||
|
// The character added to the end to avoid ending with `.`, `?`, `!` or the like
|
||||||
|
var TRAILER = "_";
|
||||||
|
|
||||||
|
// The character that will separate out the list elements in the URL
|
||||||
|
var CONJUNCTION = ";";
|
||||||
|
|
||||||
|
// Those of the allowed url characters claimed by TW
|
||||||
|
var CLAIMED = [SPACE_SUBSTITUTE, ":", CONJUNCTION];
|
||||||
|
|
||||||
|
// Non-alphanumeric characters allowed in a URL fragment
|
||||||
|
// More information at https://www.rfc-editor.org/rfc/rfc3986#appendix-A
|
||||||
|
var VALID_IN_URL_FRAGMENT = "-._~!$&'()*+,;=:@/?".split("");
|
||||||
|
|
||||||
|
// The subset of the pchars we will not percent-encode in permalinks/permaviews
|
||||||
|
var SUBSTITUTES = []
|
||||||
|
$tw.utils.each(VALID_IN_URL_FRAGMENT, function(c) {
|
||||||
|
if (CLAIMED.indexOf(c) === -1) {
|
||||||
|
SUBSTITUTES.push(c)
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// A regex to match the percent-encoded characters we will want to replace.
|
||||||
|
// Something similar to the following, depending on SPACE and CONJUNCTION
|
||||||
|
// /(%2D|%2E|%7E|%21|%24|%26|%27|%28|%29|%2A|%2B|%3B|%3D|%40|%2F|%3F)/g
|
||||||
|
|
||||||
|
var CHAR_MATCH_STR = []
|
||||||
|
$tw.utils.each(SUBSTITUTES, function(c) {
|
||||||
|
CHAR_MATCH_STR.push("%" + c.charCodeAt(0).toString(16).toUpperCase())
|
||||||
|
})
|
||||||
|
var CHAR_MATCH = new RegExp("(" + CHAR_MATCH_STR.join("|") + ")", "g");
|
||||||
|
|
||||||
|
// A regex to match the SPACE_SUBSTITUTE character
|
||||||
|
var SPACE_MATCH = new RegExp("(\\" + SPACE_SUBSTITUTE + ")", "g");
|
||||||
|
|
||||||
|
// A regex to match URLs ending with sentence-ending punctuation
|
||||||
|
var SENTENCE_ENDING = new RegExp("(\\.|\\!|\\?|\\" + TRAILER + ")$", "g");
|
||||||
|
|
||||||
|
// A regex to match URLs ending with sentence-ending punctuation plus the TRAILER
|
||||||
|
var SENTENCE_TRAILING = new RegExp("(\\.|\\!|\\?|\\" + TRAILER + ")\\" + TRAILER + "$", "g");
|
||||||
|
|
||||||
|
// An object mapping the percent encodings back to their source characters
|
||||||
|
var PCT_CHAR_MAP = SUBSTITUTES.reduce(function (a, c) {
|
||||||
|
a["%" + c.charCodeAt(0).toString(16).toUpperCase()] = c
|
||||||
|
return a
|
||||||
|
}, {});
|
||||||
|
|
||||||
|
// Convert a URI List Component encoded string (with the `SPACE_SUBSTITUTE`
|
||||||
|
// value as an allowed replacement for the space character) to a string
|
||||||
|
exports.decodeTWURIList = function(s) {
|
||||||
|
var parts = s.replace(SENTENCE_TRAILING, "$1").split(CONJUNCTION);
|
||||||
|
var withSpaces = []
|
||||||
|
$tw.utils.each(parts, function(s) {
|
||||||
|
withSpaces.push(s.replace(SPACE_MATCH, " "))
|
||||||
|
});
|
||||||
|
var withBrackets = []
|
||||||
|
$tw.utils.each(withSpaces, function(s) {
|
||||||
|
withBrackets .push(s.indexOf(" ") >= 0 ? "[[" + s + "]]" : s)
|
||||||
|
});
|
||||||
|
return $tw.utils.decodeURIComponentSafe(withBrackets.join(" "));
|
||||||
|
};
|
||||||
|
|
||||||
|
// Convert a URI Target Component encoded string (with the `SPACE_SUBSTITUTE`
|
||||||
|
// value as an allowed replacement for the space character) to a string
|
||||||
|
exports.decodeTWURITarget = function(s) {
|
||||||
|
return $tw.utils.decodeURIComponentSafe(
|
||||||
|
s.replace(SENTENCE_TRAILING, "$1").replace(SPACE_MATCH, " ")
|
||||||
|
)
|
||||||
|
};
|
||||||
|
|
||||||
|
// Convert a URIComponent encoded title string (with the `SPACE_SUBSTITUTE`
|
||||||
|
// value as an allowed replacement for the space character) to a string
|
||||||
|
exports.encodeTiddlerTitle = function(s) {
|
||||||
|
var extended = s.replace(SENTENCE_ENDING, "$1" + TRAILER)
|
||||||
|
var encoded = encodeURIComponent(extended);
|
||||||
|
var substituted = encoded.replace(/\%20/g, SPACE_SUBSTITUTE);
|
||||||
|
return substituted.replace(CHAR_MATCH, function(_, c) {
|
||||||
|
return PCT_CHAR_MAP[c];
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
// Convert a URIComponent encoded filter string (with the `SPACE_SUBSTITUTE`
|
||||||
|
// value as an allowed replacement for the space character) to a string
|
||||||
|
exports.encodeFilterPath = function(s) {
|
||||||
|
var parts = s.replace(SENTENCE_ENDING, "$1" + TRAILER)
|
||||||
|
.replace(/\[\[(.+?)\]\]/g, function (_, t) {return t.replace(/ /g, SPACE_SUBSTITUTE )})
|
||||||
|
.split(" ");
|
||||||
|
var nonEmptyParts = []
|
||||||
|
$tw.utils.each(parts, function(p) {
|
||||||
|
if (p) {
|
||||||
|
nonEmptyParts.push (p)
|
||||||
|
}
|
||||||
|
});
|
||||||
|
var trimmed = [];
|
||||||
|
$tw.utils.each(nonEmptyParts, function(s) {
|
||||||
|
trimmed.push(s.trim())
|
||||||
|
});
|
||||||
|
var encoded = [];
|
||||||
|
$tw.utils.each(trimmed, function(s) {
|
||||||
|
encoded.push(encodeURIComponent(s))
|
||||||
|
});
|
||||||
|
var substituted = [];
|
||||||
|
$tw.utils.each(encoded, function(s) {
|
||||||
|
substituted.push(s.replace(/\%20/g, SPACE_SUBSTITUTE))
|
||||||
|
});
|
||||||
|
var replaced = []
|
||||||
|
$tw.utils.each(substituted, function(s) {
|
||||||
|
replaced.push(s.replace(CHAR_MATCH, function(_, c) {
|
||||||
|
return PCT_CHAR_MAP[c];
|
||||||
|
}))
|
||||||
|
});
|
||||||
|
return replaced.join(CONJUNCTION);
|
||||||
|
};
|
||||||
|
|
||||||
|
})();
|
||||||
|
|
||||||
@ -1005,120 +1005,4 @@ exports.makeCompareFunction = function(type,options) {
|
|||||||
return (types[type] || types[options.defaultType] || types.number);
|
return (types[type] || types[options.defaultType] || types.number);
|
||||||
};
|
};
|
||||||
|
|
||||||
// The character that will substitute for a space in the URL
|
|
||||||
var SPACE_SUBSTITUTE = "_";
|
|
||||||
|
|
||||||
// The character added to the end to avoid ending with `.`, `?`, `!` or the like
|
|
||||||
var TRAILER = "_";
|
|
||||||
|
|
||||||
// The character that will separate out the list elements in the URL
|
|
||||||
var CONJUNCTION = ";";
|
|
||||||
|
|
||||||
// Those of the allowed url characters claimed by TW
|
|
||||||
var CLAIMED = [SPACE_SUBSTITUTE, ":", CONJUNCTION];
|
|
||||||
|
|
||||||
// Non-alphanumeric characters allowed in a URL fragment
|
|
||||||
// More information at https://www.rfc-editor.org/rfc/rfc3986#appendix-A
|
|
||||||
var VALID_IN_URL_FRAGMENT = "-._~!$&'()*+,;=:@/?".split("");
|
|
||||||
|
|
||||||
// The subset of the pchars we will not percent-encode in permalinks/permaviews
|
|
||||||
var SUBSTITUTES = []
|
|
||||||
$tw.utils.each(VALID_IN_URL_FRAGMENT, function(c) {
|
|
||||||
if (CLAIMED.indexOf(c) === -1) {
|
|
||||||
SUBSTITUTES.push(c)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// A regex to match the percent-encoded characters we will want to replace.
|
|
||||||
// Something similar to the following, depending on SPACE and CONJUNCTION
|
|
||||||
// /(%2D|%2E|%7E|%21|%24|%26|%27|%28|%29|%2A|%2B|%3B|%3D|%40|%2F|%3F)/g
|
|
||||||
|
|
||||||
var CHAR_MATCH_STR = []
|
|
||||||
$tw.utils.each(SUBSTITUTES, function(c) {
|
|
||||||
CHAR_MATCH_STR.push("%" + c.charCodeAt(0).toString(16).toUpperCase())
|
|
||||||
})
|
|
||||||
var CHAR_MATCH = new RegExp("(" + CHAR_MATCH_STR.join("|") + ")", "g");
|
|
||||||
|
|
||||||
// A regex to match the SPACE_SUBSTITUTE character
|
|
||||||
var SPACE_MATCH = new RegExp("(\\" + SPACE_SUBSTITUTE + ")", "g");
|
|
||||||
|
|
||||||
// A regex to match URLs ending with sentence-ending punctuation
|
|
||||||
var SENTENCE_ENDING = new RegExp("(\\.|\\!|\\?|\\" + TRAILER + ")$", "g");
|
|
||||||
|
|
||||||
// A regex to match URLs ending with sentence-ending punctuation plus the TRAILER
|
|
||||||
var SENTENCE_TRAILING = new RegExp("(\\.|\\!|\\?|\\" + TRAILER + ")\\" + TRAILER + "$", "g");
|
|
||||||
|
|
||||||
// An object mapping the percent encodings back to their source characters
|
|
||||||
var PCT_CHAR_MAP = SUBSTITUTES.reduce(function (a, c) {
|
|
||||||
a["%" + c.charCodeAt(0).toString(16).toUpperCase()] = c
|
|
||||||
return a
|
|
||||||
}, {});
|
|
||||||
|
|
||||||
// Convert a URI List Component encoded string (with the `SPACE_SUBSTITUTE`
|
|
||||||
// value as an allowed replacement for the space character) to a string
|
|
||||||
exports.decodeTWURIList = function(s) {
|
|
||||||
var parts = s.replace(SENTENCE_TRAILING, "$1").split(CONJUNCTION);
|
|
||||||
var withSpaces = []
|
|
||||||
$tw.utils.each(parts, function(s) {
|
|
||||||
withSpaces.push(s.replace(SPACE_MATCH, " "))
|
|
||||||
});
|
|
||||||
var withBrackets = []
|
|
||||||
$tw.utils.each(withSpaces, function(s) {
|
|
||||||
withBrackets .push(s.indexOf(" ") >= 0 ? "[[" + s + "]]" : s)
|
|
||||||
});
|
|
||||||
return $tw.utils.decodeURIComponentSafe(withBrackets.join(" "));
|
|
||||||
};
|
|
||||||
|
|
||||||
// Convert a URI Target Component encoded string (with the `SPACE_SUBSTITUTE`
|
|
||||||
// value as an allowed replacement for the space character) to a string
|
|
||||||
exports.decodeTWURITarget = function(s) {
|
|
||||||
return $tw.utils.decodeURIComponentSafe(
|
|
||||||
s.replace(SENTENCE_TRAILING, "$1").replace(SPACE_MATCH, " ")
|
|
||||||
)
|
|
||||||
};
|
|
||||||
|
|
||||||
// Convert a URIComponent encoded title string (with the `SPACE_SUBSTITUTE`
|
|
||||||
// value as an allowed replacement for the space character) to a string
|
|
||||||
exports.encodeTiddlerTitle = function(s) {
|
|
||||||
var extended = s.replace(SENTENCE_ENDING, "$1" + TRAILER)
|
|
||||||
var encoded = encodeURIComponent(extended);
|
|
||||||
var substituted = encoded.replace(/\%20/g, SPACE_SUBSTITUTE);
|
|
||||||
return substituted.replace(CHAR_MATCH, function(_, c) {
|
|
||||||
return PCT_CHAR_MAP[c];
|
|
||||||
});
|
|
||||||
};
|
|
||||||
|
|
||||||
// Convert a URIComponent encoded filter string (with the `SPACE_SUBSTITUTE`
|
|
||||||
// value as an allowed replacement for the space character) to a string
|
|
||||||
exports.encodeFilterPath = function(s) {
|
|
||||||
var parts = s.replace(SENTENCE_ENDING, "$1" + TRAILER)
|
|
||||||
.replace(/\[\[(.+?)\]\]/g, function (_, t) {return t.replace(/ /g, SPACE_SUBSTITUTE )})
|
|
||||||
.split(" ");
|
|
||||||
var nonEmptyParts = []
|
|
||||||
$tw.utils.each(parts, function(p) {
|
|
||||||
if (p) {
|
|
||||||
nonEmptyParts.push (p)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
var trimmed = [];
|
|
||||||
$tw.utils.each(nonEmptyParts, function(s) {
|
|
||||||
trimmed.push(s.trim())
|
|
||||||
});
|
|
||||||
var encoded = [];
|
|
||||||
$tw.utils.each(trimmed, function(s) {
|
|
||||||
encoded.push(encodeURIComponent(s))
|
|
||||||
});
|
|
||||||
var substituted = [];
|
|
||||||
$tw.utils.each(encoded, function(s) {
|
|
||||||
substituted.push(s.replace(/\%20/g, SPACE_SUBSTITUTE))
|
|
||||||
});
|
|
||||||
var replaced = []
|
|
||||||
$tw.utils.each(substituted, function(s) {
|
|
||||||
replaced.push(s.replace(CHAR_MATCH, function(_, c) {
|
|
||||||
return PCT_CHAR_MAP[c];
|
|
||||||
}))
|
|
||||||
});
|
|
||||||
return replaced.join(CONJUNCTION);
|
|
||||||
};
|
|
||||||
|
|
||||||
})();
|
})();
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user