📦 Upgrade v0.9.5, Footnotes, Localize ArticlePage

theme/app/components/ArticlePage.tsx

@@ -0,0 +1,94 @@
+import { ReferencesProvider, useProjectManifest } from '@myst-theme/providers';
+import {
+  Bibliography,
+  ContentBlocks,
+  FooterLinksBlock,
+  FrontmatterParts,
+  BackmatterParts,
+  Footnotes,
+  extractKnownParts,
+} from '@myst-theme/site';
+import type { PageLoader } from '@myst-theme/common';
+import { copyNode, type GenericParent } from 'myst-common';
+import { SourceFileKind } from 'myst-spec-ext';
+import {
+  ExecuteScopeProvider,
+  BusyScopeProvider,
+  NotebookToolbar,
+  ConnectionStatusTray,
+  ErrorTray,
+  useComputeOptions,
+} from '@myst-theme/jupyter';
+import { FrontmatterBlock } from '@myst-theme/frontmatter';
+import type { SiteAction } from 'myst-config';
+
+/**
+ * Combines the project downloads and the export options
+ */
+function combineDownloads(
+  siteDownloads: SiteAction[] | undefined,
+  pageFrontmatter: PageLoader['frontmatter']
+) {
+  if (pageFrontmatter.downloads) {
+    return pageFrontmatter.downloads;
+  }
+  // No downloads on the page, combine the exports if they exist
+  if (siteDownloads) {
+    return [...(pageFrontmatter.exports ?? []), ...siteDownloads];
+  }
+  return pageFrontmatter.exports;
+}
+
+export function ArticlePage({
+  article,
+  hide_all_footer_links,
+  hideKeywords,
+}: {
+  article: PageLoader;
+  hide_all_footer_links?: boolean;
+  hideKeywords?: boolean;
+}) {
+  const manifest = useProjectManifest();
+  const compute = useComputeOptions();
+
+  const { hide_title_block, hide_footer_links } = (article.frontmatter as any)?.options ?? {};
+  const downloads = combineDownloads(manifest?.downloads, article.frontmatter);
+  const tree = copyNode(article.mdast);
+  const keywords = article.frontmatter?.keywords ?? [];
+  const parts = extractKnownParts(tree);
+
+  return (
+    <ReferencesProvider
+      references={{ ...article.references, article: article.mdast }}
+      frontmatter={article.frontmatter}
+    >
+      <BusyScopeProvider>
+        <ExecuteScopeProvider enable={compute?.enabled ?? false} contents={article}>
+          {!hide_title_block && (
+            <FrontmatterBlock
+              kind={article.kind}
+              frontmatter={{ ...article.frontmatter, downloads }}
+              className="pt-5 mb-8"
+            />
+          )}
+          {compute?.enabled &&
+            compute.features.notebookCompute &&
+            article.kind === SourceFileKind.Notebook && <NotebookToolbar showLaunch />}
+          {compute?.enabled && article.kind === SourceFileKind.Article && (
+            <ErrorTray pageSlug={article.slug} />
+          )}
+          <div id="skip-to-article" />
+          <FrontmatterParts parts={parts} keywords={keywords} hideKeywords={hideKeywords} />
+          <ContentBlocks pageKind={article.kind} mdast={tree as GenericParent} />
+          <BackmatterParts parts={parts} />
+          <Footnotes />
+          <Bibliography />
+          <ConnectionStatusTray />
+          {!hide_footer_links && !hide_all_footer_links && (
+            <FooterLinksBlock links={article.footer} />
+          )}
+        </ExecuteScopeProvider>
+      </BusyScopeProvider>
+    </ReferencesProvider>
+  );
+}

theme/app/routes/$project.($slug).tsx

@@ -7,6 +7,7 @@ import {
   DocumentOutline,
   ContentBlocks,
   Bibliography,
+  Footnotes,
 } from '@myst-theme/site';
 import { FrontmatterBlock } from '@myst-theme/frontmatter';
 import { ComputeOptionsProvider, ThebeLoaderAndServer } from '@myst-theme/jupyter';
@@ -42,6 +43,7 @@ function ArticlePage({ article }: { article: PageLoader }) {
     <>
       <div id="skip-to-article" />
       <ContentBlocks mdast={article.mdast as GenericParent} />
+      <Footnotes />
       <Bibliography />
       <FooterLinksBlock links={article.footer} />
     </>

theme/app/routes/_index.tsx

@@ -1,12 +1,13 @@
 import type { LinksFunction, LoaderFunction, V2_MetaFunction } from '@remix-run/node';
 import type { PageLoader } from '@myst-theme/common';
-import { getMetaTagsForArticle, KatexCSS, ArticlePage } from '@myst-theme/site';
+import { getMetaTagsForArticle, KatexCSS } from '@myst-theme/site';
 import { ComputeOptionsProvider, ThebeLoaderAndServer } from '@myst-theme/jupyter';
 import { getPage } from '~/utils/loaders.server';
 import { useLoaderData } from '@remix-run/react';
 import { ArticleAndNavigation, HeaderSection, NavigationAndFooter } from '../components/Page';
 import { Error404 } from '../components/Error404';
 import { ProjectProvider } from '@myst-theme/providers';
+import { ArticlePage } from '~/components/ArticlePage';
 
 export const meta: V2_MetaFunction = ({ data, location }) => {
   if (!data) return [];

theme/app/routes/overview.($slug).tsx

@@ -1,13 +1,14 @@
 import type { LoaderFunction, V2_MetaFunction } from '@remix-run/node';
 import type { PageLoader } from '@myst-theme/common';
-import { ArticlePage, getMetaTagsForArticle } from '@myst-theme/site';
+import { getMetaTagsForArticle } from '@myst-theme/site';
 import { ComputeOptionsProvider, ThebeLoaderAndServer } from '@myst-theme/jupyter';
 import { getPage } from '../utils/loaders.server';
 import { NavLink, useLoaderData } from '@remix-run/react';
 import { ArticleAndNavigation, NavigationAndFooter } from '../components/Page';
 import { BaseUrlProvider, ProjectProvider, useSiteManifest } from '@myst-theme/providers';
 import classNames from 'classnames';
 import { Error404 } from '../components/Error404';
+import { ArticlePage } from '~/components/ArticlePage';
 
 const baseurl = 'overview';