@anglefeint/astro-theme 0.1.0-alpha.0

package/src/cli-new-post.mjs

@@ -0,0 +1,139 @@
+import { mkdir, writeFile, access, readdir } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import path from 'node:path';
+
+const SUPPORTED_LOCALES = ['en', 'ja', 'ko', 'es', 'zh'];
+const CONTENT_ROOT = path.resolve(process.cwd(), 'src/content/blog');
+const DEFAULT_COVERS_ROOT = path.resolve(process.cwd(), 'src/assets/blog/default-covers');
+
+function toTitleFromSlug(slug) {
+	return slug
+		.split('-')
+		.filter(Boolean)
+		.map((segment) => segment[0].toUpperCase() + segment.slice(1))
+		.join(' ');
+}
+
+function validateSlug(slug) {
+	return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug);
+}
+
+function hashString(input) {
+	let hash = 5381;
+	for (let i = 0; i < input.length; i += 1) {
+		hash = ((hash << 5) + hash + input.charCodeAt(i)) >>> 0;
+	}
+	return hash >>> 0;
+}
+
+function normalizePathForFrontmatter(filePath) {
+	return filePath.split(path.sep).join('/');
+}
+
+async function loadDefaultCovers() {
+	try {
+		const entries = await readdir(DEFAULT_COVERS_ROOT, { withFileTypes: true });
+		return entries
+			.filter((entry) => entry.isFile() && /\.(webp|png|jpe?g)$/i.test(entry.name))
+			.map((entry) => path.join(DEFAULT_COVERS_ROOT, entry.name))
+			.sort((a, b) => a.localeCompare(b));
+	} catch {
+		return [];
+	}
+}
+
+async function exists(filePath) {
+	try {
+		await access(filePath, constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+function templateFor(locale, slug, pubDate, heroImage) {
+	const titleByLocale = {
+		en: toTitleFromSlug(slug),
+		ja: '新しい記事タイトル',
+		ko: '새 글 제목',
+		es: 'Titulo del nuevo articulo',
+		zh: '新文章标题',
+	};
+	const descriptionByLocale = {
+		en: `A short EN post scaffold for "${slug}".`,
+		ja: `「${slug}」用の短い日本語記事テンプレートです。`,
+		ko: `"${slug}"용 한국어 글 템플릿입니다.`,
+		es: `Plantilla breve en espanol para "${slug}".`,
+		zh: `“${slug}”的中文文章模板。`,
+	};
+	const bodyByLocale = {
+		en: `Write your EN content for "${slug}" here.`,
+		ja: `ここに「${slug}」の日本語本文を書いてください。`,
+		ko: `여기에 "${slug}" 한국어 본문을 작성하세요.`,
+		es: `Escribe aqui el contenido en espanol para "${slug}".`,
+		zh: `请在这里填写“${slug}”的中文正文。`,
+	};
+	return `---
+title: '${titleByLocale[locale]}'
+subtitle: ''
+description: '${descriptionByLocale[locale]}'
+pubDate: '${pubDate}'
+${heroImage ? `heroImage: '${heroImage}'` : ''}
+---
+
+${bodyByLocale[locale]}
+`;
+}
+
+async function main() {
+	const slug = process.argv[2];
+	if (!slug) {
+		console.error('Usage: npm run new-post -- <slug>');
+		process.exit(1);
+	}
+
+	if (!validateSlug(slug)) {
+		console.error('Invalid slug. Use lowercase letters, numbers, and hyphens only.');
+		process.exit(1);
+	}
+
+	const pubDate = new Date().toISOString().slice(0, 10);
+	const defaultCovers = await loadDefaultCovers();
+	const created = [];
+	const skipped = [];
+
+	for (const locale of SUPPORTED_LOCALES) {
+		const localeDir = path.join(CONTENT_ROOT, locale);
+		const filePath = path.join(localeDir, `${slug}.md`);
+		await mkdir(localeDir, { recursive: true });
+
+		if (await exists(filePath)) {
+			skipped.push(filePath);
+			continue;
+		}
+
+		let heroImage = '';
+		if (defaultCovers.length > 0) {
+			const coverPath = defaultCovers[hashString(slug) % defaultCovers.length];
+			heroImage = normalizePathForFrontmatter(path.relative(localeDir, coverPath));
+		}
+
+		await writeFile(filePath, templateFor(locale, slug, pubDate, heroImage), 'utf8');
+		created.push(filePath);
+	}
+
+	if (created.length > 0) {
+		console.log('Created files:');
+		for (const filePath of created) console.log(`- ${filePath}`);
+	}
+
+	if (skipped.length > 0) {
+		console.log('Skipped existing files:');
+		for (const filePath of skipped) console.log(`- ${filePath}`);
+	}
+}
+
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});

package/src/components/BaseHead.astro

@@ -0,0 +1,177 @@
+---
+// Import the global.css file here so that it is included on
+// all pages through the use of the <BaseHead /> component.
+import '../styles/global.css';
+import type { ImageMetadata } from 'astro';
+import FallbackImage from '../assets/theme/placeholders/theme-placeholder-1.jpg';
+import { SITE_AUTHOR, SITE_TITLE, SITE_URL } from '../consts';
+import {
+	DEFAULT_LOCALE,
+	SUPPORTED_LOCALES,
+	alternatePathForLocale,
+	isLocale,
+	stripLocaleFromPath,
+} from '../i18n/config';
+
+interface Props {
+	title: string;
+	description: string;
+	image?: ImageMetadata;
+	pageType?: 'website' | 'article';
+	publishedTime?: Date;
+	modifiedTime?: Date;
+	author?: string;
+	tags?: string[];
+	schema?: Record<string, unknown> | Record<string, unknown>[];
+	noindex?: boolean;
+}
+
+const siteURL = Astro.site ?? new URL(SITE_URL);
+const canonicalURL = new URL(Astro.url.pathname, siteURL);
+
+const {
+	title,
+	description,
+	image = FallbackImage,
+	pageType = 'website',
+	publishedTime,
+	modifiedTime,
+	author = SITE_AUTHOR,
+	tags,
+	schema,
+	noindex = false,
+} = Astro.props;
+
+const imageURL = new URL(image.src, siteURL).toString();
+const robotsContent = noindex ? 'noindex, nofollow' : 'index, follow, max-image-preview:large';
+const isArticle = pageType === 'article';
+const pathParts = Astro.url.pathname.split('/').filter(Boolean);
+const currentLocale = pathParts.length > 0 && isLocale(pathParts[0]) ? pathParts[0] : DEFAULT_LOCALE;
+const rssURL = new URL(`/${currentLocale}/rss.xml`, siteURL);
+const localeSubpath = stripLocaleFromPath(Astro.url.pathname, currentLocale);
+const alternatePaths = SUPPORTED_LOCALES.map((locale) => ({
+	locale,
+	href: new URL(alternatePathForLocale(locale, localeSubpath), siteURL).toString(),
+}));
+const xDefaultHref = new URL(alternatePathForLocale(DEFAULT_LOCALE, localeSubpath), siteURL);
+
+const OG_LOCALE: Record<string, string> = {
+	en: 'en_US',
+	ja: 'ja_JP',
+	ko: 'ko_KR',
+	es: 'es_ES',
+	zh: 'zh_CN',
+};
+const ogLocale = OG_LOCALE[currentLocale] ?? 'en_US';
+const ogLocaleAlternates = SUPPORTED_LOCALES.filter((l) => l !== currentLocale).map((l) => OG_LOCALE[l]);
+
+const websiteSchema = {
+	'@context': 'https://schema.org',
+	'@type': 'WebSite',
+	name: SITE_TITLE,
+	url: siteURL.toString(),
+	description,
+	publisher: {
+		'@type': 'Person',
+		name: SITE_AUTHOR,
+	},
+};
+
+const personSchema = {
+	'@context': 'https://schema.org',
+	'@type': 'Person',
+	name: SITE_AUTHOR,
+	url: siteURL.toString(),
+};
+
+const articleSchema = isArticle
+	? {
+			'@context': 'https://schema.org',
+			'@type': 'BlogPosting',
+			headline: title,
+			description,
+			image: [imageURL],
+			author: {
+				'@type': 'Person',
+				name: author,
+			},
+			publisher: {
+				'@type': 'Person',
+				name: SITE_AUTHOR,
+			},
+			mainEntityOfPage: canonicalURL.toString(),
+			datePublished: publishedTime?.toISOString(),
+			dateModified: (modifiedTime ?? publishedTime)?.toISOString(),
+			keywords: tags?.length ? tags.join(', ') : undefined,
+		}
+	: undefined;
+
+const extraSchemas = schema ? (Array.isArray(schema) ? schema : [schema]) : [];
+const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchemas].filter(Boolean);
+---
+
+<!-- Global Metadata -->
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width,initial-scale=1" />
+<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+<link rel="icon" href="/favicon.ico" />
+<link rel="sitemap" href="/sitemap-index.xml" />
+<link
+	rel="alternate"
+	type="application/rss+xml"
+	title={SITE_TITLE}
+	href={rssURL}
+/>
+<meta name="generator" content={Astro.generator} />
+<meta name="robots" content={robotsContent} />
+<meta name="author" content={author} />
+
+<!-- Font preloads -->
+<link rel="preload" href="/fonts/atkinson-regular.woff" as="font" type="font/woff" crossorigin />
+<link rel="preload" href="/fonts/atkinson-bold.woff" as="font" type="font/woff" crossorigin />
+
+<!-- Canonical URL -->
+<link rel="canonical" href={canonicalURL} />
+{
+	alternatePaths.map((alternate) => (
+		<link rel="alternate" hreflang={alternate.locale} href={alternate.href} />
+	))
+}
+<link rel="alternate" hreflang="x-default" href={xDefaultHref} />
+
+<!-- Primary Meta Tags -->
+<title>{title}</title>
+<meta name="title" content={title} />
+<meta name="description" content={description} />
+{tags && tags.length > 0 && <meta name="keywords" content={tags.join(', ')} />}
+
+<!-- Open Graph / Facebook -->
+<meta property="og:type" content={isArticle ? 'article' : 'website'} />
+<meta property="og:url" content={canonicalURL} />
+<meta property="og:title" content={title} />
+<meta property="og:description" content={description} />
+<meta property="og:image" content={imageURL} />
+{typeof image?.width === 'number' && <meta property="og:image:width" content={String(image.width)} />}
+{typeof image?.height === 'number' && <meta property="og:image:height" content={String(image.height)} />}
+<meta property="og:locale" content={ogLocale} />
+{ogLocaleAlternates.map((loc) => (
+	<meta property="og:locale:alternate" content={loc} />
+))}
+{isArticle && publishedTime && <meta property="article:published_time" content={publishedTime.toISOString()} />}
+{isArticle && (
+	<meta property="article:modified_time" content={(modifiedTime ?? publishedTime)?.toISOString()} />
+)}
+{isArticle && <meta property="article:author" content={author} />}
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:url" content={canonicalURL} />
+<meta name="twitter:title" content={title} />
+<meta name="twitter:description" content={description} />
+<meta name="twitter:image" content={imageURL} />
+
+	{
+		jsonLdSchemas.map((schemaItem) => (
+			<script is:inline type="application/ld+json" set:html={JSON.stringify(schemaItem)} />
+		))
+	}

