/* Copyright (c) 2014-2015 Vitaly Puzrin, Alex Kocharin Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /* Markdown-it-footnotes plugin 3.0.2 source adapted to fit MarkBind's needs, to: - show a popover along with the footnote link - remove footnote backreferences - change footnote definition opening / closing renderers for easy identification in NodeProcessor Changes are delimited with a // CHANGE HERE comment */ import MarkdownIt from 'markdown-it'; import Renderer from 'markdown-it/lib/renderer'; import Token from 'markdown-it/lib/token'; import StateBlock from 'markdown-it/lib/rules_block/state_block'; import StateInline from 'markdown-it/lib/rules_inline/state_inline'; import StateCore from 'markdown-it/lib/rules_core/state_core'; import { MARKBIND_FOOTNOTE_POPOVER_ID_PREFIX } from '../../../html/constants.js'; // Process footnotes // //////////////////////////////////////////////////////////////////////////////// // Renderer partials function render_footnote_anchor_name(tokens: Token[], idx: number, _options: MarkdownIt.Options, env: any) { const n = Number(tokens[idx].meta.id + 1).toString(); let prefix = ''; if (typeof env.docId === 'string') { prefix = `-${env.docId}-`; } return prefix + n; } function render_footnote_caption(tokens: Token[], idx: number) { let n = Number(tokens[idx].meta.id + 1).toString(); if (tokens[idx].meta.subId > 0) { n += `:${tokens[idx].meta.subId}`; } return `[${n}]`; } function render_footnote_ref(tokens: Token[], idx: number, options: MarkdownIt.Options, env: any, slf: Renderer) { const id = slf.rules.footnote_anchor_name!(tokens, idx, options, env, slf); const caption = slf.rules.footnote_caption!(tokens, idx, options, env, slf); // CHANGE here // Old code: // return '' + caption + ''; // Additions: for footnote popover and aria-describedby label return `` + `` + caption + ''; } function render_footnote_block_open() { // CHANGE HERE - change this into something easily recognisable and combinable by {@link NodeProcessor} // Original: /*return (options.xhtmlOut ? '
\n' : '
\n') + '
\n' + '
    \n';*/ return '\n'; } function render_footnote_block_close() { // CHANGE HERE - change this into something easily recognisable and combinable by {@link NodeProcessor} // Original: return '
