updates for new svg view/download links

extras/components/outline-button.js

@@ -116,9 +116,16 @@
 		const outline = [ ];
 
 		for (const heading of headings) {
+			const content = heading.cloneNode(true);
+			const anchor = content.querySelector('a.heading-anchor');
+
+			if (anchor) {
+				anchor.parentNode.removeChild(anchor);
+			}
+
 			outline.push(`
 			<li data-depth="${heading.tagName.toLowerCase()}">
-				<a href="#${heading.id}">${heading.innerText}</a>
+				<a href="#${heading.id}">${content.innerHTML}</a>
 			</li>
 			`);
 		}

extras/components/outline-inline.js

@@ -92,9 +92,16 @@
 		const outline = [ ];
 
 		for (const heading of headings) {
+			const content = heading.cloneNode(true);
+			const anchor = content.querySelector('a.heading-anchor');
+
+			if (anchor) {
+				anchor.parentNode.removeChild(anchor);
+			}
+
 			outline.push(`
 			<li data-depth="${heading.tagName.toLowerCase()}">
-				<a href="#${heading.id}">${heading.innerText}</a>
+				<a href="#${heading.id}">${content.innerHTML}</a>
 			</li>
 			`);
 		}

extras/svg-links.js

@@ -0,0 +1,58 @@
+(() => {
+	
+	if (document.readyState === 'complete') {
+		add_svg_links();
+	}
+
+	else {
+		window.addEventListener('DOMContentLoaded', add_svg_links);
+	}
+
+	function add_svg_links() {
+		const svg_elems = document.querySelectorAll('figure > svg');
+
+		for (const svg_elem of svg_elems) {
+			const figure_elem = svg_elem.parentElement;
+			const anchor_elem = document.createElement('a');
+			const lang = figure_elem.getAttribute('data-lang') || '';
+
+			let svg_html;
+
+			if ('svg_link_css' in window) {
+				const svg_clone = svg_elem.cloneNode(true);
+				const style_elem = document.createElement('style');
+				svg_clone.insertBefore(style_elem, svg_clone.firstChild);
+
+				const css
+					= (window.svg_link_css['*'] || '')
+					+ (lang ? window.svg_link_css[lang] || '' : '');
+	
+				style_elem.setAttribute('type', 'text/css');
+				style_elem.appendChild(document.createTextNode(css));
+
+				svg_html = svg_clone.outerHTML;
+			}
+
+			else {
+				svg_html = svg_elem.outerHTML;
+			}
+			
+			const box = document.createElement('div');
+			const svg_xml = '<?xml version="1.0" standalone="no" ?>\r\n'
+				+ svg_html.replace(/(&(?!(amp|gt|lt|quot|apos))[^;]+;)/g, ($0, $1) => {
+					box.innerHTML = $0;
+					return box.textContent;
+				});
+
+			const svg_blob = new Blob([ svg_xml ], { type: 'image/svg+xml; charset=utf-8' });
+			const svg_object_url = URL.createObjectURL(svg_blob);
+
+			anchor_elem.href = svg_object_url;
+			anchor_elem.className = 'view-svg';
+			anchor_elem.textContent = 'View / Download Graphic';
+
+			figure_elem.insertBefore(anchor_elem, svg_elem);
+		}
+	}
+
+})();

extras/typography/compact.css

@@ -52,3 +52,27 @@ li {
 	line-height: 1.5;
 	margin-block: 0.25rem;
 }
+
+dl {
+	padding: 1rem;
+}
+
+dd + dt {
+	margin-block-start: 1rem;
+}
+
+:is(dt, dd) > p {
+	line-height: 1.5;
+	margin-block-start: 0;
+	margin-block-end: 0.15rem;
+}
+
+
+
+
+
+/* ===== Figure Captions ===== */
+
+figcaption {
+	margin-block-start: 1.5rem;
+}

extras/typography/general.css

