tracer html output of links to other formats

Author: dragonstyle

src/command/render/render-files.ts

@@ -89,7 +89,6 @@ import {
 } from "../../core/timing.ts";
 import { satisfies } from "semver/mod.ts";
 import { quartoConfig } from "../../core/quarto.ts";
-import { registerProjectType } from "../../project/types/project-types.ts";
 
 export async function renderExecute(
   context: RenderContext,

src/command/render/render.ts

@@ -208,6 +208,7 @@ export async function renderPandoc(
         pandocOptions,
         htmlPostProcessors,
         htmlFinalizers,
+        renderedFormats,
       );
 
       // Compute the path to the output file
@@ -415,6 +416,7 @@ async function runHtmlPostprocessors(
   options: PandocOptions,
   htmlPostprocessors: Array<HtmlPostProcessor>,
   htmlFinalizers: Array<(doc: Document) => Promise<void>>,
+  renderedFormats: RenderedFormat[],
 ): Promise<HtmlPostProcessResult> {
   const postProcessResult: HtmlPostProcessResult = {
     resources: [],
@@ -430,7 +432,14 @@ async function runHtmlPostprocessors(
       const doc = await parseHtml(htmlInput);
       for (let i = 0; i < htmlPostprocessors.length; i++) {
         const postprocessor = htmlPostprocessors[i];
-        const result = await postprocessor(doc, inputMetadata, inputTraits);
+        const result = await postprocessor(
+          doc,
+          {
+            inputMetadata,
+            inputTraits,
+            renderedFormats  
+          }
+        );
 
         postProcessResult.resources.push(...result.resources);
         postProcessResult.supporting.push(...result.supporting);

src/command/render/types.ts

@@ -64,8 +64,11 @@ export interface PandocInputTraits {
 
 export type HtmlPostProcessor = (
   doc: Document,
-  inputMedata: Metadata,
-  inputTraits: PandocInputTraits,
+  options: {
+    inputMetadata: Metadata;
+    inputTraits: PandocInputTraits;
+    renderedFormats: RenderedFormat[];
+  },
 ) => Promise<HtmlPostProcessResult>;
 
 export interface HtmlPostProcessResult {

src/format/html/format-html-bootstrap.ts

@@ -18,6 +18,7 @@ import {
   kLinkCitations,
   kQuartoTemplateParams,
   kSectionDivs,
+  kTitle,
   kTocDepth,
   kTocLocation,
 } from "../../config/constants.ts";
@@ -52,6 +53,7 @@ import {
   HtmlPostProcessor,
   HtmlPostProcessResult,
   PandocInputTraits,
+  RenderedFormat,
 } from "../../command/render/types.ts";
 import { processDocumentAppendix } from "./format-html-appendix.ts";
 import {
@@ -63,6 +65,7 @@ import {
 } from "./format-html-title.ts";
 import { kTemplatePartials } from "../../command/render/template.ts";
 import { TempContext } from "../../core/temp-types.ts";
+import { isHtmlOutput } from "../../config/format.ts";
 
 export function formatPageLayout(format: Format) {
   return format.metadata[kPageLayout] as string || kPageLayoutArticle;
@@ -214,8 +217,11 @@ function bootstrapHtmlPostprocessor(
 ): HtmlPostProcessor {
   return async (
     doc: Document,
-    _inputMedata: Metadata,
-    inputTraits: PandocInputTraits,
+    options: {
+      inputMetadata: Metadata;
+      inputTraits: PandocInputTraits;
+      renderedFormats: RenderedFormat[];
+    },
   ): Promise<HtmlPostProcessResult> => {
     // use display-7 style for title
     const title = doc.querySelector("header > .title");
@@ -372,14 +378,30 @@ function bootstrapHtmlPostprocessor(
     ) {
       await processDocumentAppendix(
         input,
-        inputTraits,
+        options.inputTraits,
         format,
         flags,
         doc,
         offset,
       );
     }
 
+    // Inject links to other formats if there is another
+    // format that of this file that has been rendered
+    if (options.renderedFormats.length > 1) {
+      const el = doc.createElement("div");
+      for (const renderedFormat of options.renderedFormats) {
+        if (!isHtmlOutput(renderedFormat.format.pandoc, true)) {
+          const link = doc.createElement("a");
+          link.setAttribute("href", renderedFormat.path);
+          link.innerHTML = `${renderedFormat.format.pandoc.to}`;
+          el.appendChild(link);
+          el.appendChild(doc.createElement("br"));
+        }
+      }
+      doc.body.appendChild(el);
+    }
+
     // no resource refs
     return Promise.resolve({ resources, supporting: [] });
   };