/** * @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 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(?=\\s*\\r?\\n?\\s*\\{' + 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;