@peaceroad/markdown-it-renderer-fence 0.3.1 → 0.4.0

package/README.md

@@ -133,6 +133,25 @@ const longLine = 'This line is long but wraps.'
 
 When `setPreWrapStyle` is set to false, only `data-pre-wrap="true"` is added and the inline style is omitted.
 
+## Mark comment lines in code blocks
+
+Add `comment-line` attribute to mark comment lines. Lines that start with the given marker (after leading whitespace) are wrapped with `<span class="pre-comment-line">`.
+
+~~~md
+```samp {comment-line="#"}
+# comment
+echo 1
+```
+~~~
+
+~~~html
+<pre><samp data-pre-comment-line="#"><span class="pre-comment-line"># comment</span>
+echo 1
+</samp></pre>
+~~~
+
+Note: this feature relies on line splitting and is disabled when `useHighlightPre` is true and `<pre><code>` is provided by the highlighter.
+
 
 ## Options
 
@@ -142,8 +161,12 @@ The following options can be specified when initializing the plugin:
 - setHighlight: default true — enable calling highlight function (e.g., highlight.js).
 - setLineNumber: default true — wrap lines in spans for line numbers.
 - setEmphasizeLines: default true — enable emphasis based on emphasize-lines attribute.
-- setLineEndSpan: default 0 — character count threshold to append end-of-line span (0 to disable).
+- lineEndSpanThreshold: default 0 — character count threshold to append end-of-line span (0 to disable).
+- setLineEndSpan: alias for lineEndSpanThreshold.
 - lineEndSpanClass: default 'pre-lineend-spacer' — CSS class for end-of-line span.
 - setPreWrapStyle: default true — include inline pre-wrap styles on `<pre>` when wrap is enabled.
+- useHighlightPre: default false — if highlight returns `<pre><code>`, keep that wrapper and skip line-splitting features; attributes are still merged.
+
+When `useHighlightPre` is true and the highlight output contains `<pre><code>`, line-splitting features are disabled (setLineNumber, setEmphasizeLines, lineEndSpanThreshold, comment-line).
 - sampLang: default 'shell,console' — comma-separated list of languages (in addition to 'samp') that will be rendered using `<samp>`.
 - langPrefix: default md.options.langPrefix || 'language-' — prefix for language class on code blocks.

package/index.js

@@ -5,6 +5,7 @@ const interAttrsSpaceReg = / +/
 const tagReg = /<\/?([A-Za-z][A-Za-z0-9-]*)(?:\s+[^>]*?)?\/?\s*>/g
 const preLineTag = '<span class="pre-line">'
 const emphOpenTag = '<span class="pre-lines-emphasis">'
+const commentLineClass = 'pre-comment-line'
 const closeTag = '</span>'
 const closeTagLen = closeTag.length
 const preWrapStyle = 'white-space: pre-wrap; overflow-wrap: anywhere;'
@@ -95,10 +96,11 @@ const getEmphasizeLines = (attrVal) => {
   return lines
 }
 
-const splitFenceBlockToLines = (content, emphasizeLines, needLineNumber, needEmphasis, needEndSpan, threshold, lineEndSpanClass, br) => {
+const splitFenceBlockToLines = (content, emphasizeLines, needLineNumber, needEmphasis, needEndSpan, threshold, lineEndSpanClass, br, commentLines, commentClass) => {
   const lines = content.split(br)
   const len = lines.length
   const endSpanTag = needEndSpan ? `<span class="${lineEndSpanClass}"></span>` : ''
+  const needComment = !!(commentLines && commentClass)
   const maxLine = len - (lines[len - 1] === '' ? 1 : 0)
   let emIdx = 0
   let emStart
@@ -167,6 +169,13 @@ const splitFenceBlockToLines = (content, emphasizeLines, needLineNumber, needEmp
           lines[n+1] = `<${tagName}>` + (lines[n+1]||'')
         }
       }
+    }
+
+    if (needComment && commentLines[n]) {
+      line = `<span class="${commentClass}">` + line + closeTag
+    }
+
+    if (needLineNumber && n !== len - 1) {
       line = preLineTag + line + closeTag
     }
 
@@ -242,15 +251,18 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
   let emphasizeLines = []
   let wrapEnabled = false
   let preWrapValue
+  let commentLineValue
 
   if (token.attrs) {
     const newAttrs = []
     let dataPreStartIndex = -1
     let dataPreEmphasisIndex = -1
     let styleIndex = -1
+    let dataPreCommentIndex = -1
     let startValue
     let emphasisValue
     let styleValue
+    let sawCommentLine = false
     let sawStartAttr = false
     let sawEmphasisAttr = false
     const appendOrder = []
@@ -292,6 +304,11 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
           dataPreEmphasisIndex = newAttrs.length
           newAttrs.push(attr)
           break
+        case 'data-pre-comment-line':
+          dataPreCommentIndex = newAttrs.length
+          commentLineValue = val
+          newAttrs.push(attr)
+          break
         case 'em-lines':
         case 'emphasize-lines':
           emphasizeLines = getEmphasizeLines(val)
@@ -301,6 +318,13 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
             sawEmphasisAttr = true
           }
           break
+        case 'comment-line':
+          commentLineValue = val
+          if (!sawCommentLine) {
+            appendOrder.push('comment')
+            sawCommentLine = true
+          }
+          break
         case 'data-pre-wrap':
           preWrapValue = val
           if (val === '' || val === 'true') wrapEnabled = true
@@ -322,6 +346,9 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
     if (emphasisValue !== undefined && dataPreEmphasisIndex >= 0) {
       newAttrs[dataPreEmphasisIndex][1] = emphasisValue
     }
