docrev 0.9.17 → 0.9.18

package/lib/schema.ts

@@ -91,6 +91,23 @@ export const revYamlSchema: Schema = {
       type: 'string',
       description: 'Journal profile name for formatting defaults and validation',
     },
+    'pandoc-args': {
+      type: 'array',
+      description: 'Extra pandoc args applied to every format build (e.g. --lua-filter=...). Format-specific lists are appended after these; --pandoc-arg CLI values are appended last.',
+      items: { type: 'string' },
+    },
+    output: {
+      type: 'object',
+      description: 'Per-format output filenames. Keys are format names (pdf, docx, tex, beamer, pptx); values are paths. Relative paths resolve under outputDir; absolute paths are honored as-is. Extension auto-added if missing. CLI `-o` overrides this map.',
+      properties: {
+        pdf: { type: 'string' },
+        docx: { type: 'string' },
+        tex: { type: 'string' },
+        beamer: { type: 'string' },
+        pptx: { type: 'string' },
+      },
+      additionalProperties: false,
+    },
     sections: {
       type: 'array',
       description: 'Ordered list of section files to include',
@@ -160,6 +177,11 @@ export const revYamlSchema: Schema = {
         toc: { type: 'boolean', default: false },
         header: { type: 'string' },
         footer: { type: 'string' },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for PDF builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },
@@ -170,6 +192,16 @@ export const revYamlSchema: Schema = {
         reference: { type: 'string', description: 'Reference document for styling' },
         keepComments: { type: 'boolean', default: true },
         toc: { type: 'boolean', default: false },
+        translateRawFigures: {
+          type: 'boolean',
+          default: true,
+          description: 'Auto-translate the common \\begin{figure}...\\end{figure} shape to portable ![](){#fig: ...} markdown so figures render in docx. Pandoc strips raw LaTeX in docx output silently otherwise.',
+        },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for DOCX builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },
@@ -178,6 +210,11 @@ export const revYamlSchema: Schema = {
       description: 'LaTeX output settings',
       properties: {
         standalone: { type: 'boolean', default: true },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for TeX builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },

package/mkdocs.yml

@@ -1,64 +1,64 @@
-site_name: docrev
-site_url: https://gillescolling.com/docrev
-site_description: CLI for writing documents in Markdown while collaborating with Word users.
-site_author: Gilles Colling
-repo_url: https://github.com/gcol33/docrev
-repo_name: gcol33/docrev
-
-theme:
-  name: material
-  palette:
-    - scheme: default
-      primary: custom
-      accent: custom
-      toggle:
-        icon: material/brightness-7
-        name: Switch to dark mode
-    - scheme: slate
-      primary: custom
-      accent: custom
-      toggle:
-        icon: material/brightness-4
-        name: Switch to light mode
-  font:
-    text: Roboto
-    code: Roboto Mono
-  features:
-    - navigation.tabs
-    - navigation.top
-    - navigation.instant
-    - search.highlight
-    - content.code.copy
-  icon:
-    repo: fontawesome/brands/github
-
-nav:
-  - Home: index.md
-  - Get Started: workflow.md
-  - Commands: commands.md
-  - Configuration: configuration.md
-  - Troubleshooting: troubleshooting.md
-
-markdown_extensions:
-  - pymdownx.highlight:
-      anchor_linenums: true
-  - pymdownx.superfences
-  - pymdownx.inlinehilite
-  - pymdownx.tabbed:
-      alternate_style: true
-  - admonition
-  - pymdownx.details
-  - attr_list
-  - md_in_html
-  - toc:
-      permalink: true
-
-extra_css:
-  - stylesheets/extra.css
-
-extra:
-  social:
-    - icon: fontawesome/brands/github
-      link: https://github.com/gcol33/docrev
-    - icon: fontawesome/brands/npm
-      link: https://www.npmjs.com/package/docrev
+site_name: docrev
+site_url: https://gillescolling.com/docrev
+site_description: CLI for writing documents in Markdown while collaborating with Word users.
+site_author: Gilles Colling
+repo_url: https://github.com/gcol33/docrev
+repo_name: gcol33/docrev
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: custom
+      accent: custom
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: custom
+      accent: custom
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  font:
+    text: Roboto
+    code: Roboto Mono
+  features:
+    - navigation.tabs
+    - navigation.top
+    - navigation.instant
+    - search.highlight
+    - content.code.copy
+  icon:
+    repo: fontawesome/brands/github
+
+nav:
+  - Home: index.md
+  - Get Started: workflow.md
+  - Commands: commands.md
+  - Configuration: configuration.md
+  - Troubleshooting: troubleshooting.md
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.superfences
+  - pymdownx.inlinehilite
+  - pymdownx.tabbed:
+      alternate_style: true
+  - admonition
+  - pymdownx.details
+  - attr_list
+  - md_in_html
+  - toc:
+      permalink: true
+
+extra_css:
+  - stylesheets/extra.css
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/gcol33/docrev
+    - icon: fontawesome/brands/npm
+      link: https://www.npmjs.com/package/docrev

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docrev",
-  "version": "0.9.17",
+  "version": "0.9.18",
   "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
   "type": "module",
   "types": "dist/lib/types.d.ts",

package/site/assets/extra.css

@@ -0,0 +1,208 @@
+/* ── Base ──────────────────────────────────────────────── */
+html, body {
+  height: 100%;
+}
+
+body {
+  background-color: #F5F6F8;
+  color: #3E3F3A;
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+  padding-top: 4rem;
+  font-family: "Roboto", -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+}
+
+.container { flex: 1; }
+footer { margin-top: auto; }
+
+/* ── Navbar (pkgdown-style subtle tint, not bg-primary) ── */
+.navbar {
+  background: color-mix(in oklab, color-mix(in oklab, var(--bs-body-bg) 95%, var(--bs-primary)) 95%, var(--bs-body-color));
+  border-bottom: 1px solid #DFD7CA;
+  line-height: initial;
+}
+
+.navbar .nav-link.active {
+  font-weight: 600;
+  color: var(--bs-primary) !important;
+}
+
+/* ── Links ─────────────────────────────────────────────── */
+a { color: #325D88; }
+a:hover { color: #1E3D5C; }
+
+/* ── Headings ──────────────────────────────────────────── */
+h1 { font-size: 2rem; font-weight: 600; margin-bottom: 1rem; }
+h2 {
+  font-size: 1.4rem; font-weight: 600;
+  margin-top: 2rem; margin-bottom: .65rem;
+  padding-bottom: .3rem;
+  border-bottom: 1px solid #DFD7CA;
+}
+h3 { font-size: 1.1rem; font-weight: 600; margin-top: 1.5rem; }
+h4 { font-size: 1rem;   font-weight: 600; margin-top: 1.2rem; }
+
+/* ── Code ──────────────────────────────────────────────── */
+pre, div.sourceCode {
+  background-color: #EEEEED;
+  border: 1px solid #DFD7CA;
+  border-radius: .375rem;
+  padding: .9rem 1.1rem;
+  font-size: .85rem;
+  overflow-x: auto;
+  margin: 1em 0;
+}
+
+code {
+  background-color: #EEEEED;
+  color: #3E3F3A;
+  border-radius: .25rem;
+  padding: .1em .35em;
+  font-size: .875em;
+}
+
+pre code, div.sourceCode code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+  font-size: inherit;
+  color: inherit;
+}
+
+div.sourceCode { padding: 0; }
+div.sourceCode pre { border: none; margin: 0; }
+
+/* ── Tables ────────────────────────────────────────────── */
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1em 0;
+  font-size: .9rem;
+}
+
+thead th {
+  background-color: #DFD7CA;
+  color: #3E3F3A;
+  font-weight: 600;
+  padding: .5rem .75rem;
+  border-bottom: 2px solid #c8c0b4;
+  text-align: left;
+}
+
+td, th { padding: .4rem .75rem; border-bottom: 1px solid #e8e2d8; }
+tbody tr:hover { background-color: rgba(223,215,202,.2); }
+
+/* ── TOC sidebar ───────────────────────────────────────── */
+aside#toc, aside .toc, aside nav.toc { font-size: .875rem; }
+
+aside h2.h6 {
+  text-transform: uppercase;
+  font-size: .68rem;
+  letter-spacing: .07em;
+  color: #6c757d;
+  font-weight: 600;
+  margin-bottom: .5rem;
+  border: none;
+  padding: 0;
+}
+
+aside .toc, aside #TOC {
+  position: sticky;
+  top: 5rem;
+  max-height: calc(100vh - 6rem);
+  overflow-y: auto;
+}
+
+aside ul {
+  list-style: none;
+  padding-left: .9rem;
+  margin: 0;
+}
+aside > nav > .toc > ul,
+aside .toc > ul { padding-left: 0; }
+
+aside li { margin: .1rem 0; }
+
+aside a {
+  color: #6c757d;
+  text-decoration: none;
+  display: block;
+  line-height: 1.55;
+}
+aside a:hover { color: #325D88; }
+
+/* ── Home page cards ───────────────────────────────────── */
+.doc-card {
+  border: 1px solid #DFD7CA;
+  border-radius: .375rem;
+  padding: 1.1rem 1.25rem;
+  height: 100%;
+  background: #fff;
+  transition: border-color .15s, box-shadow .15s;
+}
+.doc-card:hover {
+  border-color: #325D88;
+  box-shadow: 0 2px 8px rgba(50,93,136,.1);
+}
+.doc-card h5 { font-size: 1rem; font-weight: 600; margin-bottom: .4rem; }
+.doc-card p  { font-size: .875rem; color: #6c757d; margin-bottom: .6rem; }
+.doc-card a.stretched-link::after { z-index: 1; }
+
+/* ── Badges row ────────────────────────────────────────── */
+.badge-row { margin-bottom: 1rem; line-height: 2; }
+.badge-row img { margin-right: .25rem; }
+
+/* ── ── ── DARK MODE ── ── ── ──────────────────────────── */
+
+[data-bs-theme="dark"] body  { background-color: #343739; color: #DFD7CA; }
+
+[data-bs-theme="dark"] .navbar {
+  background: color-mix(in oklab, color-mix(in oklab, #343739 92%, var(--bs-primary)) 95%, #DFD7CA);
+  border-bottom-color: #495057;
+}
+
+[data-bs-theme="dark"] a       { color: #7ba8d0; }
+[data-bs-theme="dark"] a:hover { color: #a5c4e8; }
+
+[data-bs-theme="dark"] .navbar .nav-link.active { color: #7ba8d0 !important; }
+
+[data-bs-theme="dark"] h1,
+[data-bs-theme="dark"] h2,
+[data-bs-theme="dark"] h3,
+[data-bs-theme="dark"] h4 { color: #DFD7CA; }
+
+[data-bs-theme="dark"] h2 { border-color: #495057; }
+
+[data-bs-theme="dark"] pre,
+[data-bs-theme="dark"] div.sourceCode {
+  background-color: #2C2F31;
+  border-color: #495057;
+  color: #DFD7CA;
+}
+
+[data-bs-theme="dark"] code {
+  background-color: #2C2F31;
+  color: #DFD7CA;
+}
+
+[data-bs-theme="dark"] div.sourceCode span[class] { color: #DFD7CA !important; }
+
+[data-bs-theme="dark"] thead th {
+  background-color: #3d4043;
+  color: #DFD7CA;
+  border-color: #495057;
+}
+[data-bs-theme="dark"] td,
+[data-bs-theme="dark"] th  { border-color: #3d4043; }
+[data-bs-theme="dark"] tbody tr:hover { background-color: rgba(73,80,87,.3); }
+
+[data-bs-theme="dark"] aside a       { color: #8e9499; }
+[data-bs-theme="dark"] aside a:hover { color: #7ba8d0; }
+
+[data-bs-theme="dark"] .doc-card {
+  background: #2C2F31;
+  border-color: #495057;
+}
+[data-bs-theme="dark"] .doc-card:hover { border-color: #7ba8d0; }
+[data-bs-theme="dark"] .doc-card p     { color: #8e9499; }