💬 Support quote environments in latex

.changeset/itchy-rules-act.md

@@ -0,0 +1,5 @@
+---
+'tex-to-myst': patch
+---
+
+Support quote and displayquote environments as well as epigraph macro

packages/tex-to-myst/src/parser.ts

@@ -26,6 +26,7 @@ import { FOOTNOTE_HANDLERS } from './footnotes.js';
 import { SIUNITX_HANDLERS } from './siunitx.js';
 import { CHEM_HANDLERS } from './chem.js';
 import { ALGORITHM_HANDLERS } from './algorithms.js';
+import { QUOTE_HANDLERS } from './quotes.js';
 
 const DEFAULT_HANDLERS: Record<string, Handler> = {
   ...BASIC_TEXT_HANDLERS,
@@ -36,6 +37,7 @@ const DEFAULT_HANDLERS: Record<string, Handler> = {
   ...MATH_HANDLERS,
   ...LIST_HANDLERS,
   ...LINK_HANDLERS,
+  ...QUOTE_HANDLERS,
   ...CITATION_HANDLERS,
   ...CHARACTER_HANDLERS,
   ...SECTION_HANDLERS,

packages/tex-to-myst/src/quotes.ts

@@ -0,0 +1,35 @@
+import type { Handler } from './types.js';
+import { getArguments } from './utils.js';
+
+export const QUOTE_HANDLERS: Record<string, Handler> = {
+  env_quote(node, state) {
+    state.closeParagraph();
+    state.openNode('blockquote');
+    state.renderChildren(node);
+    state.closeNode();
+  },
+  env_displayquote(node, state) {
+    state.closeParagraph();
+    state.openNode('blockquote');
+    state.renderChildren(node);
+    state.closeNode();
+  },
+  macro_epigraph(node, state) {
+    const [quote, author] = getArguments(node, 'group');
+    if (author) {
+      state.openNode('container', { kind: 'quote' });
+    }
+    state.openNode('blockquote');
+    state.openParagraph();
+    state.renderChildren(quote);
+    state.closeParagraph();
+    state.closeNode();
+    if (!author) return;
+    state.openNode('caption');
+    state.openParagraph();
+    state.renderChildren(author);
+    state.closeParagraph();
+    state.closeNode();
+    state.closeNode(); // the container
+  },
+};

packages/tex-to-myst/src/tex.ts

@@ -72,6 +72,7 @@ const macros: Record<string, number> = {
   affil: 1,
   affiliation: 1,
   framebox: 1,
+  epigraph: 2,
   tnote: 1,
   ['table*']: 1,
   arraystretch: 1,

packages/tex-to-myst/tests/cases.spec.ts

@@ -48,6 +48,7 @@ const files = [
   'algorithm.yml',
   'macros.yml',
   'input.yml',
+  'quote.yml',
 ];
 
 const only = ''; // Can set this to a test title

packages/tex-to-myst/tests/quote.yml

@@ -0,0 +1,51 @@
+title: Quotes
+cases:
+  - title: Quote
+    tex: |-
+      \begin{quote}
+      This is a quote
+      \end{quote}
+    tree:
+      type: root
+      children:
+        - type: blockquote
+          children:
+            - type: paragraph
+              children:
+                - type: text
+                  value: This is a quote
+  - title: displayquote
+    tex: |-
+      \begin{displayquote}
+      Sé que tengo un ego del tamaño de un planeta pequeño, pero incluso yo a veces me equivoco
+      \end{displayquote}
+    tree:
+      type: root
+      children:
+        - type: blockquote
+          children:
+            - type: paragraph
+              children:
+                - type: text
+                  value: Sé que tengo un ego del tamaño de un planeta pequeño, pero incluso yo a veces me equivoco
+  - title: epigraph
+    tex: |-
+      \epigraph{All human things are subject to decay, and when fate summons, Monarchs must obey}{Mac Flecknoe}
+    tree:
+      type: root
+      children:
+        - type: container
+          kind: quote
+          children:
+            - type: blockquote
+              children:
+                - type: paragraph
+                  children:
+                    - type: text
+                      value: All human things are subject to decay, and when fate summons, Monarchs must obey
+            - type: caption
+              children:
+                - type: paragraph
+                  children:
+                    - type: text
+                      value: Mac Flecknoe