+    if (commentLineValue !== undefined && dataPreCommentIndex >= 0) {
+      newAttrs[dataPreCommentIndex][1] = commentLineValue
+    }
     for (const kind of appendOrder) {
       if (kind === 'start') {
         if (dataPreStartIndex === -1 && startValue !== undefined) {
@@ -331,6 +358,10 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
         if (dataPreEmphasisIndex === -1 && emphasisValue !== undefined) {
           newAttrs.push(['data-pre-emphasis', emphasisValue])
         }
+      } else if (kind === 'comment') {
+        if (dataPreCommentIndex === -1 && commentLineValue !== undefined) {
+          newAttrs.push(['data-pre-comment-line', commentLineValue])
+        }
       }
     }
     if (startNumber !== -1) {
@@ -345,6 +376,19 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
     token.attrs = newAttrs
   }
 
+  const isSamp = opt._sampReg.test(lang)
+  let commentLines
+  let needComment = false
+  if (commentLineValue) {
+    const rawLines = token.content.split(/\r?\n/)
+    commentLines = new Array(rawLines.length)
+    for (let i = 0; i < rawLines.length; i++) {
+      const isComment = rawLines[i].trimStart().startsWith(commentLineValue)
+      commentLines[i] = isComment
+      if (isComment) needComment = true
+    }
+  }
+
   if (opt.setHighlight && md.options.highlight) {
     if (lang && lang !== 'samp' ) {
       content = md.options.highlight(content, lang)
@@ -356,9 +400,12 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
   }
 
   let preAttrsFromHighlight
-  if (content.indexOf('<pre') !== -1) {
+  let hasHighlightPre = false
+  const hasPreTag = (content.indexOf('<pre') !== -1 || content.indexOf('<PRE') !== -1)
+  if (hasPreTag) {
     const preMatch = content.match(preCodeWrapperReg)
     if (preMatch) {
+      hasHighlightPre = true
       preAttrsFromHighlight = parseHtmlAttrs(preMatch[1])
       const codeAttrsFromHighlight = parseHtmlAttrs(preMatch[2])
       content = preMatch[3]
@@ -368,6 +415,9 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
       }
     }
   }
+  if (opt.useHighlightPre && hasPreTag && !hasHighlightPre) {
+    return content.endsWith('\n') ? content : content + '\n'
+  }
   orderTokenAttrs(token, opt)
 
   let preAttrs = preAttrsFromHighlight ? preAttrsFromHighlight.slice() : []
@@ -392,14 +442,15 @@ const getFenceHtml = (tokens, idx, md, opt, slf) => {
 
   const needLineNumber = opt.setLineNumber && startNumber >= 0
   const needEmphasis = opt.setEmphasizeLines && emphasizeLines.length > 0
-  const needEndSpan = opt.setLineEndSpan > 0
-  if (needLineNumber || needEmphasis || needEndSpan) {
+  const needEndSpan = opt.lineEndSpanThreshold > 0
+  const useHighlightPre = opt.useHighlightPre && hasHighlightPre
+  if (!useHighlightPre && (needLineNumber || needEmphasis || needEndSpan || needComment)) {
     const nlIndex = content.indexOf('\n')
     const br = nlIndex > 0 && content[nlIndex - 1] === '\r' ? '\r\n' : '\n'
-    content = splitFenceBlockToLines(content, emphasizeLines, needLineNumber, needEmphasis, needEndSpan, opt.setLineEndSpan, opt.lineEndSpanClass, br)
+    content = splitFenceBlockToLines(content, emphasizeLines, needLineNumber, needEmphasis, needEndSpan, opt.lineEndSpanThreshold, opt.lineEndSpanClass, br, commentLines, commentLineClass)
   }
 
-  const tag = opt._sampReg.test(lang) ? 'samp' : 'code'
+  const tag = isSamp ? 'samp' : 'code'
   return `<pre${preAttrsText}><${tag}${slf.renderAttrs(token)}>${content}</${tag}></pre>\n`
 }
 
@@ -409,13 +460,19 @@ const mditRendererFence = (md, option) => {
     setHighlight: true,
     setLineNumber: true,
     setEmphasizeLines: true,
-    setLineEndSpan: 0,
+    lineEndSpanThreshold: 0,
     lineEndSpanClass: 'pre-lineend-spacer',
     setPreWrapStyle: true,
+    useHighlightPre: false,
     sampLang: 'shell,console',
     langPrefix: md.options.langPrefix || 'language-',
   }
-  if (option) Object.assign(opt, option)
+  if (option) {
+    Object.assign(opt, option)
+    if (option.lineEndSpanThreshold == null && option.setLineEndSpan != null) {
+      opt.lineEndSpanThreshold = option.setLineEndSpan
+    }
+  }
 
   opt._sampReg = new RegExp('^(?:samp|' + opt.sampLang.split(',').join('|') + ')$')
   opt._langReg = new RegExp(opt.langPrefix + '([A-Za-z0-9-]+)')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peaceroad/markdown-it-renderer-fence",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "In code blocks, the `<samp>` tag is used with the language keywords `samp`, `shell`, and `console`, and provides an option to display line numbers.",
   "main": "index.js",
   "files": [
@@ -16,7 +16,7 @@
   "repository": "https://github.com/peaceroad/p7d-markdown-it-renderer-fence",
   "license": "MIT",
   "devDependencies": {
-    "@peaceroad/markdown-it-figure-with-p-caption": "^0.15.1",
+    "@peaceroad/markdown-it-figure-with-p-caption": "^0.15.2",
     "highlight.js": "^11.11.1",
     "markdown-it": "^14.1.0",
     "markdown-it-attrs": "^4.3.1",