travel/admin/node_modules/highlight.js/lib/languages/latex.js

277 lines
7.9 KiB
JavaScript
Raw Normal View History

2024-06-24 11:28:18 +08:00
/**
* @param {string} value
* @returns {RegExp}
* */
/**
* @param {RegExp | string } re
* @returns {string}
*/
function source(re) {
if (!re) return null;
if (typeof re === "string") return re;
return re.source;
}
/**
* Any of the passed expresssions may match
*
* Creates a huge this | this | that | that match
* @param {(RegExp | string)[] } args
* @returns {string}
*/
function either(...args) {
const joined = '(' + args.map((x) => source(x)).join("|") + ")";
return joined;
}
/*
Language: LaTeX
Author: Benedikt Wilde <bwilde@posteo.de>
Website: https://www.latex-project.org
Category: markup
*/
/** @type LanguageFn */
function latex(hljs) {
const KNOWN_CONTROL_WORDS = either(...[
'(?:NeedsTeXFormat|RequirePackage|GetIdInfo)',
'Provides(?:Expl)?(?:Package|Class|File)',
'(?:DeclareOption|ProcessOptions)',
'(?:documentclass|usepackage|input|include)',
'makeat(?:letter|other)',
'ExplSyntax(?:On|Off)',
'(?:new|renew|provide)?command',
'(?:re)newenvironment',
'(?:New|Renew|Provide|Declare)(?:Expandable)?DocumentCommand',
'(?:New|Renew|Provide|Declare)DocumentEnvironment',
'(?:(?:e|g|x)?def|let)',
'(?:begin|end)',
'(?:part|chapter|(?:sub){0,2}section|(?:sub)?paragraph)',
'caption',
'(?:label|(?:eq|page|name)?ref|(?:paren|foot|super)?cite)',
'(?:alpha|beta|[Gg]amma|[Dd]elta|(?:var)?epsilon|zeta|eta|[Tt]heta|vartheta)',
'(?:iota|(?:var)?kappa|[Ll]ambda|mu|nu|[Xx]i|[Pp]i|varpi|(?:var)rho)',
'(?:[Ss]igma|varsigma|tau|[Uu]psilon|[Pp]hi|varphi|chi|[Pp]si|[Oo]mega)',
'(?:frac|sum|prod|lim|infty|times|sqrt|leq|geq|left|right|middle|[bB]igg?)',
'(?:[lr]angle|q?quad|[lcvdi]?dots|d?dot|hat|tilde|bar)'
].map(word => word + '(?![a-zA-Z@:_])'));
const L3_REGEX = new RegExp([
// A function \module_function_name:signature or \__module_function_name:signature,
// where both module and function_name need at least two characters and
// function_name may contain single underscores.
'(?:__)?[a-zA-Z]{2,}_[a-zA-Z](?:_?[a-zA-Z])+:[a-zA-Z]*',
// A variable \scope_module_and_name_type or \scope__module_ane_name_type,
// where scope is one of l, g or c, type needs at least two characters
// and module_and_name may contain single underscores.
'[lgc]__?[a-zA-Z](?:_?[a-zA-Z])*_[a-zA-Z]{2,}',
// A quark \q_the_name or \q__the_name or
// scan mark \s_the_name or \s__vthe_name,
// where variable_name needs at least two characters and
// may contain single underscores.
'[qs]__?[a-zA-Z](?:_?[a-zA-Z])+',
// Other LaTeX3 macro names that are not covered by the three rules above.
'use(?:_i)?:[a-zA-Z]*',
'(?:else|fi|or):',
'(?:if|cs|exp):w',
'(?:hbox|vbox):n',
'::[a-zA-Z]_unbraced',
'::[a-zA-Z:]'
].map(pattern => pattern + '(?![a-zA-Z:_])').join('|'));
const L2_VARIANTS = [
{begin: /[a-zA-Z@]+/}, // control word
{begin: /[^a-zA-Z@]?/} // control symbol
];
const DOUBLE_CARET_VARIANTS = [
{begin: /\^{6}[0-9a-f]{6}/},
{begin: /\^{5}[0-9a-f]{5}/},
{begin: /\^{4}[0-9a-f]{4}/},
{begin: /\^{3}[0-9a-f]{3}/},
{begin: /\^{2}[0-9a-f]{2}/},
{begin: /\^{2}[\u0000-\u007f]/}
];
const CONTROL_SEQUENCE = {
className: 'keyword',
begin: /\\/,
relevance: 0,
contains: [
{
endsParent: true,
begin: KNOWN_CONTROL_WORDS
},
{
endsParent: true,
begin: L3_REGEX
},
{
endsParent: true,
variants: DOUBLE_CARET_VARIANTS
},
{
endsParent: true,
relevance: 0,
variants: L2_VARIANTS
}
]
};
const MACRO_PARAM = {
className: 'params',
relevance: 0,
begin: /#+\d?/
};
const DOUBLE_CARET_CHAR = {
// relevance: 1
variants: DOUBLE_CARET_VARIANTS
};
const SPECIAL_CATCODE = {
className: 'built_in',
relevance: 0,
begin: /[$&^_]/
};
const MAGIC_COMMENT = {
className: 'meta',
begin: '% !TeX',
end: '$',
relevance: 10
};
const COMMENT = hljs.COMMENT(
'%',
'$',
{
relevance: 0
}
);
const EVERYTHING_BUT_VERBATIM = [
CONTROL_SEQUENCE,
MACRO_PARAM,
DOUBLE_CARET_CHAR,
SPECIAL_CATCODE,
MAGIC_COMMENT,
COMMENT
];
const BRACE_GROUP_NO_VERBATIM = {
begin: /\{/, end: /\}/,
relevance: 0,
contains: ['self', ...EVERYTHING_BUT_VERBATIM]
};
const ARGUMENT_BRACES = hljs.inherit(
BRACE_GROUP_NO_VERBATIM,
{
relevance: 0,
endsParent: true,
contains: [BRACE_GROUP_NO_VERBATIM, ...EVERYTHING_BUT_VERBATIM]
}
);
const ARGUMENT_BRACKETS = {
begin: /\[/,
end: /\]/,
endsParent: true,
relevance: 0,
contains: [BRACE_GROUP_NO_VERBATIM, ...EVERYTHING_BUT_VERBATIM]
};
const SPACE_GOBBLER = {
begin: /\s+/,
relevance: 0
};
const ARGUMENT_M = [ARGUMENT_BRACES];
const ARGUMENT_O = [ARGUMENT_BRACKETS];
const ARGUMENT_AND_THEN = function(arg, starts_mode) {
return {
contains: [SPACE_GOBBLER],
starts: {
relevance: 0,
contains: arg,
starts: starts_mode
}
};
};
const CSNAME = function(csname, starts_mode) {
return {
begin: '\\\\' + csname + '(?![a-zA-Z@:_])',
keywords: {$pattern: /\\[a-zA-Z]+/, keyword: '\\' + csname},
relevance: 0,
contains: [SPACE_GOBBLER],
starts: starts_mode
};
};
const BEGIN_ENV = function(envname, starts_mode) {
return hljs.inherit(
{
begin: '\\\\begin(?=[ \t]*(\\r?\\n[ \t]*)?\\{' + envname + '\\})',
keywords: {$pattern: /\\[a-zA-Z]+/, keyword: '\\begin'},
relevance: 0,
},
ARGUMENT_AND_THEN(ARGUMENT_M, starts_mode)
);
};
const VERBATIM_DELIMITED_EQUAL = (innerName = "string") => {
return hljs.END_SAME_AS_BEGIN({
className: innerName,
begin: /(.|\r?\n)/,
end: /(.|\r?\n)/,
excludeBegin: true,
excludeEnd: true,
endsParent: true
});
};
const VERBATIM_DELIMITED_ENV = function(envname) {
return {
className: 'string',
end: '(?=\\\\end\\{' + envname + '\\})'
};
};
const VERBATIM_DELIMITED_BRACES = (innerName = "string") => {
return {
relevance: 0,
begin: /\{/,
starts: {
endsParent: true,
contains: [
{
className: innerName,
end: /(?=\})/,
endsParent:true,
contains: [
{
begin: /\{/,
end: /\}/,
relevance: 0,
contains: ["self"]
}
],
}
]
}
};
};
const VERBATIM = [
...['verb', 'lstinline'].map(csname => CSNAME(csname, {contains: [VERBATIM_DELIMITED_EQUAL()]})),
CSNAME('mint', ARGUMENT_AND_THEN(ARGUMENT_M, {contains: [VERBATIM_DELIMITED_EQUAL()]})),
CSNAME('mintinline', ARGUMENT_AND_THEN(ARGUMENT_M, {contains: [VERBATIM_DELIMITED_BRACES(), VERBATIM_DELIMITED_EQUAL()]})),
CSNAME('url', {contains: [VERBATIM_DELIMITED_BRACES("link"), VERBATIM_DELIMITED_BRACES("link")]}),
CSNAME('hyperref', {contains: [VERBATIM_DELIMITED_BRACES("link")]}),
CSNAME('href', ARGUMENT_AND_THEN(ARGUMENT_O, {contains: [VERBATIM_DELIMITED_BRACES("link")]})),
...[].concat(...['', '\\*'].map(suffix => [
BEGIN_ENV('verbatim' + suffix, VERBATIM_DELIMITED_ENV('verbatim' + suffix)),
BEGIN_ENV('filecontents' + suffix, ARGUMENT_AND_THEN(ARGUMENT_M, VERBATIM_DELIMITED_ENV('filecontents' + suffix))),
...['', 'B', 'L'].map(prefix =>
BEGIN_ENV(prefix + 'Verbatim' + suffix, ARGUMENT_AND_THEN(ARGUMENT_O, VERBATIM_DELIMITED_ENV(prefix + 'Verbatim' + suffix)))
)
])),
BEGIN_ENV('minted', ARGUMENT_AND_THEN(ARGUMENT_O, ARGUMENT_AND_THEN(ARGUMENT_M, VERBATIM_DELIMITED_ENV('minted')))),
];
return {
name: 'LaTeX',
aliases: ['tex'],
contains: [
...VERBATIM,
...EVERYTHING_BUT_VERBATIM
]
};
}
module.exports = latex;