]> Lady’s Gitweb - Beorn/blobdiff - build.js
Better feed language handling
[Beorn] / build.js
index 743de647467f963c661e95eb092d75f18a6fd3bf..024698acde71ebcb1fc22b8dd789320ec8cf0425 100755 (executable)
--- a/build.js
+++ b/build.js
@@ -54,6 +54,7 @@ const AWOL = "http://bblfish.net/work/atom-owl/2006-06-06/";
 const DC11 = "http://purl.org/dc/elements/1.1/";
 const FOAF = "http://xmlns.com/foaf/0.1/";
 const RDF = "http://www.w3.org/1999/02/22-rdf-syntax-ns#";
+const RDFS = "http://www.w3.org/2000/01/rdf-schema#";
 const SIOC = "http://rdfs.org/sioc/ns#";
 const XML = "http://www.w3.org/XML/1998/namespace";
 const XHTML = "http://www.w3.org/1999/xhtml";
@@ -201,55 +202,17 @@ const applyMetadata = (node, metadata) => {
     if (hasExpandedName(documentElement, XHTML, "html")) {
       // This is an XHTML template.
       const LMN = Lemon.bind({ document });
-      const head = Array.from(documentElement.childNodes).find(($) =>
-        hasExpandedName($, XHTML, "head")
-      ) ?? documentElement.insertBefore(
-        LMN.head``,
-        documentElement.childNodes.item(0),
-      );
-      const titleElement = Array.from(head.childNodes).find(($) =>
-        hasExpandedName($, XHTML, "title")
-      ) ?? head.appendChild(LMN.title``);
       const {
         id,
         title,
         author,
-        summary,
         contributor,
         published,
         content,
         rights,
         updated,
       } = metadata;
-      titleElement.textContent = Object(title) instanceof String
-        ? title
-        : Array.from(title ?? []).map(($) =>
-          $.textContent
-        ).join("");
-      for (const person of author) {
-        // Iterate over authors and add appropriate meta tags.
-        head.appendChild(
-          LMN.meta({ name: "author" })
-            .content(`${person.name ?? person.uri}`)``,
-        );
-      }
-      if (summary) {
-        // The entry has a summary.
-        head.appendChild(
-          LMN.meta({ name: "description" })
-            .content(
-              `${
-                Object(summary) instanceof String
-                  ? summary
-                  : Array.from(summary).map(($) => $.textContent).join(
-                    "",
-                  )
-              }`,
-            )``,
-        );
-      } else {
-        /* do nothing */
-      }
+      fillOutHead(document, metadata, "entry");
       const contentPlaceholder = document.getElementsByTagNameNS(
         XHTML,
         "bjørn-content",
@@ -440,13 +403,19 @@ const applyMetadata = (node, metadata) => {
       // This entry does not have a publication date.
       /* do nothing */
     }
-    addContent(contentElement, "\n");
-    addContent(
-      contentElement.appendChild(
-        LMN.div.property(`${DC11}abstract`)``,
-      ),
-      summary,
-    );
+    if (summary) {
+      // This entry has a summary.
+      addContent(contentElement, "\n");
+      addContent(
+        contentElement.appendChild(
+          LMN.div.property(`${DC11}abstract`)``,
+        ),
+        summary,
+      );
+    } else {
+      // This entry does not have a summary.
+      /* do nothing */
+    }
     addContent(contentElement, "\n");
     addContent(node, "\n");
   } else {
@@ -455,6 +424,12 @@ const applyMetadata = (node, metadata) => {
     // Assume it is an Atom element of some sort and add the
     // the appropriate metadata as child elements.
     const { ownerDocument: document } = node;
+    const alternateLink = node.appendChild(
+      document.createElement("link"),
+    );
+    alternateLink.setAttribute("rel", "alternate");
+    alternateLink.setAttribute("type", "application/xhtml+xml");
+    alternateLink.setAttribute("href", metadata.id);
     for (const [property, values] of Object.entries(metadata)) {
       for (const value of Array.isArray(values) ? values : [values]) {
         const propertyNode = document.createElement(property);
@@ -555,7 +530,7 @@ const context = {
   },
   rights: { namespace: DC11, localName: "rights", type: "text" },
   // source is not supported at this time
-  // subtitle is not supported at this time
+  subtitle: { namespace: RDFS, localName: "label", type: "text" },
   summary: { namespace: DC11, localName: "abstract", type: "text" },
   title: { namespace: DC11, localName: "title", type: "text" },
   // updated is provided by the build script
@@ -582,6 +557,90 @@ const {
   };
 })();
 
+/**
+ * Fills out the `head` of the provided H·T·M·L document with the
+ * appropriate metadata.
+ */
+const fillOutHead = (document, metadata, type) => {
+  const { documentElement } = document;
+  const LMN = Lemon.bind({ document });
+  const head =
+    Array.from(documentElement.childNodes).find(($) =>
+      hasExpandedName($, XHTML, "head")
+    ) ?? documentElement.insertBefore(
+      LMN.head``,
+      documentElement.childNodes.item(0),
+    );
+  const titleElement =
+    Array.from(head.childNodes).find(($) =>
+      hasExpandedName($, XHTML, "title")
+    ) ?? head.appendChild(LMN.title``);
+  const {
+    title,
+    author,
+    subtitle,
+    summary,
+  } = metadata;
+  titleElement.textContent = Object(title) instanceof String
+    ? title
+    : Array.from(title ?? []).map(($) => $.textContent).join("");
+  for (const person of author) {
+    // Iterate over authors and add appropriate meta tags.
+    head.appendChild(
+      LMN.meta({
+        name: "author",
+        content: person.name ?? person.uri,
+      })``,
+    );
+  }
+  head.appendChild(
+    LMN.meta({ name: "generator", content: "🧸📔 Bjørn" })``,
+  );
+  if (type == "entry") {
+    // The provided document is an entry document.
+    if (summary) {
+      // The entry has a summary.
+      head.appendChild(
+        LMN.meta({
+          name: "description",
+          content: Object(summary) instanceof String
+            ? summary
+            : Array.from(summary).map(($) => $.textContent).join(""),
+        })``,
+      );
+    } else {
+      /* do nothing */
+    }
+    head.appendChild(
+      LMN.link
+        .rel("alternate")
+        .type("application/atom+xml")
+        .href("../../feed.atom")``,
+    );
+  } else {
+    // The provided document is not an entry document.
+    if (subtitle) {
+      // The entry has a subtitle.
+      head.appendChild(
+        LMN.meta({
+          name: "description",
+          content: Object(subtitle) instanceof String
+            ? summary
+            : Array.from(subtitle).map(($) => $.textContent).join(""),
+        })``,
+      );
+    } else {
+      /* do nothing */
+    }
+    head.appendChild(
+      LMN.link
+        .rel("alternate")
+        .type("application/atom+xml")
+        .href("./feed.atom")``,
+    );
+  }
+};
+
 /**
  * Returns the language of the provided node, or null if it has no
  * language.
@@ -850,24 +909,44 @@ const validateMetadata = (metadata, type) => {
 await (async () => { // this is the run script
   const writes = [];
 
-  // Set up the Atom feed.
+  // Set up the feed metadata and Atom feed document.
+  const feedDocument = parser.parseFromString(
+    await Deno.readTextFile(`${basePath}/#feed.rdf`),
+    "application/xml",
+  );
+  const feedMetadata = metadataFromDocument(feedDocument);
+  const feedURI = new URL(feedMetadata.id);
   const document = parser.parseFromString(
     `<?xml version="1.0" encoding="utf-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom"></feed>`,
+<feed xmlns="http://www.w3.org/2005/Atom"><generator>🧸📔 Bjørn</generator><link rel="self" type="application/atom+xml" href="${new URL(
+      "./feed.atom",
+      feedURI,
+    )}"/></feed>`,
     "application/xml",
   );
   const { documentElement: feed } = document;
-  const feedMetadata = metadataFromDocument(
-    parser.parseFromString(
-      await Deno.readTextFile(`${basePath}/#feed.rdf`),
-      "application/xml",
-    ),
-  );
-  const feedURI = new URL(feedMetadata.id);
+  const feedLanguage = getLanguage(feedDocument);
+  if (feedLanguage) {
+    // The feed element has a language.
+    setLanguage(feed, feedLanguage);
+  } else {
+    // There is no language for the feed.
+    /* do nothing */
+  }
   applyMetadata(feed, feedMetadata);
 
   // Set up the index page.
   const feedTemplate = await documentFromTemplate("feed");
+  const { documentElement: feedTemplateRoot } = feedTemplate;
+  if (feedLanguage && !getLanguage(feedTemplateRoot)) {
+    // The root element of the template does not have an
+    // assigned language, but the feed does.
+    setLanguage(feedTemplateRoot, feedLanguage);
+  } else {
+    // Either the template root already has a language, or the
+    // entry doesn’t either.
+    /* do nothing */
+  }
   const feedEntries = feedTemplate.createDocumentFragment();
 
   // Process entries and save the resulting index files.
@@ -883,9 +962,11 @@ await (async () => { // this is the run script
       continue;
     } else {
       // This is a dated directory.
-      for await (
-        const { name: entryName, isDirectory } of Deno.readDir(
-          `${basePath}/${date}/`,
+      for (
+        const { name: entryName, isDirectory } of Array.from(
+          Deno.readDirSync(`${basePath}/${date}/`),
+        ).sort(({ name: a }, { name: b }) =>
+          a < b ? -1 : a > b ? 1 : 0
         )
       ) {
         // Iterate over each directory and process the ones which look
@@ -958,43 +1039,23 @@ await (async () => { // this is the run script
 
   // Apply the feed metadata to the feed template and save the
   // resulting index file.
-  const { documentElement: feedRoot } = feedTemplate;
-  if (hasExpandedName(feedRoot, XHTML, "html")) {
+  if (hasExpandedName(feedTemplateRoot, XHTML, "html")) {
     // This is an XHTML template.
     const LMN = Lemon.bind({ document: feedTemplate });
-    const head = Array.from(feedRoot.childNodes).find(($) =>
-      hasExpandedName($, XHTML, "head")
-    ) ?? feedRoot.insertBefore(
-      LMN.head``,
-      feedRoot.childNodes.item(0),
-    );
-    const titleElement = Array.from(head.childNodes).find(($) =>
-      hasExpandedName($, XHTML, "title")
-    ) ?? head.appendChild(LMN.title``);
     const {
       id,
       title,
-      author,
+      subtitle,
       rights,
       updated,
     } = feedMetadata;
-    titleElement.textContent = Object(title) instanceof String
-      ? title
-      : Array.from(title ?? []).map(($) =>
-        $.textContent
-      ).join("");
-    for (const person of author) {
-      // Iterate over authors and add appropriate meta tags.
-      head.appendChild(
-        LMN.meta({ name: "author" })
-          .content(`${person.name ?? person.uri}`)``,
-      );
-    }
+    fillOutHead(feedTemplate, feedMetadata, "feed");
     const contentPlaceholder = feedTemplate.getElementsByTagNameNS(
       XHTML,
       "bjørn-content",
     ).item(0);
     if (contentPlaceholder != null) {
+      // There is a content placeholder.
       const { parentNode: contentParent } = contentPlaceholder;
       const contentElement = contentParent.insertBefore(
         LMN.nav.about(`${id}`)`${"\n"}`,
@@ -1008,6 +1069,17 @@ await (async () => { // this is the run script
         title,
       );
       addContent(contentHeader, "\n");
+      if (subtitle) {
+        // The feed has a subtitle.
+        addContent(
+          contentHeader.appendChild(LMN.p.property(`${RDFS}label`)``),
+          subtitle,
+        );
+        addContent(contentHeader, "\n");
+      } else {
+        // The feed has no subtitle.
+        /* do nothing */
+      }
       addContent(contentElement, "\n");
       const entriesElement = contentElement.appendChild(
         LMN.ul.rel(`${AWOL}entry`)`${"\n"}`,
@@ -1018,6 +1090,7 @@ await (async () => { // this is the run script
         LMN.footer`${"\n\t"}`,
       );
       if (rights) {
+        // The feed has a rights statement.
         addContent(
           contentFooter.appendChild(
             LMN.div.property(`${DC11}rights`)``,
@@ -1025,6 +1098,9 @@ await (async () => { // this is the run script
           rights,
         );
         addContent(contentFooter, "\n\t");
+      } else {
+        // The feed has no rights statement.
+        /* do nothing */
       }
       contentFooter.appendChild(
         LMN.p.id("entry.updated")`Last updated: ${LMN.time.property(
This page took 0.037731 seconds and 4 git commands to generate.