@@ -86,6 +86,9 @@ p {
 a {
 	font-family: inherit;
 	color: var(--theme-text-link);
+	display: inline-flex;
+	align-items: center;
+	column-gap: 0.2rem;
 }
 
 a:active,
@@ -137,38 +140,10 @@ ul[role='doc-endnotes'] {
 	background: var(--theme-bg-heavy);
 }
 
-dl {
-	padding: 1rem;
-}
-
-dt, dd {
-	/*  */
-}
-
 dt {
 	font-weight: 700;
 }
 
-dt p {
-	margin-block-end: 1rem;
-}
-
-dt:not(:first-of-type) {
-	margin-block-start: 2rem;
-}
-
-/* dd {
-	margin-inline-start: 1rem;
-	padding-inline-start: 1rem;
-	padding-block: 0.125rem;
-	border-inline-start: 0.5rem var(--theme-line) solid;
-	background: var(--theme-bg-heavy)
-} */
-
-dd p {
-	margin-block: 1rem;
-}
-
 .cite-label {
 	font-weight: 600;
 }
@@ -351,7 +326,6 @@ figcaption {
 	font-family: var(--font-body);
 	text-align: center;
 	font-size: 0.85rem;
-	margin-block-start: 1rem;
 	color: var(--theme-text-light);
 	max-width: 60vw;
 	margin-inline: auto;

extras/typography/spacious.css

@@ -52,3 +52,26 @@ li {
 	line-height: 1.75;
 	margin-block: 0.5rem;
 }
+
+dl {
+	padding: 1rem;
+}
+
+dd + dt {
+	margin-block-start: 1.25rem;
+}
+
+:is(dt, dd) > p {
+	margin-block-start: 0;
+	margin-block-end: 0.25rem;
+}
+
+
+
+
+
+/* ===== Figure Captions ===== */
+
+figcaption {
+	margin-block-start: 2rem;
+}

package-lock.json

@@ -10,7 +10,7 @@
       "dependencies": {
         "@doc-utils/color-themes": "^0.1.14",
         "@doc-utils/jsonschema2markdown": "^0.1.1",
-        "@doc-utils/markdown2html": "^0.2.1",
+        "@doc-utils/markdown2html": "^0.3.2",
         "glob": "^10.2.3",
         "ical": "^0.8.0",
         "ical-generator": "^4.1.0",
@@ -51,9 +51,9 @@
       }
     },
     "node_modules/@doc-utils/markdown2html": {
-      "version": "0.2.6",
+      "version": "0.3.2",
-      "resolved": "https://gitea.jbrumond.me/api/packages/doc-utils/npm/%40doc-utils%2Fmarkdown2html/-/0.2.6/markdown2html-0.2.6.tgz",
+      "resolved": "https://gitea.jbrumond.me/api/packages/doc-utils/npm/%40doc-utils%2Fmarkdown2html/-/0.3.2/markdown2html-0.3.2.tgz",
-      "integrity": "sha512-6cQNzthYOOlkT6rr6E1lpSJ4Zq991+chblSRxv69SVT8y5cIs6c9tFu75MXoIKX4+H68Q4i10gtMrrsXD+bkaA==",
+      "integrity": "sha512-aRPlxA25gowmWmzPID4xyLCTVs7VgQJvlmYn3amnFAsUC55JzFXZQ9MR40AKeQYv9VSXIpxjUr7A86hgOzRFFw==",
       "dependencies": {
         "bytefield-svg": "^1.6.1",
         "dompurify": "^2.3.6",
@@ -2692,9 +2692,9 @@
       }
     },
     "@doc-utils/markdown2html": {
-      "version": "0.2.6",
+      "version": "0.3.2",
-      "resolved": "https://gitea.jbrumond.me/api/packages/doc-utils/npm/%40doc-utils%2Fmarkdown2html/-/0.2.6/markdown2html-0.2.6.tgz",
+      "resolved": "https://gitea.jbrumond.me/api/packages/doc-utils/npm/%40doc-utils%2Fmarkdown2html/-/0.3.2/markdown2html-0.3.2.tgz",
-      "integrity": "sha512-6cQNzthYOOlkT6rr6E1lpSJ4Zq991+chblSRxv69SVT8y5cIs6c9tFu75MXoIKX4+H68Q4i10gtMrrsXD+bkaA==",
+      "integrity": "sha512-aRPlxA25gowmWmzPID4xyLCTVs7VgQJvlmYn3amnFAsUC55JzFXZQ9MR40AKeQYv9VSXIpxjUr7A86hgOzRFFw==",
       "requires": {
         "bytefield-svg": "^1.6.1",
         "dompurify": "^2.3.6",

package.json

@@ -24,7 +24,7 @@
   "dependencies": {
     "@doc-utils/color-themes": "^0.1.14",
     "@doc-utils/jsonschema2markdown": "^0.1.1",
-    "@doc-utils/markdown2html": "^0.2.1",
+    "@doc-utils/markdown2html": "^0.3.2",
     "glob": "^10.2.3",
     "ical": "^0.8.0",
     "ical-generator": "^4.1.0",

src/build-files/helpers.ts

@@ -5,11 +5,13 @@ import { BuildState } from './state';
 import { mkdirp, write_text } from '../fs';
 import { CalendarConfig, RSSConfig } from '../conf';
 import { render_theme_css_properties } from '../themes';
-import { load_partials, FrontMatter, Context, load_layout, render_template } from '../template';
+import { load_partials, FrontMatter, Context, load_layout, render_template, EventFrontmatter } from '../template';
 import { render_markdown_to_html, render_markdown_to_html_inline_sync } from '@doc-utils/markdown2html';
 import { RSSEntry } from './rss';
 import { DateTime } from 'luxon';
 import { EventEntry } from './icalendar';
+import { as_context_time, as_html_time, from_iso } from '../time';
+import { FileMetadata } from '../metadata';
 
 export interface OutFileURL {
 	base_url: string;
@@ -81,14 +83,42 @@ export async function build_partials(state: BuildState) {
 	Object.assign(state.partials, state.extras);
 }
 
-export function mustache_context(state: BuildState, page_url: string, frontmatter?: FrontMatter) : Context {
+export function mustache_context(state: BuildState, page_url: string, metadata: FileMetadata, frontmatter?: FrontMatter) : Context {
+	let event: Context['event'];
+
+	if (frontmatter?.event) {
+		event = Array.isArray(frontmatter.event)
+			? frontmatter.event.map(to_context_event)
+			: to_context_event(frontmatter.event);
+
+		function to_context_event(event_fm: EventFrontmatter) {
+			const start = from_iso(event_fm.start, event_fm.time_zone);
+			const end = from_iso(event_fm.end, event_fm.time_zone);
+			
+			return {
+				start: as_context_time(start),
+				end: as_context_time(end),
+				time_zone: event_fm.time_zone,
+			};
+		}
+	}
+
+	const has_been_updated = metadata.first_seen_time !== metadata.last_updated_time;
+
 	return {
 		env: state.env,
 		page: frontmatter,
 		base_url: state.conf.base_url,
 		page_url: page_url,
+		page_published: as_context_time(from_iso(metadata.first_seen_time), 'dt-published'),
+		page_updated: has_been_updated ? as_context_time(from_iso(metadata.last_updated_time), 'dt-updated') : null,
 		site_title: state.conf.title,
 		author: get_author(state, frontmatter),
+		event: event,
+		event_series: Array.isArray(event) && {
+			start: event[0].start,
+			end: event[event.length - 1].end,
+		},
 		build_time: state.build_time,
 		icons: icons,
 		rss_feeds: state.conf.rss || [ ],
@@ -109,7 +139,7 @@ export function mustache_context(state: BuildState, page_url: string, frontmatte
 	};
 }
 
-export async function render_page(state: BuildState, in_file: string, out_file: string, out_url: OutFileURL, text: string, render_as_markdown: boolean, frontmatter?: any) {
+export async function render_page(state: BuildState, in_file: string, out_file: string, out_url: OutFileURL, text: string, render_as_markdown: boolean, hash: string, frontmatter?: any) {
 	if (render_as_markdown) {
 		const opts = Object.assign({ }, state.conf.markdown, {
 			base_url: out_url.abs_url
@@ -129,11 +159,21 @@ export async function render_page(state: BuildState, in_file: string, out_file:
 		layout = state.layouts[layout_file];
 	}
 
+	const hash_matches = file_hash_matches(state, in_file, hash);
+	const rel_in_file = in_file.slice(state.conf.input.root.length);
+	const old_metadata = state.old_metadata?.files?.[rel_in_file];
+	const new_metadata = hash_matches ? structuredClone(old_metadata) : {
+		first_seen_time: old_metadata?.first_seen_time || state.build_time.iso,
+		last_build_hash: hash,
+		last_updated_time: state.build_time.iso,
+	};
+
 	const tags = state.conf.templates?.tags;
-	const context = mustache_context(state, out_url.abs_url, frontmatter);
+	const context = mustache_context(state, out_url.abs_url, new_metadata, frontmatter);
 	const rendered = render_template(text, context, layout, structuredClone(state.partials), tags);
 	await write_text(out_file, rendered);
 
+	state.new_metadata.files[rel_in_file] = new_metadata;
 	handle_page_side_effects(state, in_file, out_file, out_url, text, frontmatter);
 }
 
@@ -173,8 +213,12 @@ function handle_page_side_effects(state: BuildState, in_file: string, out_file:
 }
 
 function handle_rss(state: BuildState, rss_conf: RSSConfig, entries: RSSEntry[], in_file: string, out_url: OutFileURL, text: string, frontmatter: FrontMatter) {
+	if (frontmatter?.rss?.skip) {
+		return;
+	}
+
 	const author_or_authors = get_author(state, frontmatter);
-	const author = Array.isArray(author_or_authors) ? author_or_authors[0] : author_or_authors;
+	const authors = author_or_authors && (Array.isArray(author_or_authors) ? author_or_authors : [ author_or_authors ]);
 
 	entries.push({
 		url: out_url.abs_url,
@@ -182,12 +226,16 @@ function handle_rss(state: BuildState, rss_conf: RSSConfig, entries: RSSEntry[],
 		html_content: text,
 		title: frontmatter?.title,
 		description: frontmatter?.description,
-		author_name: author?.name,
+		authors: authors,
 		tags: frontmatter?.tags,
 	});
 }
 
 function handle_sitemap(state: BuildState, out_url: OutFileURL, frontmatter: FrontMatter) {
+	if (frontmatter?.sitemap?.skip) {
+		return;
+	}
+
 	state.sitemap.push({
 		url: out_url.abs_url,
 		lastmod: state.build_time.iso,
@@ -204,16 +252,30 @@ function handle_event(state: BuildState, in_file: string, out_url: OutFileURL, f
 	const author_or_authors = get_author(state, frontmatter);
 	const author = Array.isArray(author_or_authors) ? author_or_authors[0] : author_or_authors;
 
+	if (Array.isArray(frontmatter.event)) {
+		state.event_series.push({
+			url: out_url.abs_url,
+			in_file: in_file,
+			title: frontmatter.title,
+			description: frontmatter.description,
+			author_name: author?.name,
+			author_email: author?.email,
+			entries: frontmatter.event.slice(),
+		});
+
+		return;
+	}
+
 	state.events.push({
 		url: out_url.abs_url,
 		in_file: in_file,
-		title: frontmatter.title,
+		title: frontmatter.event.title || frontmatter.title,
 		description: frontmatter.description,
 		author_name: author?.name,
 		author_email: author?.email,
-		start_time: frontmatter.event?.start_time,
+		start: frontmatter.event.start,
-		end_time: frontmatter.event?.end_time,
+		end: frontmatter.event.end,
-		time_zone: frontmatter.event?.time_zone,
+		time_zone: frontmatter.event.time_zone,
 	});
 }
 
@@ -221,6 +283,12 @@ function handle_calendar(state: BuildState, cal_conf: CalendarConfig, entries: E
 	const author_or_authors = get_author(state, frontmatter);
 	const author = Array.isArray(author_or_authors) ? author_or_authors[0] : author_or_authors;
 
+	if (Array.isArray(frontmatter.event)) {
+		// todo: add each event to the calendar
+
+		return;
+	}
+
 	entries.push({
 		url: out_url.abs_url,
 		in_file: in_file,
@@ -228,8 +296,8 @@ function handle_calendar(state: BuildState, cal_conf: CalendarConfig, entries: E
 		description: frontmatter.description,
 		author_name: author?.name,
 		author_email: author?.email,
-		start_time: frontmatter.event?.start_time,
+		start: frontmatter.event?.start,
-		end_time: frontmatter.event?.end_time,
+		end: frontmatter.event?.end,
 		time_zone: frontmatter.event?.time_zone,
 	});
 }
@@ -269,20 +337,6 @@ export function skip_file(state: BuildState, in_file: string, out_file: string,
 	handle_page_side_effects(state, in_file, out_file, out_url, frontmatter);
 }
 
-export function copy_metadata(state: BuildState, in_file: string) {
-	in_file = in_file.slice(state.conf.input.root.length);
-	state.new_metadata.files[in_file] = structuredClone(state.old_metadata?.files?.[in_file]);
-}
-
-export function update_metadata(state: BuildState, in_file: string, hash: string) {
-	in_file = in_file.slice(state.conf.input.root.length);
-	state.new_metadata.files[in_file] = {
-		first_seen_time: state.old_metadata?.files?.[in_file]?.first_seen_time || state.build_time.iso,
-		last_build_hash: hash,
-		last_updated_time: state.build_time.iso,
-	};
-}
-
 export function get_author(state: BuildState, frontmatter?: FrontMatter) {
 	if (! frontmatter?.author) {
 		return null;

src/build-files/icalendar.ts

@@ -2,11 +2,28 @@
 import { write_text } from '../fs';
 import { BuildState } from './state';
 import { map_input_file_to_output_file } from './helpers';
-import { parseICS, CalendarComponent } from 'ical';
+// import { parseICS, CalendarComponent } from 'ical';
 import create_calendar, { ICalEventData, ICalCalendarData } from 'ical-generator';
+import { FrontMatterLocation } from '../template';
 
 export type { ICalEventData, ICalCalendarData, ICalAttendeeData, ICalAttendeeStatus } from 'ical-generator';
 
+export interface EventSeries {
+	url: string;
+	in_file: string;
+	title?: string;
+	description?: string;
+	author_name?: string;
+	author_email?: string;
+	entries: {
+		title?: string;
+		start?: string;
+		end?: string;
+		time_zone?: `${string}/${string}`;
+		location?: FrontMatterLocation;
+	}[];
+}
+
 export interface EventEntry {
 	url: string;
 	in_file: string;
@@ -14,9 +31,10 @@ export interface EventEntry {
 	description?: string;
 	author_name?: string;
 	author_email?: string;
-	start_time?: string;
+	start?: string;
-	end_time?: string;
+	end?: string;
 	time_zone?: `${string}/${string}`;
+	location?: FrontMatterLocation;
 }
 
 export async function write_events_and_calendars_if_needed(state: BuildState) {
@@ -33,7 +51,40 @@ export async function write_events_and_calendars_if_needed(state: BuildState) {
 			};
 
 			const calendar = create_icalendar(cal_data, event);
-			const out_file = await map_input_file_to_output_file(state, entry.in_file, [ '.html', '.md', '.markdown' ], '.isc');
+			const out_file = await map_input_file_to_output_file(state, entry.in_file, [ '.html', '.md', '.markdown' ], '.ics');
+			await write_text(out_file, calendar);
+		}
+
+		for (const series of state.event_series) {
+			const events = series.entries.map((event) => {
+				return icalendar_event(state, {
+					url: series.url,
+					in_file: series.in_file,
+					title: event.title || series.title,
+					description: series.description,
+					author_name: series.author_name,
+					author_email: series.author_email,
+					start: event.start,
+					end: event.end,
+					time_zone: event.time_zone,
+					location: event.location,
+				});
+			});
+			
+			const cal_data: ICalCalendarData = {
+				name: series.title,
+				description: series.description,
+				url: series.url,
+				prodId: {
+					company: 'jbrumond.me',
+					product: 'docs2website',
+					language: 'EN',
+				},
+				// ...
+			};
+
+			const calendar = create_icalendar(cal_data, events);
+			const out_file = await map_input_file_to_output_file(state, series.in_file, [ '.html', '.md', '.markdown' ], '.ics');
 			await write_text(out_file, calendar);
 		}
 	}
@@ -62,16 +113,16 @@ export async function write_events_and_calendars_if_needed(state: BuildState) {
 	}
 }
 
-export function parse_icalendar(contents: string) {
+// export function parse_icalendar(contents: string) {
-	const parsed = parseICS(contents);
+// 	const parsed = parseICS(contents);
-	const calendar: CalendarComponent[] = [ ];
+// 	const calendar: CalendarComponent[] = [ ];
 
-	for (const data of Object.values(parsed)) {
+// 	for (const data of Object.values(parsed)) {
-		calendar.push(data);
+// 		calendar.push(data);
-	}
+// 	}
 
-	return calendar;
+// 	return calendar;
-}
+// }
 
 export function create_icalendar(cal: ICalCalendarData, events: ICalEventData | ICalEventData[]) {
 	const calendar = create_calendar(cal);
@@ -97,8 +148,8 @@ export function icalendar_event(state: BuildState, entry: EventEntry) : ICalEven
 		id: entry.url,
 		summary: entry.title,
 		description: entry.description || void 0,
-		start: entry.start_time,
+		start: entry.start,
-		end: entry.end_time,
+		end: entry.end,
 		url: entry.url,
 		timezone: entry.time_zone,
 		created: metadata.first_seen_time,
@@ -107,6 +158,7 @@ export function icalendar_event(state: BuildState, entry: EventEntry) : ICalEven
 			name: entry.author_name || 'Unknown',
 			email: entry.author_email,
 		},
+		location: format_location(entry.location),
 		// attendees: post.mentions.flatMap((mention) : ICalAttendeeData | ICalAttendeeData[] => {
 		// 	if (mention.is_rsvp && mention.is_reply_to_this) {
 		// 		const ext = mention.external as ExternalEntry;
@@ -129,3 +181,29 @@ export function icalendar_event(state: BuildState, entry: EventEntry) : ICalEven
 		// }),
 	};
 }
+
+function format_location(loc: FrontMatterLocation) {
+	if (! loc) {
+		return;
+	}
+
+	if (loc.description) {
+		if (loc.address) {
+			return `${loc.description} (${loc.address})`;
+		}
+		
+		if (loc.lat && loc.long) {
+			return `${loc.description} [${loc.lat}, ${loc.long}]`;
+		}
+
+		return loc.description;
+	}
+
+	if (loc.address) {
+		return loc.address;
+	}
+
+	if (loc.lat && loc.long) {
+		return `[${loc.lat}, ${loc.long}]`;
+	}
+}

src/build-files/index.ts

@@ -16,6 +16,7 @@ import { render_json_schema_files } from './jsonschema';
 import { write_sitemap_if_needed } from './sitemap';
 import { write_rss_if_needed } from './rss';
 import { write_events_and_calendars_if_needed } from './icalendar';
+import { as_context_time, as_html_time } from '../time';
 
 export { BuildState, ThemeGroups } from './state';
 
@@ -60,11 +61,9 @@ export async function build_docs_project(conf: Config) {
 		rss: [ ],
 		sitemap: [ ],
 		events: [ ],
+		event_series: [ ],
 		calendars: [ ],
-		build_time: {
+		build_time: as_context_time(now),
-			iso: now.toISO(),
-			rfc2822: now.toRFC2822(),
-		},
 	};
 
 	for (const theme of Object.values(themes)) {

src/build-files/jsonschema.ts

@@ -4,7 +4,7 @@ import { BuildState } from './state';
 import { read_json, write_text, read_yaml } from '../fs';
 import { build_markdown_from_json_schema } from '@doc-utils/jsonschema2markdown';
 import { stringify as to_yaml } from 'yaml';
-import { build_partials, copy_metadata, file_hash_matches, map_input_file_to_output_file, map_output_file_to_url, render_page, skip_file, update_metadata } from './helpers';
+import { build_partials, map_input_file_to_output_file, map_output_file_to_url, render_page } from './helpers';
 
 export async function render_json_schema_files(state: BuildState) {
 	const promises: Promise<any>[] = [ ];
@@ -124,14 +124,8 @@ export async function render_json_schema(state: BuildState, schema: unknown, in_
 	}
 	
 	promises.push(
-		render_page(state, in_file, out_file, out_url, markdown, true, frontmatter)
+		render_page(state, in_file, out_file, out_url, markdown, true, hash, frontmatter)
 	);
 	
 	await Promise.all(promises);
-
-	if (file_hash_matches(state, in_file, hash)) {
-		return copy_metadata(state, in_file);
-	}
-
-	update_metadata(state, in_file, hash);
 }

src/build-files/markdown.ts

@@ -2,7 +2,7 @@
 import { glob } from 'glob';
 import { read_text } from '../fs';
 import { BuildState } from './state';
-import { build_partials, copy_metadata, file_hash_matches, map_input_file_to_output_file, map_output_file_to_url, render_page, skip_file, update_metadata } from './helpers';
+import { build_partials, map_input_file_to_output_file, map_output_file_to_url, render_page } from './helpers';
 
 export async function render_markdown_files(state: BuildState) {
 	const promises: Promise<any>[] = [ ];
@@ -39,11 +39,5 @@ export async function render_markdown_file(state: BuildState, in_file: string) {
 		return;
 	}
 	
-	await render_page(state, in_file, out_file, out_url, text, true, frontmatter);
+	await render_page(state, in_file, out_file, out_url, text, true, hash, frontmatter);
-
-	if (file_hash_matches(state, in_file, hash)) {
-		return copy_metadata(state, in_file);
-	}
-	
-	update_metadata(state, in_file, hash);
 }

src/build-files/mustache.ts

@@ -2,7 +2,7 @@
 import { glob } from 'glob';
 import { read_text } from '../fs';
 import { BuildState } from './state';
-import { build_partials, copy_metadata, file_hash_matches, map_input_file_to_output_file, map_output_file_to_url, render_page, skip_file, update_metadata } from './helpers';
+import { build_partials, map_input_file_to_output_file, map_output_file_to_url, render_page } from './helpers';
 
 export async function render_text_file_templates(state: BuildState) {
 	const promises: Promise<any>[] = [ ];
@@ -39,11 +39,5 @@ export async function render_text_file_template(state: BuildState, in_file: stri
 		return;
 	}
 
-	await render_page(state, in_file, out_file, out_url, text, false, frontmatter);
+	await render_page(state, in_file, out_file, out_url, text, false, hash, frontmatter);
-
-	if (file_hash_matches(state, in_file, hash)) {
-		return copy_metadata(state, in_file);
-	}
-
-	update_metadata(state, in_file, hash);
 }

src/build-files/rss.ts

@@ -3,7 +3,7 @@ import type { XMLBuilder } from 'xmlbuilder2/lib/interfaces';
 import { create as create_xml } from 'xmlbuilder2';
 import { BuildState } from './state';
 import { write_text } from '../fs';
-import { app_version } from '../conf';
+import { AuthorConfig, app_version } from '../conf';
 import { map_output_file_to_url } from './helpers';
 import { DateTime } from 'luxon';
 
@@ -12,7 +12,7 @@ export interface RSSEntry {
 	in_file: string;
 	title?: string;
 	description?: string;
-	author_name?: string;
+	authors?: AuthorConfig[];
 	html_content?: string;
 	tags?: string[];
 }
@@ -100,8 +100,10 @@ export async function write_rss_if_needed(state: BuildState) {
 				item.ele('description').txt(entry.description);
 			}
 			
-			if (entry.author_name) {
+			if (entry.authors) {
-				item.ele('dc:creator').ele({ $: entry.author_name });
+				for (const author of entry.authors) {
+					item.ele('dc:creator').ele({ $: author.name || author.url || author.email });
+				}
 			}
 	
 			if (entry.tags) {

src/build-files/state.ts

@@ -4,7 +4,8 @@ import type { Metadata } from '../metadata';
 import type { ColorTheme } from '@doc-utils/color-themes';
 import type { SitemapEntry } from './sitemap';
 import { RSSEntry } from './rss';
-import { EventEntry } from './icalendar';
+import { EventEntry, EventSeries } from './icalendar';
+import { ContextTime } from '../template';
 
 export interface BuildState {
 	conf: Config;
@@ -21,11 +22,9 @@ export interface BuildState {
 	rss: RSSEntry[][];
 	sitemap: SitemapEntry[];
 	events: EventEntry[];
+	event_series: EventSeries[];
 	calendars: EventEntry[][];
-	build_time: {
+	build_time: ContextTime;
-		iso: string;
-		rfc2822: string;
-	};
 }
 
 export interface ThemeGroups {

src/template.ts

@@ -14,22 +14,48 @@ export interface Context {
 	page?: FrontMatter;
 	base_url: string;
 	page_url: string;
+	page_published: ContextTime;
+	page_updated: ContextTime;
 	site_title: string;
 	author: AuthorConfig | AuthorConfig[];
+	event?: ContextEvent | ContextEvent[];
+	event_series?: {
+		start?: ContextTime;
+		end?: ContextTime;
+	};
 	icons: Record<string, string>;
 	themes: ColorTheme[];
 	theme_groups: ThemeGroups;
 	rss_feeds: RSSConfig[];
 	calendars: CalendarConfig[];
-	build_time: {
+	build_time: ContextTime;
-		iso: string;
-		rfc2822: string;
-	};
 	markdown: {
 		render_inline(): MustacheRenderer;
 	}
 }
 
+export interface ContextTime {
+	iso: string;
+	rfc2822: string;
+	html: string;
+}
+
+export interface ContextEvent {
+	title?: string;
+	start?: ContextTime;
+	end?: ContextTime;
+	time_zone?: `${string}/${string}`;
+	location?: ContextLocation;
+}
+
+export interface ContextLocation {
+	description?: string;
+	lat?: string;
+	long?: string;
+	// todo: represent this better?
+	address?: string;
+}
+
 export interface FrontMatter {
 	skip?: boolean;
 	layout?: string;
@@ -39,23 +65,34 @@ export interface FrontMatter {
 	author?: string | string[];
 	rss?: RSSFrontmatter;
 	sitemap?: SitemapFrontmatter;
-	event?: EventFrontmatter;
+	event?: EventFrontmatter | EventFrontmatter[];
 	[key: string]: unknown;
 }
 
-interface SitemapFrontmatter {
+export interface SitemapFrontmatter {
+	skip?: boolean;
 	change_freq?: ChangeFreq;
 	priority?: number;
 }
 
-interface EventFrontmatter {
+export interface EventFrontmatter {
-	start_time?: string;
+	title?: string;
-	end_time?: string;
+	start?: string;
+	end?: string;
 	time_zone?: `${string}/${string}`;
+	location?: FrontMatterLocation;
 }
 
-interface RSSFrontmatter {
+export interface FrontMatterLocation {
-	// 
+	description?: string;
+	lat?: string;
+	long?: string;
+	// todo: represent this better?
+	address?: string;
+}
+
+export interface RSSFrontmatter {
+	skip?: boolean;
 }
 
 export function render_template(template: string, context: Context, layout?: string, partials: Record<string, string> = { }, tags?: [ string, string ]) {
@@ -67,6 +104,7 @@ export async function load_extras() {
 	const extras: Record<string, string> = Object.create(null);
 	const extras_dir = resolve_path(__dirname, '../extras');
 	const extras_files = [
+		'svg-links.js',
 		'components/color-scheme-toggle-button.js',
 		'components/outline-button.js',
 		'components/outline-inline.js',

src/time.ts

@@ -13,42 +13,20 @@ export function from_iso(time: string, zone?: string) {
 		: DateTime.fromISO(time);
 }
 
-// function date_formatters(lang: string, time_zone: string) {
+export function as_html_time(time: DateTime, classname = '', lang?: string, config?: Intl.DateTimeFormatOptions) {
-// 	return {
+	if (lang && config) {
-// 		date() {
+		const formatter = new Intl.DateTimeFormat(lang, config);
-// 			return (text, render) => {
+		const formatted = formatter.format(new Date(time.toISO()));
-// 				return format_with_config(render(text), {
+		return `<time datetime="${time.toISO()}">${formatted}</time>`;
-// 					dateStyle: 'short',
+	}
-// 					timeZone: time_zone,
-// 				});
-// 			};
-// 		},
-// 		time() {
-// 			return (text, render) => {
-// 				return format_with_config(render(text), {
-// 					timeStyle: 'long',
-// 					timeZone: time_zone,
-// 				});
-// 			};
-// 		},
-// 		datetime() {
-// 			return (text, render) => {
-// 				return format_with_config(render(text), {
-// 					dateStyle: 'short',
-// 					timeStyle: 'long',
-// 					timeZone: time_zone,
-// 				});
-// 			};
-// 		},
-// 	};
-
-// 	function format_with_config(text: string, config: Intl.DateTimeFormatOptions) {
-// 		const date = new Date(text.trim());
-// 		const formatter = new Intl.DateTimeFormat(lang, config);
-// 		return formatter.format(date);
-// 	}
-// }
-
-
 
+	return `<time class="${classname}" datetime="${time.toISO()}">${time.toRFC2822()}</time>`;
+}
 
+export function as_context_time(time: DateTime, classname = '', lang?: string, config?: Intl.DateTimeFormatOptions) {
+	return {
+		iso: time.toISO(),
+		rfc2822: time.toRFC2822(),
+		html: as_html_time(time, classname, lang, config),
+	};
+}