npm - docrev - Versions diffs - 0.11.1 → 0.11.3 - Mend

docrev 0.11.1 → 0.11.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (144) hide show

package/.gitattributes +1 -1
package/CHANGELOG.md +207 -197
package/PLAN-tables-and-postprocess.md +850 -850
package/README.md +433 -433
package/bin/rev.js +11 -11
package/bin/rev.ts +145 -145
package/completions/rev.bash +127 -127
package/completions/rev.ps1 +210 -210
package/completions/rev.zsh +207 -207
package/dist/lib/annotations.d.ts.map +1 -1
package/dist/lib/annotations.js +28 -0
package/dist/lib/annotations.js.map +1 -1
package/dist/lib/build.d.ts +28 -0
package/dist/lib/build.d.ts.map +1 -1
package/dist/lib/build.js +81 -4
package/dist/lib/build.js.map +1 -1
package/dist/lib/commands/comments.d.ts.map +1 -1
package/dist/lib/commands/comments.js +58 -28
package/dist/lib/commands/comments.js.map +1 -1
package/dist/lib/commands/context.d.ts +1 -0
package/dist/lib/commands/context.d.ts.map +1 -1
package/dist/lib/commands/context.js +1 -0
package/dist/lib/commands/context.js.map +1 -1
package/dist/lib/commands/core.d.ts.map +1 -1
package/dist/lib/commands/core.js +25 -8
package/dist/lib/commands/core.js.map +1 -1
package/dist/lib/commands/response.js +1 -1
package/dist/lib/commands/response.js.map +1 -1
package/dist/lib/commands/utilities.js +164 -164
package/dist/lib/commands/word-tools.js +8 -8
package/dist/lib/grammar.js +3 -3
package/dist/lib/import.d.ts +14 -0
package/dist/lib/import.d.ts.map +1 -1
package/dist/lib/import.js +23 -0
package/dist/lib/import.js.map +1 -1
package/dist/lib/input.d.ts +67 -0
package/dist/lib/input.d.ts.map +1 -0
package/dist/lib/input.js +164 -0
package/dist/lib/input.js.map +1 -0
package/dist/lib/macro-filter.lua +201 -201
package/dist/lib/pdf-comments.js +44 -44
package/dist/lib/plugins.js +57 -57
package/dist/lib/pptx-color-filter.lua +37 -37
package/dist/lib/pptx-themes.js +115 -115
package/dist/lib/response.d.ts +1 -1
package/dist/lib/response.d.ts.map +1 -1
package/dist/lib/response.js +5 -2
package/dist/lib/response.js.map +1 -1
package/dist/lib/schema.d.ts.map +1 -1
package/dist/lib/schema.js +8 -2
package/dist/lib/schema.js.map +1 -1
package/dist/lib/spelling.js +2 -2
package/dist/lib/templates.js +387 -387
package/dist/lib/themes.js +51 -51
package/eslint.config.js +27 -27
package/lib/anchor-match.ts +307 -307
package/lib/annotations.ts +695 -664
package/lib/build.ts +2047 -1956
package/lib/citations.ts +160 -160
package/lib/commands/build.ts +885 -885
package/lib/commands/citations.ts +515 -515
package/lib/commands/comments.ts +1077 -1050
package/lib/commands/context.ts +185 -176
package/lib/commands/core.ts +328 -309
package/lib/commands/doi.ts +451 -451
package/lib/commands/file-ops.ts +372 -372
package/lib/commands/history.ts +320 -320
package/lib/commands/index.ts +87 -87
package/lib/commands/init.ts +259 -259
package/lib/commands/merge-resolve.ts +378 -378
package/lib/commands/preview.ts +178 -178
package/lib/commands/project-info.ts +244 -244
package/lib/commands/quality.ts +517 -517
package/lib/commands/response.ts +454 -454
package/lib/commands/section-boundaries.ts +82 -82
package/lib/commands/sections.ts +451 -451
package/lib/commands/sync.ts +689 -689
package/lib/commands/text-ops.ts +449 -449
package/lib/commands/utilities.ts +448 -448
package/lib/commands/verify-anchors.ts +272 -272
package/lib/commands/word-tools.ts +340 -340
package/lib/comment-realign.ts +99 -99
package/lib/config.ts +84 -84
package/lib/crossref.ts +781 -781
package/lib/csl.ts +191 -191
package/lib/dependencies.ts +132 -132
package/lib/diff-engine.ts +465 -465
package/lib/doi-cache.ts +115 -115
package/lib/doi.ts +879 -879
package/lib/equations.ts +506 -506
package/lib/errors.ts +350 -350
package/lib/format.ts +541 -541
package/lib/git.ts +326 -326
package/lib/grammar.ts +303 -303
package/lib/image-registry.ts +180 -180
package/lib/import.ts +932 -906
package/lib/input.ts +174 -0
package/lib/journals.ts +543 -543
package/lib/macro-filter.lua +201 -201
package/lib/macros.ts +273 -273
package/lib/merge.ts +633 -633
package/lib/ooxml.ts +768 -768
package/lib/orcid.ts +144 -144
package/lib/pdf-comments.ts +263 -263
package/lib/pdf-import.ts +524 -524
package/lib/plugins.ts +362 -362
package/lib/postprocess.ts +188 -188
package/lib/pptx-color-filter.lua +37 -37
package/lib/pptx-template.ts +469 -469
package/lib/pptx-themes.ts +483 -483
package/lib/protect-restore.ts +520 -520
package/lib/rate-limiter.ts +127 -127
package/lib/response.ts +200 -197
package/lib/restore-references.ts +240 -240
package/lib/review.ts +327 -327
package/lib/schema.ts +494 -488
package/lib/scientific-words.ts +73 -73
package/lib/sections.ts +428 -428
package/lib/slides.ts +756 -756
package/lib/spelling.ts +334 -334
package/lib/templates.ts +526 -526
package/lib/themes.ts +742 -742
package/lib/trackchanges.ts +166 -166
package/lib/tui.ts +450 -450
package/lib/types.ts +546 -546
package/lib/undo.ts +250 -250
package/lib/utils.ts +69 -69
package/lib/variables.ts +179 -179
package/lib/word-extraction.ts +525 -525
package/lib/word.ts +526 -526
package/lib/wordcomments.ts +789 -789
package/package.json +1 -1
package/scripts/postbuild.js +47 -47
package/skill/REFERENCE.md +550 -550
package/skill/SKILL.md +302 -302
package/tsconfig.json +26 -26
package/types/index.d.ts +531 -531
package/issues.md +0 -180
package/site/assets/extra.css +0 -208
package/site/commands.html +0 -926
package/site/configuration.html +0 -469
package/site/index.html +0 -288
package/site/troubleshooting.html +0 -461
package/site/workflow.html +0 -518

