@amermathsoc/texml-to-html 19.0.1 → 20.0.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [20.0.0](https://github.com/AmerMathSoc/texml-to-html/compare/v19.0.1...v20.0.0) (2026-01-08)
+
+
+### ⚠ BREAKING CHANGES
+
+* JSON metadata for related articles has changed (#493).
+
+### Features
+
+* revise related-article handling ([3489681](https://github.com/AmerMathSoc/texml-to-html/commit/3489681fd3db9f8941bdfd8a4e4c66d1d0920dba)), closes [#493](https://github.com/AmerMathSoc/texml-to-html/issues/493)
+
 ## [19.0.1](https://github.com/AmerMathSoc/texml-to-html/compare/v19.0.0...v19.0.1) (2026-01-07)
 
 

package/lib/elements/article-metadata-json.js

@@ -95,13 +95,12 @@ export function generateArticleJson(articleMetaNode) {
     articleMetaJson.identifiers.amsref = articleMetaNode.querySelector('article-citation')?.textContent.trim();
 
     // related articles
-    articleMetaNode.querySelectorAll('related-article').forEach(relatedArticle => {
-        const pii = relatedArticle.querySelector('pub-id[pub-id-type="pii"]').textContent;
-        const link = relatedArticle.querySelector('ext-link');
-        articleMetaJson.relatedArticles[pii] = {
+    articleMetaJson.relatedArticles = articleMetaNode.querySelectorAll('related-article').map(relatedArticle => {
+        return {
             type: relatedArticle.getAttribute('related-article-type'),
-            url: link.getAttribute('ext-link'),
-            linkText: link.textContent,
+            html: relatedArticle.getAttribute('xml:lang') ?
+                `<span lang="${relatedArticle.getAttribute('xml:lang')}">${this.passthroughIntoHTMLString(relatedArticle)}</span>`
+                : this.passthroughIntoHTMLString(relatedArticle),
         };
     });
 
@@ -130,11 +129,11 @@ export function generateArticleJson(articleMetaNode) {
 
     // journal volume info
     articleMetaJson.volumeInfo = {
-        volume: articleMetaNode.querySelector('volume')?.textContent,
-        issue: articleMetaNode.querySelector('issue')?.textContent,
-        pageFirst: articleMetaNode.querySelector('fpage')?.textContent,
-        pageLast: articleMetaNode.querySelector('lpage')?.textContent,
-        pageRange: articleMetaNode.querySelector('page-range')?.textContent,
+        volume: articleMetaNode.querySelector('article-meta > volume')?.textContent,
+        issue: articleMetaNode.querySelector('article-meta > issue')?.textContent,
+        pageFirst: articleMetaNode.querySelector('article-meta > fpage')?.textContent,
+        pageLast: articleMetaNode.querySelector('article-meta > lpage')?.textContent,
+        pageRange: articleMetaNode.querySelector('article-meta > page-range')?.textContent,
     }
 
     // categories
@@ -164,4 +163,3 @@ export function generateArticleJson(articleMetaNode) {
 
     return JSON.stringify(articleMetaJson, null, 4);
 };
-

package/lib/elements/sec.js

@@ -82,7 +82,10 @@ export default function (htmlParentNode, xmlnode) {
   if (tagName === 'book-app-group') {
     section.setAttribute('data-ams-doc', 'app-group');
   }
-  if (tagName === 'book-app' && !xmlnode.parentNode.closest('book-app')) section.setAttribute('role', 'doc-appendix'); // TODO: revisit after AmerMathSoc/texml#223
+  if (tagName === 'book-app' && !xmlnode.parentNode.closest('book-app')) {
+    section.setAttribute('role', 'doc-appendix'); // TODO: revisit after AmerMathSoc/texml#223
+    // section.setAttribute('data-ams-doc-level', '0')
+    }
 
   this.createHeading(section, xmlnode);
   this.passThrough(section, xmlnode);

package/lib/transformer.js

@@ -143,7 +143,14 @@ export class Transformer {
             'app-group',
             'book-title-group',
             'private-char',
-            'article-title' // NOTE: maybe map to label (like title)
+            'article-title', // NOTE: maybe map to label (like title)
+            'source',
+            'issn',
+            'volume',
+            'issue',
+            'year',
+            'fpage',
+            'lpage',
         ].forEach(mapTag.bind(null, this.passThrough));
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amermathsoc/texml-to-html",
-  "version": "19.0.1",
+  "version": "20.0.0",
   "type": "module",
   "description": "A NodeJS library for converting AMS-style JATS XML to HTML",
   "scripts": {

package/test/article-alttitle-meta-snapshot.json

@@ -16,7 +16,7 @@
         "amsref": "",
         "basename": "journalIdundefined"
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [
         {
             "name": "publisher-name",

package/test/article-meta-snapshot.json

@@ -17,13 +17,16 @@
         "amsref": "",
         "basename": "journalIdmanuscriptId"
     },
-    "relatedArticles": {
-        "S0894-0347-2023-01025-2": {
+    "relatedArticles": [
+        {
             "type": "erratum-forward",
-            "url": "https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/",
-            "linkText": "J. Amer. Math. Soc. 36 (2023), 1305-1308."
+            "html": "<a href=\"https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/\">J. Amer. Math. Soc. 36 (2023), 1305-1308.</a>"
+        },
+        {
+            "type": "original-language",
+            "html": "<span lang=\"ru-cyrl\"><span data-ams-doc=\"stringname\">Х. А. Хачатрян</span><ams-x>,</ams-x> <span data-ams-doc=\"stringname\">А. С. Петросян</span><ams-x>,</ams-x> Однопараметрическое семейство неограниченных положительных решений для одного класса нелинейных трехмерных интегральных уравнений с оператором типа Гаммерштейна–Немыцкого<ams-x>,</ams-x> Труды Московского математического общества <ams-x>(</ams-x>0134-8663<ams-x>)</ams-x> 84<ams-x>(</ams-x>1<ams-x>)</ams-x> <ams-x>(</ams-x>2023<ams-x>)</ams-x> 37<ams-x>–</ams-x>53<ams-x>.</ams-x> URL <a href=\"http://mi.mathnet.ru/mmo681\">http://mi.mathnet.ru/mmo681</a></span>"
         }
-    },
+    ],
     "publishers": [
         {
             "name": "publisher-name",

package/test/article-nometa-meta-snapshot.json

@@ -7,7 +7,7 @@
         "uri": {},
         "basename": "noti20-1Cundefined"
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {
         "authors": [

package/test/article.xml

@@ -79,8 +79,9 @@
             <self-uri xlink:href="href" content-type="pdf"/>
             <related-article related-article-type="erratum-forward">
                 <pub-id pub-id-type="pii">S0894-0347-2023-01025-2</pub-id>
-                <ext-link ext-link="https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/">J. Amer. Math. Soc. 36 (2023), 1305-1308.</ext-link>
+                <ext-link xlink:href="https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/">J. Amer. Math. Soc. 36 (2023), 1305-1308.</ext-link>
             </related-article>
+            <related-article hreflang="ru-cyrl" related-article-type="original-language" xlink:href="http://mi.mathnet.ru/mmo681" xml:lang="ru-cyrl"><string-name>Х. А. Хачатрян</string-name><x>,</x> <string-name>А. С. Петросян</string-name><x>,</x> <article-title>Однопараметрическое семейство неограниченных положительных решений для одного класса нелинейных трехмерных интегральных уравнений с оператором типа Гаммерштейна–Немыцкого</article-title><x>,</x> <source>Труды Московского математического общества</source> <x>(</x><issn>0134-8663</issn><x>)</x> <volume>84</volume><x>(</x><issue>1</issue><x>)</x> <x>(</x><year>2023</year><x>)</x> <fpage>37</fpage><x>–</x><lpage>53</lpage><x>.</x> URL <ext-link hreflang="ru-cyrl" xlink:href="http://mi.mathnet.ru/mmo681">http://mi.mathnet.ru/mmo681</ext-link></related-article>
             <article-citation/>
             <kwd-group>
                 <kwd>keyword</kwd>

package/test/snapshots/article--alttitle.html

@@ -16,7 +16,7 @@
         "basename": "journalIdundefined",
         "amsref": ""
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [
         {
             "name": "publisher-name",

package/test/snapshots/article--nometa.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": "noti20-1Cundefined"
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {
         "authors": [

package/test/snapshots/article.html

@@ -18,13 +18,16 @@
         "basename": "journalIdmanuscriptId",
         "amsref": ""
     },
-    "relatedArticles": {
-        "S0894-0347-2023-01025-2": {
+    "relatedArticles": [
+        {
             "type": "erratum-forward",
-            "url": "https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/",
-            "linkText": "J. Amer. Math. Soc. 36 (2023), 1305-1308."
+            "html": "<a href=\"https://www.ams.org/jams/2023-36-04/S0894-0347-2023-01025-2/\">J. Amer. Math. Soc. 36 (2023), 1305-1308.</a>"
+        },
+        {
+            "type": "original-language",
+            "html": "<span lang=\"ru-cyrl\"><span data-ams-doc=\"stringname\">Х. А. Хачатрян</span><ams-x>,</ams-x> <span data-ams-doc=\"stringname\">А. С. Петросян</span><ams-x>,</ams-x> Однопараметрическое семейство неограниченных положительных решений для одного класса нелинейных трехмерных интегральных уравнений с оператором типа Гаммерштейна–Немыцкого<ams-x>,</ams-x> Труды Московского математического общества <ams-x>(</ams-x>0134-8663<ams-x>)</ams-x> 84<ams-x>(</ams-x>1<ams-x>)</ams-x> <ams-x>(</ams-x>2023<ams-x>)</ams-x> 37<ams-x>–</ams-x>53<ams-x>.</ams-x> URL <a href=\"http://mi.mathnet.ru/mmo681\">http://mi.mathnet.ru/mmo681</a></span>"
         }
-    },
+    ],
     "publishers": [
         {
             "name": "publisher-name",

package/test/snapshots/texml-tests/LGR.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT1.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT1ti.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT1tt.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT2.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT4.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/OT6.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/T1.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/T4.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/T5.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/Ucharcat.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/accent.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/algorithm.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/algorithmic.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/algpseudocode.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/ams_measure.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsart.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {
         "authors": [

package/test/snapshots/texml-tests/amscyr.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsfonts.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsrefs.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsthm-swap.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsthm.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/amsviet.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/appendix.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {
         "authors": [

package/test/snapshots/texml-tests/array.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/article.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {
         "authors": [

package/test/snapshots/texml-tests/arxiv.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/arydshln.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/aufm.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/begincsname.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/boldline.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/boxes.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/caption.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/ccicons.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/cite.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/citesort.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/cleveref.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/colortbl.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/combinetoks.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/constants.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/csstring.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},

package/test/snapshots/texml-tests/detokenize.html

@@ -8,7 +8,7 @@
         "uri": {},
         "basename": null
     },
-    "relatedArticles": {},
+    "relatedArticles": [],
     "publishers": [],
     "contributors": {},
     "permissions": {},