@abreen/tada 1.7.2 → 1.8.1

package/README.md

@@ -232,6 +232,7 @@ Example site configuration JSON file:
 | `features.search` | Enable search UI and Pagefind index generation |
 | `features.code` | Enable generated source-code HTML pages for configured code extensions |
 | `features.favicon` | Enable automatically generated favicons |
+| `features.footer` | Show the Tada footer at the bottom of every page |
 | `base` | Full base URL of the deployed site, used for metadata and URL generation |
 | `basePath` | URL prefix for deployment under a subpath (e.g., `"/cs101"`), use `"/"` at root |
 | `internalDomains` | Domain names treated as internal by link processing (not marked external) |

package/bin/tada.ts

@@ -332,7 +332,7 @@ async function initCommand(args: string[]): Promise<void> {
     base: 'http://localhost:8080',
     basePath: '/',
     internalDomains: ['localhost'],
-    features: { search: true, code: true, favicon: false },
+    features: { search: true, code: true, favicon: false, footer: true },
   });
 
   const prodConfig = createSiteConfig({
@@ -345,7 +345,7 @@ async function initCommand(args: string[]): Promise<void> {
     base: prodBase,
     basePath: prodBasePath,
     internalDomains: [prodDomain],
-    features: { search: true, code: true, favicon: true },
+    features: { search: true, code: true, favicon: true, footer: true },
   });
 
   fs.writeFileSync(

package/build/site-variables.ts

@@ -10,7 +10,7 @@ const configDir = getProjectDir();
 
 const DEFAULT: Partial<SiteVariables> = {
   basePath: '/',
-  features: { search: true, code: true, favicon: true },
+  features: { search: true, code: true, favicon: true, footer: true },
 };
 
 const isValid = compileJsonSchema(siteSchema);

package/build/types.d.ts

@@ -22,6 +22,7 @@ export type FeatureConfig = {
   search: boolean;
   code: boolean;
   favicon: boolean;
+  footer: boolean;
 };
 
 /** A rendered content asset ready to write to dist/ */

package/build/utils/render.ts

@@ -24,6 +24,7 @@ import {
   toPosix,
   toUrlPath,
 } from './paths';
+import pkg from '../../package.json' with { type: 'json' };
 import { parseFrontMatterAndContent } from './front-matter';
 import { createMarkdown } from './markdown';
 import { generateTocHtml, generateCodeTocHtml } from '../toc-plugin';
@@ -45,6 +46,8 @@ import type {
 
 const log = makeLogger(import.meta.url);
 
+const tadaVersion: string = pkg.version;
+
 const REQUIRED_FRONT_MATTER_FIELDS = ['title'];
 
 function isWatchMode(assetFiles: string[]): boolean {
@@ -133,6 +136,7 @@ function createTemplateParameters({
     content,
     applyBasePath,
     isWatchMode,
+    tadaVersion,
   };
 }
 
@@ -291,7 +295,7 @@ export function renderCodePageAsset({
   const codeFilePath = applyBasePath(
     normalizeOutputPath(`/${toUrlPath(path.relative(contentDir, filePath))}`),
   );
-  const titleHtml = `<tt>${name + ext}</tt>`;
+  const titleHtml = `<code>${name + ext}</code>`;
   const tocItems = lang === 'java' ? extractJavaMethodToc(sourceCode) : [];
   const tocHtml = generateCodeTocHtml(tocItems);
   const pageVariables: Record<string, unknown> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abreen/tada",
-  "version": "1.7.2",
+  "version": "1.8.1",
   "type": "module",
   "description": "A static site generator",
   "license": "MIT",

package/schema/site.schema.json

@@ -4,11 +4,17 @@
   "properties": {
     "features": {
       "type": "object",
-      "default": { "search": true, "code": true, "favicon": true },
+      "default": {
+        "search": true,
+        "code": true,
+        "favicon": true,
+        "footer": true
+      },
       "properties": {
         "search": { "type": "boolean", "default": true },
         "code": { "type": "boolean", "default": true },
-        "favicon": { "type": "boolean", "default": true }
+        "favicon": { "type": "boolean", "default": true },
+        "footer": { "type": "boolean", "default": true }
       },
       "additionalProperties": false
     },

package/src/_layout.scss

@@ -198,3 +198,35 @@ body.literate main table {
   grid-template-columns: 1fr 1fr;
   gap: var(--gap);
 }
+
+footer {
+  @include user-select(none);
+  text-align: center;
+  padding: 2rem 0 1rem;
+  color: var(--fg2-color);
+
+  a {
+    color: var(--fg2-color);
+    text-decoration: none;
+
+    @media (hover: hover) {
+      &:hover {
+        color: var(--link-color-hover);
+      }
+    }
+
+    &:active {
+      color: var(--link-active-color);
+    }
+
+    &::after {
+      content: '';
+      display: inline-block;
+      width: 1.5em;
+      height: 1.5em;
+      vertical-align: middle;
+      margin-left: 0.2em;
+      @include contained-mask(var(--icon-tada));
+    }
+  }
+}

package/src/print/style.scss

@@ -16,7 +16,8 @@
     }
   }
 
-  header {
+  header,
+  footer {
     display: none !important;
   }
 

package/src/search/index.ts

@@ -11,7 +11,12 @@ interface PagefindSubResult {
 }
 
 interface PagefindResult {
-  meta?: { title?: string; page?: string; template?: string };
+  meta?: {
+    title?: string;
+    title_html?: string;
+    page?: string;
+    template?: string;
+  };
   url: string;
   excerpt?: string;
   score: number;
@@ -74,6 +79,7 @@ async function doSearch(state: State) {
       }));
     return {
       title,
+      titleHtml: d.meta?.title_html ?? null,
       url: d.url,
       excerpt: d.excerpt ?? '',
       score: d.score ?? 0,
@@ -141,9 +147,10 @@ function render(
     titleEl.id = `title-${i}`;
     titleEl.className = 'title';
     if (result.template === 'code') {
-      const code = doc.createElement('code');
-      code.textContent = result.title;
-      titleEl.appendChild(code);
+      titleEl.classList.add('code-page');
+    }
+    if (result.titleHtml) {
+      titleEl.innerHTML = result.titleHtml;
     } else {
       titleEl.textContent = result.title;
     }
@@ -174,7 +181,14 @@ function render(
 
         const subTitle = doc.createElement('div');
         subTitle.className = 'title';
-        subTitle.textContent = sub.title;
+        if (result.template === 'code') {
+          subTitle.classList.add('code-page');
+          const code = doc.createElement('code');
+          code.textContent = sub.title;
+          subTitle.appendChild(code);
+        } else {
+          subTitle.textContent = sub.title;
+        }
         subA.appendChild(subTitle);
 
         if (sub.excerpt) {

package/src/search/pdf-utils.ts

@@ -1,6 +1,7 @@
 export type SubResult = { title: string; url: string; excerpt: string };
 export type Result = {
   title: string;
+  titleHtml: string | null;
   url: string;
   excerpt: string;
   score: number;
@@ -67,6 +68,7 @@ export function groupPdfResults(results: Result[]): Result[] {
 
     grouped.push({
       title: primary.title,
+      titleHtml: null,
       url: baseUrl,
       excerpt: primary.excerpt,
       score: primary.score,

package/src/search/style.scss

@@ -127,11 +127,11 @@ header {
 
     ol a .title {
       font-weight: 500;
+    }
 
-      code {
-        background: none;
-        padding: 0;
-      }
+    ol a .title.code-page code {
+      background: none;
+      padding: 0;
     }
 
     ol li .excerpt {

package/templates/_footer.html

@@ -0,0 +1,5 @@
+<% if (site.features.footer) { %>
+<footer data-pagefind-ignore>
+  <p>Generated by <a href="https://github.com/abreen/Tada" target="_blank">Tada</a> <%= tadaVersion %></p>
+</footer>
+<% } %>

package/templates/_heading.html

@@ -2,7 +2,7 @@
   <% if (page.parent) { %>
   <a class="breadcrumb" href="<%= applyBasePath(page.parent) %>" data-pagefind-ignore><%= page.parentLabel %></a>
   <% } %>
-  <h1 data-pagefind-weight="10"><%= page.titleHtml %></h1>
+  <h1 data-pagefind-weight="10" data-pagefind-meta="title_html[data-title-html]" data-title-html="<%- page.titleHtml %>"><%= page.titleHtml %></h1>
 
   <div class="info" data-pagefind-ignore>
     <% if (page.published) { %>

package/templates/_theme.scss

@@ -67,6 +67,7 @@
   --icon-search: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 24 24'><circle cx='11' cy='11' r='7' stroke='<%= iconColor %>' stroke-width='2' fill='none'/><line x1='16.5' y1='16.5' x2='22' y2='22' stroke='<%= iconColor %>' stroke-width='2' stroke-linecap='round'/></svg>");
   --icon-chevron: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'><polyline points='9 18 15 12 9 6' stroke='<%= iconColor %>' stroke-width='2' fill='none' stroke-linecap='round' stroke-linejoin='round'/></svg>");
   --icon-breadcrumb: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 24 24'><path d='M3 7 H17 V22' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round' fill='none'/><polyline points='11 16 17 22 23 16' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round' fill='none'/></svg>");
+  --icon-tada: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='20' height='20' viewBox='0 -960 960 960'><path d='m121-172 151-426q4-11 13.48-17.5 9.47-6.5 20.3-6.5 7.22 0 13.52 2.5T331-612l277 276q5 5.4 7.5 11.7 2.5 6.3 2.5 13.5 0 10.8-6.5 20.3T594-277L167-126q-11 4-20.53.97-9.54-3.04-16.47-9.97-6.93-6.93-9.97-16.47Q117-161 121-172Zm791-506q-8 8-17 8t-17-8l-17-17q-13.8-14-34.5-14T792-695L589-491q-7.36 7-17.18 7T555-491q-7-7-7-16.82t7-17.18l203-204q28.07-28 67.53-28Q865-757 894-729l18 18q7 7.09 7 16.55 0 9.45-7 16.45ZM418-797q7.36-7 17.18-7t16.82 7l17 17q27 28.53 27 67.77Q496-673 469-644l-17 17q-7.36 7-17.18 7T418-627q-7-7-7-16.82t7-17.18l17-17q14-13.79 14-33.5T435-745l-18-18q-7-7.09-7-16.55 0-9.45 8-17.45Zm119-50q7-7 16.82-7t17.18 7l51 51q29 29 29 68.47 0 39.46-29 67.53L521-559q-7.09 7-16.55 7-9.45 0-17.45-7t-8-17.18q0-10.18 8-17.82l101-101q14-13.6 14-34t-14-34l-51-50q-7-7.36-7-17.18t7-16.82Zm340 407q-7 7-16.82 7T843-440l-51-51q-13.6-14-34-14t-34 14l-68 68q-7.36 7-17.18 7T622-423q-7-7-7-16.82t7-17.18l68-68q29-27 68.5-27.5T826-525l51 51q7 7.36 7 17.18T877-440Z'/></svg>");
 
   color-scheme: light dark;
 }

package/templates/code.html

@@ -3,7 +3,7 @@
 <div class="main-content">
   <main class="body" data-pagefind-body>
     <div class="file-header">
-      <h1 data-pagefind-weight="10"><%= page.titleHtml %></h1>
+      <h1 data-pagefind-weight="10" data-pagefind-meta="title_html[data-title-html]" data-title-html="<%- page.titleHtml %>"><%= page.titleHtml %></h1>
       <%= render('_download.html') %>
     </div>
     <div class="code-body">
@@ -22,6 +22,7 @@
       <% }); %>
     </div>
     <% } %>
+    <%= render('_footer.html') %>
   </main>
   <% if (page.tocHtml) { %>
   <nav class="toc"><%= page.tocHtml %></nav>

package/templates/default.html

@@ -4,6 +4,7 @@
   <%= render('_heading.html') %>
   <main class="body" data-pagefind-body>
     <%= content %>
+    <%= render('_footer.html') %>
   </main>
   <% if (page.toc && page.tocHtml) { %>
   <nav class="toc"><%= page.tocHtml %></nav>

package/templates/literate.html

@@ -7,6 +7,7 @@
       <code><%= page.downloadName %></code><%= render('_download.html') %>
     </div>
     <%= content %>
+    <%= render('_footer.html') %>
   </main>
   <% if (page.toc && page.tocHtml) { %>
   <nav class="toc"><%= page.tocHtml %></nav>