package/site/troubleshooting.html DELETED Viewed

@@ -1,461 +0,0 @@
-<!DOCTYPE html>
-<html lang="en" data-bs-theme="light">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Troubleshooting — docrev</title>
-  <meta name="description" content="CLI for writing documents in Markdown while collaborating with Word users.">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootswatch@5.3.3/dist/sandstone/bootstrap.min.css">
-  <style>
-html { -webkit-text-size-adjust: 100%; }
-pre > code.sourceCode { white-space: pre; position: relative; }
-pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
-pre > code.sourceCode > span:empty { height: 1.2em; }
-.sourceCode { overflow: visible; }
-code.sourceCode > span { color: inherit; text-decoration: inherit; }
-div.sourceCode { margin: 1em 0; }
-pre.sourceCode { margin: 0; }
-@media screen {
-div.sourceCode { overflow: auto; }
-}
-@media print {
-pre > code.sourceCode { white-space: pre-wrap; }
-pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
-}
-pre.numberSource code
-  { counter-reset: source-line 0; }
-pre.numberSource code > span
-  { position: relative; left: -4em; counter-increment: source-line; }
-pre.numberSource code > span > a:first-child::before
-  { content: counter(source-line);
-    position: relative; left: -1em; text-align: right; vertical-align: baseline;
-    border: none; display: inline-block;
-    -webkit-touch-callout: none; -webkit-user-select: none;
-    -khtml-user-select: none; -moz-user-select: none;
-    -ms-user-select: none; user-select: none;
-    padding: 0 4px; width: 4em;
-    color: #aaaaaa;
-  }
-pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa;  padding-left: 4px; }
-div.sourceCode
-  {   }
-@media screen {
-pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
-}
-code span.al { color: #ff0000; font-weight: bold; } /* Alert */
-code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
-code span.at { color: #7d9029; } /* Attribute */
-code span.bn { color: #40a070; } /* BaseN */
-code span.bu { color: #008000; } /* BuiltIn */
-code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
-code span.ch { color: #4070a0; } /* Char */
-code span.cn { color: #880000; } /* Constant */
-code span.co { color: #60a0b0; font-style: italic; } /* Comment */
-code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
-code span.do { color: #ba2121; font-style: italic; } /* Documentation */
-code span.dt { color: #902000; } /* DataType */
-code span.dv { color: #40a070; } /* DecVal */
-code span.er { color: #ff0000; font-weight: bold; } /* Error */
-code span.ex { } /* Extension */
-code span.fl { color: #40a070; } /* Float */
-code span.fu { color: #06287e; } /* Function */
-code span.im { color: #008000; font-weight: bold; } /* Import */
-code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
-code span.kw { color: #007020; font-weight: bold; } /* Keyword */
-code span.op { color: #666666; } /* Operator */
-code span.ot { color: #007020; } /* Other */
-code span.pp { color: #bc7a00; } /* Preprocessor */
-code span.sc { color: #4070a0; } /* SpecialChar */
-code span.ss { color: #bb6688; } /* SpecialString */
-code span.st { color: #4070a0; } /* String */
-code span.va { color: #19177c; } /* Variable */
-code span.vs { color: #4070a0; } /* VerbatimString */
-code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
-  </style>
-  <link rel="stylesheet" href="assets/extra.css">
-</head>
-<body>
-<nav class="navbar navbar-expand-lg fixed-top" aria-label="Site navigation">
-  <div class="container">
-    <a class="navbar-brand me-2" href="index.html">docrev</a>
-    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar-main" aria-controls="navbar-main" aria-expanded="false" aria-label="Toggle navigation">
-      <span class="navbar-toggler-icon"></span>
-    </button>
-    <div class="collapse navbar-collapse" id="navbar-main">
-      <ul class="navbar-nav me-auto">
-        <li class="nav-item">
-          <a class="nav-link"  href="index.html">Home</a>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link"  href="workflow.html">Get Started</a>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link"  href="commands.html">Commands</a>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link"  href="configuration.html">Configuration</a>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link active" aria-current="page" href="troubleshooting.html">Troubleshooting</a>
-        </li>
-      </ul>
-      <ul class="navbar-nav">
-        <li class="nav-item">
-          <button id="theme-toggle" class="btn btn-link nav-link border-0" aria-label="Toggle dark mode">
-            <svg id="icon-sun" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
-              <path d="M8 11a3 3 0 1 1 0-6 3 3 0 0 1 0 6m0 1a4 4 0 1 0 0-8 4 4 0 0 0 0 8M8 0a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 0m0 13a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 13m8-5a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2a.5.5 0 0 1 .5.5M3 8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2A.5.5 0 0 1 3 8m10.657-5.657a.5.5 0 0 1 0 .707l-1.414 1.415a.5.5 0 1 1-.707-.708l1.414-1.414a.5.5 0 0 1 .707 0m-9.193 9.193a.5.5 0 0 1 0 .707L3.05 13.657a.5.5 0 0 1-.707-.707l1.414-1.414a.5.5 0 0 1 .707 0m9.193 2.121a.5.5 0 0 1-.707 0l-1.414-1.414a.5.5 0 0 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707M4.464 4.465a.5.5 0 0 1-.707 0L2.343 3.05a.5.5 0 1 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707"/>
-            </svg>
-            <svg id="icon-moon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16" style="display:none">
-              <path d="M6 .278a.768.768 0 0 1 .08.858 7.208 7.208 0 0 0-.878 3.46c0 4.021 3.278 7.277 7.318 7.277.527 0 1.04-.055 1.533-.16a.787.787 0 0 1 .81.316.733.733 0 0 1-.031.893A8.349 8.349 0 0 1 8.344 16C3.734 16 0 12.286 0 7.71 0 4.266 2.114 1.312 5.124.06A.752.752 0 0 1 6 .278"/>
-            </svg>
-          </button>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link" href="https://github.com/gcol33/docrev" aria-label="GitHub">
-            <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" viewBox="0 0 16 16">
-              <path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.012 8.012 0 0 0 16 8c0-4.42-3.58-8-8-8"/>
-            </svg>
-          </a>
-        </li>
-        <li class="nav-item">
-          <a class="nav-link" href="https://www.npmjs.com/package/docrev" aria-label="npm">
-            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 16 16">
-              <path d="M0 0v16h16V0zm5.333 13.333H2.667V5.333h2.666v5.334H8V5.333h2.667v8H5.333z"/>
-            </svg>
-          </a>
-        </li>
-      </ul>
-    </div>
-  </div>
-</nav>
-<div class="container template-article">
-  <div class="row">
-    <main id="main" class="col-md-9">
-      <h1 id="troubleshooting">Troubleshooting</h1>
-      <p>Common issues and solutions for docrev.</p>
-      <h2 id="installation-issues">Installation Issues</h2>
-      <h3 id="pandoc-command-not-found">“pandoc: command not found”</h3>
-      <p>Pandoc is required for building documents.</p>
-      <p><strong>macOS:</strong></p>
-      <div class="sourceCode" id="cb1"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="ex">brew</span> install pandoc</span></code></pre></div>
-      <p><strong>Windows:</strong></p>
-      <div class="sourceCode" id="cb2"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">winget</span> install JohnMacFarlane.Pandoc</span>
-<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="co"># or download from https://pandoc.org/installing.html</span></span></code></pre></div>
-      <p><strong>Linux (Debian/Ubuntu):</strong></p>
-      <div class="sourceCode" id="cb3"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> apt install pandoc</span></code></pre></div>
-      <p>Verify installation:</p>
-      <div class="sourceCode" id="cb4"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">pandoc</span> <span class="at">--version</span></span></code></pre></div>
-      <h3 id="pandoc-crossref-command-not-found">“pandoc-crossref:
-      command not found”</h3>
-      <p>pandoc-crossref is optional but required for figure/table
-      cross-references.</p>
-      <p><strong>macOS:</strong></p>
-      <div class="sourceCode" id="cb5"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ex">brew</span> install pandoc-crossref</span></code></pre></div>
-      <p><strong>Windows:</strong> Download from
-      https://github.com/lierdakil/pandoc-crossref/releases</p>
-      <p><strong>Linux:</strong></p>
-      <div class="sourceCode" id="cb6"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Check your package manager or download from GitHub releases</span></span></code></pre></div>
-      <h3 id="latex-not-found-pdf-generation-fails">LaTeX not found (PDF
-      generation fails)</h3>
-      <p>PDF output requires a LaTeX distribution.</p>
-      <p><strong>macOS:</strong></p>
-      <div class="sourceCode" id="cb7"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ex">brew</span> install <span class="at">--cask</span> mactex-no-gui</span>
-<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="co"># or smaller: brew install --cask basictex</span></span></code></pre></div>
-      <p><strong>Windows:</strong> Install MiKTeX from
-      https://miktex.org/download</p>
-      <p><strong>Linux:</strong></p>
-      <div class="sourceCode" id="cb8"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> apt install texlive-latex-base texlive-fonts-recommended</span></code></pre></div>
-      <h2 id="build-errors">Build Errors</h2>
-      <h3 id="no-section-files-found">“No section files found”</h3>
-      <p><strong>Cause:</strong> No <code>.md</code> files in the
-      directory, or sections not specified in <code>rev.yaml</code>.</p>
-      <p><strong>Solutions:</strong> 1. Create section files:
-      <code>rev new</code> 2. Specify sections in <code>rev.yaml</code>:
-      <code>yaml    sections:      - introduction.md      - methods.md</code>
-      3. Check you’re in the correct directory</p>
-      <h3 id="failed-to-parse-rev.yaml">“Failed to parse rev.yaml”</h3>
-      <p><strong>Cause:</strong> Invalid YAML syntax.</p>
-      <p><strong>Common fixes:</strong> - Check indentation (use spaces,
-      not tabs) - Quote strings with special characters - Validate with:
-      <code>rev check</code></p>
-      <p><strong>Example of correct YAML:</strong></p>
-      <div class="sourceCode" id="cb9"><pre
-      class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="fu">title</span><span class="kw">:</span><span class="at"> </span><span class="st">&quot;My Paper: A Study&quot;</span><span class="co">  # Quotes needed for colon</span></span>
-<span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="fu">authors</span><span class="kw">:</span></span>
-<span id="cb9-3"><a href="#cb9-3" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="kw">-</span><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> John Doe</span><span class="co">          # 2-space indent</span></span>
-<span id="cb9-4"><a href="#cb9-4" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">affiliation</span><span class="kw">:</span><span class="at"> University</span></span></code></pre></div>
-      <h3 id="build-produces-empty-pdf">Build produces empty PDF</h3>
-      <p><strong>Causes:</strong> 1. Section files are empty 2. Pandoc
-      filter errors (check terminal output) 3. LaTeX errors</p>
-      <p><strong>Debug:</strong></p>
-      <div class="sourceCode" id="cb10"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> build <span class="at">--verbose</span></span>
-<span id="cb10-2"><a href="#cb10-2" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> build tex  <span class="co"># Check the .tex file for errors</span></span></code></pre></div>
-      <h2 id="import-issues">Import Issues</h2>
-      <h3 id="comments-not-imported-from-word">Comments not imported
-      from Word</h3>
-      <p><strong>Causes:</strong> 1. Document uses older .doc format
-      (only .docx supported) 2. Comments are in review mode but not
-      finalized</p>
-      <p><strong>Solutions:</strong> 1. Save as .docx in Word 2.
-      Accept/reject track changes before importing if you want clean
-      text</p>
-      <h3 id="track-changes-garbled-or-missing">Track changes garbled or
-      missing</h3>
-      <p><strong>Cause:</strong> Complex nested changes or unsupported
-      Word features.</p>
-      <p><strong>Solution:</strong></p>
-      <div class="sourceCode" id="cb11"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> import document.docx <span class="at">--no-track-changes</span></span>
-<span id="cb11-2"><a href="#cb11-2" aria-hidden="true" tabindex="-1"></a><span class="co"># Then manually review the Word file</span></span></code></pre></div>
-      <h3 id="cannot-read-file-errors">“Cannot read file” errors</h3>
-      <p><strong>Causes:</strong> 1. File is open in Word (Windows locks
-      open files) 2. File path contains special characters 3. Corrupted
-      .docx file</p>
-      <p><strong>Solutions:</strong> 1. Close the file in Word 2. Rename
-      file to remove special characters 3. Try opening in Word and
-      re-saving</p>
-      <h2 id="comment-issues">Comment Issues</h2>
-      <h3 id="comments-not-appearing-in-word-export">Comments not
-      appearing in Word export</h3>
-      <p><strong>Cause:</strong> Comments marked as resolved are hidden
-      by default.</p>
-      <p><strong>Solutions:</strong></p>
-      <div class="sourceCode" id="cb12"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> comments file.md <span class="at">--resolved</span>  <span class="co"># Check resolved comments</span></span>
-<span id="cb12-2"><a href="#cb12-2" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> resolve file.md <span class="at">-a</span> <span class="at">-u</span>        <span class="co"># Unresolve all comments</span></span></code></pre></div>
-      <h3 id="reply-threading-not-working">Reply threading not
-      working</h3>
-      <p>Comments must be adjacent (no text between them) to thread in
-      Word.</p>
-      <p><strong>Works:</strong></p>
-      <div class="sourceCode" id="cb13"><pre
-      class="sourceCode markdown"><code class="sourceCode markdown"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a>text{&gt;&gt;Author1: comment&lt;&lt;}{&gt;&gt;Author2: reply&lt;&lt;}</span></code></pre></div>
-      <p><strong>Won’t thread:</strong></p>
-      <div class="sourceCode" id="cb14"><pre
-      class="sourceCode markdown"><code class="sourceCode markdown"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a>text{&gt;&gt;Author1: comment&lt;&lt;} more text {&gt;&gt;Author2: reply&lt;&lt;}</span></code></pre></div>
-      <h3 id="author-name-not-set">Author name not set</h3>
-      <div class="sourceCode" id="cb15"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> config user <span class="st">&quot;Your Name&quot;</span></span>
-<span id="cb15-2"><a href="#cb15-2" aria-hidden="true" tabindex="-1"></a><span class="co"># Or per-command:</span></span>
-<span id="cb15-3"><a href="#cb15-3" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> reply file.md <span class="at">--author</span> <span class="st">&quot;Your Name&quot;</span></span></code></pre></div>
-      <h2 id="cross-reference-issues">Cross-Reference Issues</h2>
-      <h3 id="figurestables-not-numbered">Figures/tables not
-      numbered</h3>
-      <p><strong>Causes:</strong> 1. pandoc-crossref not installed 2.
-      Labels not in correct format</p>
-      <p><strong>Correct format:</strong></p>
-      <div class="sourceCode" id="cb16"><pre
-      class="sourceCode markdown"><code class="sourceCode markdown"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a><span class="al">![Caption](image.png)</span>{#fig:label}</span>
-<span id="cb16-2"><a href="#cb16-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb16-3"><a href="#cb16-3" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> Col1 <span class="pp">|</span> Col2 <span class="pp">|</span></span>
-<span id="cb16-4"><a href="#cb16-4" aria-hidden="true" tabindex="-1"></a><span class="pp">|------|------|</span></span>
-<span id="cb16-5"><a href="#cb16-5" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> a    <span class="pp">|</span> b    <span class="pp">|</span></span>
-<span id="cb16-6"><a href="#cb16-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb16-7"><a href="#cb16-7" aria-hidden="true" tabindex="-1"></a>: Caption {#tbl:label}</span></code></pre></div>
-      <h3 id="references-show-instead-of-numbers">References show “??”
-      instead of numbers</h3>
-      <p><strong>Causes:</strong> 1. Label doesn’t exist 2. Typo in
-      reference 3. pandoc-crossref not running</p>
-      <p><strong>Debug:</strong></p>
-      <div class="sourceCode" id="cb17"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> refs           <span class="co"># List all labels</span></span>
-<span id="cb17-2"><a href="#cb17-2" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> refs <span class="at">--check</span>   <span class="co"># Find broken references</span></span></code></pre></div>
-      <h2 id="pdf-issues">PDF Issues</h2>
-      <h3 id="fonts-missing-or-wrong">Fonts missing or wrong</h3>
-      <p><strong>LaTeX errors about fonts:</strong></p>
-      <div class="sourceCode" id="cb18"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Install more fonts</span></span>
-<span id="cb18-2"><a href="#cb18-2" aria-hidden="true" tabindex="-1"></a><span class="fu">sudo</span> apt install texlive-fonts-extra  <span class="co"># Linux</span></span>
-<span id="cb18-3"><a href="#cb18-3" aria-hidden="true" tabindex="-1"></a><span class="co"># Or use standard fonts in rev.yaml:</span></span>
-<span id="cb18-4"><a href="#cb18-4" aria-hidden="true" tabindex="-1"></a><span class="ex">pdf:</span></span>
-<span id="cb18-5"><a href="#cb18-5" aria-hidden="true" tabindex="-1"></a>  <span class="ex">mainfont:</span> <span class="st">&quot;Times New Roman&quot;</span></span></code></pre></div>
-      <h3 id="images-not-appearing">Images not appearing</h3>
-      <p><strong>Causes:</strong> 1. Image path incorrect (relative to
-      project root) 2. Image format not supported by LaTeX</p>
-      <p><strong>Solutions:</strong> 1. Use relative paths:
-      <code>![](images/fig1.png)</code> 2. Convert to PNG/PDF: LaTeX
-      prefers PDF for vector graphics</p>
-      <h3 id="pdf-too-large">PDF too large</h3>
-      <div class="sourceCode" id="cb19"><pre
-      class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a><span class="co"># In rev.yaml</span></span>
-<span id="cb19-2"><a href="#cb19-2" aria-hidden="true" tabindex="-1"></a><span class="fu">pdf</span><span class="kw">:</span></span>
-<span id="cb19-3"><a href="#cb19-3" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">geometry</span><span class="kw">:</span><span class="at"> </span><span class="st">&quot;margin=0.75in&quot;</span><span class="co">  # Smaller margins</span></span>
-<span id="cb19-4"><a href="#cb19-4" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">fontsize</span><span class="kw">:</span><span class="at"> </span><span class="st">&quot;11pt&quot;</span><span class="co">           # Smaller font</span></span></code></pre></div>
-      <h2 id="performance-issues">Performance Issues</h2>
-      <h3 id="doi-lookup-slow">DOI lookup slow</h3>
-      <p>DOI validation queries external APIs. For large
-      bibliographies:</p>
-      <div class="sourceCode" id="cb20"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> doi check <span class="at">--no-lookup</span>  <span class="co"># Skip online validation</span></span></code></pre></div>
-      <h3 id="build-taking-too-long">Build taking too long</h3>
-      <div class="sourceCode" id="cb21"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Build only what you need</span></span>
-<span id="cb21-2"><a href="#cb21-2" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> build docx        <span class="co"># Skip PDF</span></span>
-<span id="cb21-3"><a href="#cb21-3" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> build <span class="at">--no-toc</span>    <span class="co"># Skip table of contents</span></span></code></pre></div>
-      <h2 id="encoding-issues">Encoding Issues</h2>
-      <h3 id="special-characters-corrupted">Special characters
-      corrupted</h3>
-      <p><strong>Cause:</strong> File encoding mismatch.</p>
-      <p><strong>Solutions:</strong> 1. Ensure files are UTF-8 encoded
-      2. In Word, save with “UTF-8” encoding option 3. Check your
-      editor’s encoding settings</p>
-      <h3 id="bibtex-entries-with-accents-fail">BibTeX entries with
-      accents fail</h3>
-      <p>Use LaTeX-style escapes or UTF-8:</p>
-      <div class="sourceCode" id="cb22"><pre
-      class="sourceCode bibtex"><code class="sourceCode bibtex"><span id="cb22-1"><a href="#cb22-1" aria-hidden="true" tabindex="-1"></a><span class="co">author = {M{\&quot;u}ller, Hans}</span></span>
-<span id="cb22-2"><a href="#cb22-2" aria-hidden="true" tabindex="-1"></a><span class="co"># or with UTF-8:</span></span>
-<span id="cb22-3"><a href="#cb22-3" aria-hidden="true" tabindex="-1"></a><span class="co">author = {Müller, Hans}</span></span></code></pre></div>
-      <h2 id="getting-help">Getting Help</h2>
-      <h3 id="debug-mode">Debug mode</h3>
-      <div class="sourceCode" id="cb23"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb23-1"><a href="#cb23-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> build <span class="at">--verbose</span> <span class="dv">2</span><span class="op">&gt;&amp;</span><span class="dv">1</span> <span class="kw">|</span> <span class="fu">tee</span> build.log</span></code></pre></div>
-      <h3 id="check-system-status">Check system status</h3>
-      <div class="sourceCode" id="cb24"><pre
-      class="sourceCode bash"><code class="sourceCode bash"><span id="cb24-1"><a href="#cb24-1" aria-hidden="true" tabindex="-1"></a><span class="fu">rev</span> doctor</span></code></pre></div>
-      <h3 id="report-issues">Report issues</h3>
-      <p>https://github.com/gcol33/docrev/issues</p>
-      <p>Include: - <code>rev --version</code> output -
-      <code>rev doctor</code> output - Minimal reproducible example</p>
-    </main>
-    <aside class="col-md-3 d-none d-md-block">
-      <nav id="toc" data-toggle="toc" aria-label="On this page">
-        <h2 class="h6">On this page</h2>
-        <div class="toc"><ul>
-<li><a href="#troubleshooting"
-id="toc-troubleshooting">Troubleshooting</a>
-<ul>
-<li><a href="#installation-issues"
-id="toc-installation-issues">Installation Issues</a>
-<ul>
-<li><a href="#pandoc-command-not-found"
-id="toc-pandoc-command-not-found">“pandoc: command not found”</a></li>
-<li><a href="#pandoc-crossref-command-not-found"
-id="toc-pandoc-crossref-command-not-found">“pandoc-crossref: command not
-found”</a></li>
-<li><a href="#latex-not-found-pdf-generation-fails"
-id="toc-latex-not-found-pdf-generation-fails">LaTeX not found (PDF
-generation fails)</a></li>
-</ul></li>
-<li><a href="#build-errors" id="toc-build-errors">Build Errors</a>
-<ul>
-<li><a href="#no-section-files-found"
-id="toc-no-section-files-found">“No section files found”</a></li>
-<li><a href="#failed-to-parse-rev.yaml"
-id="toc-failed-to-parse-rev.yaml">“Failed to parse rev.yaml”</a></li>
-<li><a href="#build-produces-empty-pdf"
-id="toc-build-produces-empty-pdf">Build produces empty PDF</a></li>
-</ul></li>
-<li><a href="#import-issues" id="toc-import-issues">Import Issues</a>
-<ul>
-<li><a href="#comments-not-imported-from-word"
-id="toc-comments-not-imported-from-word">Comments not imported from
-Word</a></li>
-<li><a href="#track-changes-garbled-or-missing"
-id="toc-track-changes-garbled-or-missing">Track changes garbled or
-missing</a></li>
-<li><a href="#cannot-read-file-errors"
-id="toc-cannot-read-file-errors">“Cannot read file” errors</a></li>
-</ul></li>
-<li><a href="#comment-issues" id="toc-comment-issues">Comment Issues</a>
-<ul>
-<li><a href="#comments-not-appearing-in-word-export"
-id="toc-comments-not-appearing-in-word-export">Comments not appearing in
-Word export</a></li>
-<li><a href="#reply-threading-not-working"
-id="toc-reply-threading-not-working">Reply threading not
-working</a></li>
-<li><a href="#author-name-not-set" id="toc-author-name-not-set">Author
-name not set</a></li>
-</ul></li>
-<li><a href="#cross-reference-issues"
-id="toc-cross-reference-issues">Cross-Reference Issues</a>
-<ul>
-<li><a href="#figurestables-not-numbered"
-id="toc-figurestables-not-numbered">Figures/tables not numbered</a></li>
-<li><a href="#references-show-instead-of-numbers"
-id="toc-references-show-instead-of-numbers">References show “??” instead
-of numbers</a></li>
-</ul></li>
-<li><a href="#pdf-issues" id="toc-pdf-issues">PDF Issues</a>
-<ul>
-<li><a href="#fonts-missing-or-wrong"
-id="toc-fonts-missing-or-wrong">Fonts missing or wrong</a></li>
-<li><a href="#images-not-appearing" id="toc-images-not-appearing">Images
-not appearing</a></li>
-<li><a href="#pdf-too-large" id="toc-pdf-too-large">PDF too
-large</a></li>
-</ul></li>
-<li><a href="#performance-issues"
-id="toc-performance-issues">Performance Issues</a>
-<ul>
-<li><a href="#doi-lookup-slow" id="toc-doi-lookup-slow">DOI lookup
-slow</a></li>
-<li><a href="#build-taking-too-long"
-id="toc-build-taking-too-long">Build taking too long</a></li>
-</ul></li>
-<li><a href="#encoding-issues" id="toc-encoding-issues">Encoding
-Issues</a>
-<ul>
-<li><a href="#special-characters-corrupted"
-id="toc-special-characters-corrupted">Special characters
-corrupted</a></li>
-<li><a href="#bibtex-entries-with-accents-fail"
-id="toc-bibtex-entries-with-accents-fail">BibTeX entries with accents
-fail</a></li>
-</ul></li>
-<li><a href="#getting-help" id="toc-getting-help">Getting Help</a>
-<ul>
-<li><a href="#debug-mode" id="toc-debug-mode">Debug mode</a></li>
-<li><a href="#check-system-status" id="toc-check-system-status">Check
-system status</a></li>
-<li><a href="#report-issues" id="toc-report-issues">Report
-issues</a></li>
-</ul></li>
-</ul></li>
-</ul></div>
-      </nav>
-    </aside>
-  </div>
-</div>
-<footer class="border-top py-3 mt-auto">
-  <div class="container d-flex justify-content-between align-items-center text-muted" style="font-size:.85rem">
-    <span>docrev 0.9.15</span>
-    <span>Built with <a href="https://pandoc.org" class="text-muted">pandoc</a></span>
-  </div>
-</footer>
-<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
-<script>
-(function () {
-  var html  = document.documentElement;
-  var sun   = document.getElementById('icon-sun');
-  var moon  = document.getElementById('icon-moon');
-  function apply(t) {
-    html.setAttribute('data-bs-theme', t);
-    sun.style.display  = t === 'dark' ? 'none' : '';
-    moon.style.display = t === 'dark' ? ''     : 'none';
-  }
-  apply(localStorage.getItem('docrev-theme') || 'light');
-  document.getElementById('theme-toggle').addEventListener('click', function () {
-    var next = html.getAttribute('data-bs-theme') === 'dark' ? 'light' : 'dark';
-    localStorage.setItem('docrev-theme', next);
-    apply(next);
-  });
-})();
-</script>
-</body>
-</html>