package/src/components/Footer.astro

@@ -0,0 +1,74 @@
+---
+import { SITE_TAGLINE, SITE_TITLE } from '@anglefeint/site-config/site';
+import { SOCIAL_LINKS } from '@anglefeint/site-config/social';
+
+const today = new Date();
+interface Props {
+	tagline?: string;
+	/** Show Blade Runner scanlines overlay on mesh-page (header/footer only) */
+	scanlines?: boolean;
+}
+
+const { tagline = SITE_TAGLINE, scanlines = false } = Astro.props as Props;
+---
+
+<footer>
+	&copy; {today.getFullYear()} {SITE_TITLE}. {tagline}
+	{SOCIAL_LINKS.length > 0 && (
+		<div class="social-links">
+			{SOCIAL_LINKS.map((link) => (
+				<a href={link.href} target="_blank" rel="noopener noreferrer">
+					<span class="sr-only">{link.label}</span>
+					{link.icon === 'mastodon' && (
+						<svg viewBox="0 0 16 16" aria-hidden="true" width="32" height="32">
+							<path
+								fill="currentColor"
+								d="M11.19 12.195c2.016-.24 3.77-1.475 3.99-2.603.348-1.778.32-4.339.32-4.339 0-3.47-2.286-4.488-2.286-4.488C12.062.238 10.083.017 8.027 0h-.05C5.92.017 3.942.238 2.79.765c0 0-2.285 1.017-2.285 4.488l-.002.662c-.004.64-.007 1.35.011 2.091.083 3.394.626 6.74 3.78 7.57 1.454.383 2.703.463 3.709.408 1.823-.1 2.847-.647 2.847-.647l-.06-1.317s-1.303.41-2.767.36c-1.45-.05-2.98-.156-3.215-1.928a3.614 3.614 0 0 1-.033-.496s1.424.346 3.228.428c1.103.05 2.137-.064 3.188-.189zm1.613-2.47H11.13v-4.08c0-.859-.364-1.295-1.091-1.295-.804 0-1.207.517-1.207 1.541v2.233H7.168V5.89c0-1.024-.403-1.541-1.207-1.541-.727 0-1.091.436-1.091 1.296v4.079H3.197V5.522c0-.859.22-1.541.66-2.046.456-.505 1.052-.764 1.793-.764.856 0 1.504.328 1.933.983L8 4.39l.417-.695c.429-.655 1.077-.983 1.934-.983.74 0 1.336.259 1.791.764.442.505.661 1.187.661 2.046v4.203z"
+							/>
+						</svg>
+					)}
+					{link.icon === 'twitter' && (
+						<svg viewBox="0 0 16 16" aria-hidden="true" width="32" height="32">
+							<path
+								fill="currentColor"
+								d="M5.026 15c6.038 0 9.341-5.003 9.341-9.334 0-.14 0-.282-.006-.422A6.685 6.685 0 0 0 16 3.542a6.658 6.658 0 0 1-1.889.518 3.301 3.301 0 0 0 1.447-1.817 6.533 6.533 0 0 1-2.087.793A3.286 3.286 0 0 0 7.875 6.03a9.325 9.325 0 0 1-6.767-3.429 3.289 3.289 0 0 0 1.018 4.382A3.323 3.323 0 0 1 .64 6.575v.045a3.288 3.288 0 0 0 2.632 3.218 3.203 3.203 0 0 1-.865.115 3.23 3.23 0 0 1-.614-.057 3.283 3.283 0 0 0 3.067 2.277A6.588 6.588 0 0 1 .78 13.58a6.32 6.32 0 0 1-.78-.045A9.344 9.344 0 0 0 5.026 15z"
+							/>
+						</svg>
+					)}
+					{link.icon === 'github' && (
+						<svg viewBox="0 0 16 16" aria-hidden="true" width="32" height="32">
+							<path
+								fill="currentColor"
+								d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.012 8.012 0 0 0 16 8c0-4.42-3.58-8-8-8z"
+							/>
+						</svg>
+					)}
+					{!link.icon && <span>{link.label}</span>}
+				</a>
+			))}
+		</div>
+	)}
+	{scanlines && <div class="mesh-scanlines" aria-hidden="true"></div>}
+</footer>
+<style>
+	footer {
+		padding: 2em 1em 3em 1em;
+		background: var(--chrome-bg, var(--bg));
+		border-top: 1px solid var(--chrome-border, rgb(var(--border)));
+		color: var(--chrome-text-muted, rgb(var(--text-muted)));
+		text-align: center;
+	}
+	.social-links {
+		display: flex;
+		justify-content: center;
+		gap: 1em;
+		margin-top: 1em;
+	}
+	.social-links a {
+		text-decoration: none;
+		color: var(--chrome-text-muted, rgb(var(--text-muted)));
+	}
+	.social-links a:hover {
+		color: var(--chrome-link-hover, var(--chrome-link, rgb(var(--text))));
+	}
+</style>

package/src/components/FormattedDate.astro

@@ -0,0 +1,17 @@
+---
+interface Props {
+	date: Date;
+}
+
+const { date } = Astro.props;
+---
+
+<time datetime={date.toISOString()}>
+	{
+		date.toLocaleDateString('en-us', {
+			year: 'numeric',
+			month: 'short',
+			day: 'numeric',
+		})
+	}
+</time>