\n
\n'; return '\n'; } function render_footnote_open(tokens: Token[], idx: number, options: MarkdownIt.Options, env: any, slf: Renderer) { let id = slf.rules.footnote_anchor_name!(tokens, idx, options, env, slf); if (tokens[idx].meta.subId > 0) { id += `:${tokens[idx].meta.subId}`; } return `
  • `; } function render_footnote_close() { return '
  • \n'; } function render_footnote_anchor() { // CHANGE HERE // Below line adds backreferences, but doesn't work well with panels, so disabled for now. // Old code: // /* ↩ with escape code to prevent display as Apple Emoji on iOS */ // return ' \u21a9\uFE0E'; return ''; } export function footnotePlugin(md: MarkdownIt): void { const parseLinkLabel = md.helpers.parseLinkLabel; const isSpace = md.utils.isSpace; md.renderer.rules.footnote_ref = render_footnote_ref; md.renderer.rules.footnote_block_open = render_footnote_block_open; md.renderer.rules.footnote_block_close = render_footnote_block_close; md.renderer.rules.footnote_open = render_footnote_open; md.renderer.rules.footnote_close = render_footnote_close; md.renderer.rules.footnote_anchor = render_footnote_anchor; // helpers (only used in other rules, no tokens are attached to those) md.renderer.rules.footnote_caption = render_footnote_caption; md.renderer.rules.footnote_anchor_name = render_footnote_anchor_name; // Process footnote block definition function footnote_def(state: StateBlock, startLine: number, endLine: number, silent: boolean): boolean { let pos; let label; let token; let ch; const start = state.bMarks[startLine] + state.tShift[startLine]; const max = state.eMarks[startLine]; // line should be at least 5 chars - "[^x]:" if (start + 4 > max) { return false; } if (state.src.charCodeAt(start) !== 0x5B/* [ */) { return false; } if (state.src.charCodeAt(start + 1) !== 0x5E/* ^ */) { return false; } for (pos = start + 2; pos < max; pos++) { if (state.src.charCodeAt(pos) === 0x20) { return false; } if (state.src.charCodeAt(pos) === 0x5D /* ] */) { break; } } if (pos === start + 2) { return false; } // no empty footnote labels if (pos + 1 >= max || state.src.charCodeAt(++pos) !== 0x3A /* : */) { return false; } if (silent) { return true; } pos++; if (!state.env.footnotes) { state.env.footnotes = {}; } if (!state.env.footnotes.refs) { state.env.footnotes.refs = {}; } label = state.src.slice(start + 2, pos - 2); state.env.footnotes.refs[`:${label}`] = -1; token = new state.Token('footnote_reference_open', '', 1); token.meta = { label: label }; token.level = state.level++; state.tokens.push(token); const oldBMark = state.bMarks[startLine]; const oldTShift = state.tShift[startLine]; const oldSCount = state.sCount[startLine]; const oldParentType = state.parentType; const posAfterColon = pos; const initial = state.sCount[startLine] + pos - (state.bMarks[startLine] + state.tShift[startLine]); let offset = initial; while (pos < max) { ch = state.src.charCodeAt(pos); if (isSpace(ch)) { if (ch === 0x09) { offset += 4 - offset % 4; } else { offset++; } } else { break; } pos++; } state.tShift[startLine] = pos - posAfterColon; state.sCount[startLine] = offset - initial; state.bMarks[startLine] = posAfterColon; state.blkIndent += 4; state.parentType = 'footnote' as any; // Note find a better fix for this. if (state.sCount[startLine] < state.blkIndent) { state.sCount[startLine] += state.blkIndent; } state.md.block.tokenize(state, startLine, endLine); state.parentType = oldParentType; state.blkIndent -= 4; state.tShift[startLine] = oldTShift; state.sCount[startLine] = oldSCount; state.bMarks[startLine] = oldBMark; token = new state.Token('footnote_reference_close', '', -1); token.level = --state.level; state.tokens.push(token); return true; } // Process inline footnotes (^[...]) function footnote_inline(state: StateInline, silent: boolean): boolean { let labelStart; let labelEnd; let footnoteId; let token; let tokens: Token[]; const max = state.posMax; const start = state.pos; if (start + 2 >= max) { return false; } if (state.src.charCodeAt(start) !== 0x5E/* ^ */) { return false; } if (state.src.charCodeAt(start + 1) !== 0x5B/* [ */) { return false; } labelStart = start + 2; labelEnd = parseLinkLabel(state, start + 1); // parser failed to find ']', so it's not a valid note if (labelEnd < 0) { return false; } // We found the end of the link, and know for a fact it's a valid link; // so all that's left to do is to call tokenizer. // if (!silent) { if (!state.env.footnotes) { state.env.footnotes = {}; } if (!state.env.footnotes.list) { state.env.footnotes.list = []; } footnoteId = state.env.footnotes.list.length; state.md.inline.parse( state.src.slice(labelStart, labelEnd), state.md, state.env, tokens = [] ); token = state.push('footnote_ref', '', 0); token.meta = { id: footnoteId }; state.env.footnotes.list[footnoteId] = { content: state.src.slice(labelStart, labelEnd), tokens: tokens }; } state.pos = labelEnd + 1; state.posMax = max; return true; } // Process footnote references ([^...]) function footnote_ref(state: StateInline, silent: boolean): boolean { let label; let pos; let footnoteId; let footnoteSubId; let token; const max = state.posMax; const start = state.pos; // should be at least 4 chars - "[^x]" if (start + 3 > max) { return false; } if (!state.env.footnotes || !state.env.footnotes.refs) { return false; } if (state.src.charCodeAt(start) !== 0x5B/* [ */) { return false; } if (state.src.charCodeAt(start + 1) !== 0x5E/* ^ */) { return false; } for (pos = start + 2; pos < max; pos++) { if (state.src.charCodeAt(pos) === 0x20) { return false; } if (state.src.charCodeAt(pos) === 0x0A) { return false; } if (state.src.charCodeAt(pos) === 0x5D /* ] */) { break; } } if (pos === start + 2 || pos >= max) { return false; } // no empty footnote labels pos++; label = state.src.slice(start + 2, pos - 1); if (typeof state.env.footnotes.refs[`:${label}`] === 'undefined') { return false; } if (!silent) { if (!state.env.footnotes.list) { state.env.footnotes.list = []; } if (state.env.footnotes.refs[`:${label}`] < 0) { footnoteId = state.env.footnotes.list.length; state.env.footnotes.list[footnoteId] = { label: label, count: 0 }; state.env.footnotes.refs[`:${label}`] = footnoteId; } else { footnoteId = state.env.footnotes.refs[`:${label}`]; } footnoteSubId = state.env.footnotes.list[footnoteId].count; state.env.footnotes.list[footnoteId].count++; token = state.push('footnote_ref', '', 0); token.meta = { id: footnoteId, subId: footnoteSubId, label }; } state.pos = pos; state.posMax = max; return true; } // Glue footnote tokens to end of token stream function footnote_tail(state: StateCore): void { let i, l, j, t, lastParagraph, list, token, tokens: Token[], current: Token[] = [], currentLabel: string = ''; let insideRef = false; const refTokens: { [key: string]: Token[] } = {}; if (!state.env.footnotes) { return; } state.tokens = state.tokens.filter((tok: Token) => { if (tok.type === 'footnote_reference_open') { insideRef = true; current = []; currentLabel = tok.meta.label; return false; } if (tok.type === 'footnote_reference_close') { insideRef = false; refTokens[`:${currentLabel}`] = current; return false; } if (insideRef) { current.push(tok); } return !insideRef; }); if (!state.env.footnotes.list) { return; } list = state.env.footnotes.list; token = new state.Token('footnote_block_open', '', 1); state.tokens.push(token); for (i = 0, l = list.length; i < l; i++) { token = new state.Token('footnote_open', '', 1); token.meta = { id: i, label: list[i].label }; state.tokens.push(token); if (list[i].tokens) { tokens = []; token = new state.Token('paragraph_open', 'p', 1); token.block = true; tokens.push(token); token = new state.Token('inline', '', 0); token.children = list[i].tokens; token.content = list[i].content; tokens.push(token); token = new state.Token('paragraph_close', 'p', -1); token.block = true; tokens.push(token); } else if (list[i].label && refTokens[`:${list[i].label}`]) { tokens = refTokens[`:${list[i].label}`]; } else { tokens = []; } state.tokens = state.tokens.concat(tokens); const lastToken = state.tokens[state.tokens.length - 1]; if (lastToken && lastToken.type === 'paragraph_close') { lastParagraph = state.tokens.pop()!; } else { lastParagraph = null; } t = list[i].count > 0 ? list[i].count : 1; for (j = 0; j < t; j++) { token = new state.Token('footnote_anchor', '', 0); token.meta = { id: i, subId: j, label: list[i].label }; state.tokens.push(token); } if (lastParagraph) { state.tokens.push(lastParagraph); } token = new state.Token('footnote_close', '', -1); state.tokens.push(token); } token = new state.Token('footnote_block_close', '', -1); state.tokens.push(token); } md.block.ruler.before('reference', 'footnote_def', footnote_def, { alt: [ 'paragraph', 'reference' ] }); md.inline.ruler.after('image', 'footnote_inline', footnote_inline); md.inline.ruler.after('footnote_inline', 'footnote_ref', footnote_ref); md.core.ruler.after('inline', 'footnote_tail', footnote_tail); }