@anglefeint/astro-theme 0.1.34 → 0.1.36

package/README.md

@@ -54,6 +54,8 @@ This package reads site-specific config from alias imports:
 
 In the starter/site project, map these aliases to `src/config/*` and `src/i18n/*` in both Vite and TS config.
 
+Giscus comments are configured from site-side `theme.comments` (enabled + repo/category IDs). If required fields are not set, comments are not rendered.
+
 ## CLI
 
 - `anglefeint-new-post`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anglefeint/astro-theme",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "type": "module",
   "description": "Anglefeint core theme package for Astro",
   "keywords": [
@@ -18,7 +18,6 @@
   },
   "files": [
     "src/index.ts",
-    "src/consts.ts",
     "src/content-schema.ts",
     "src/config",
     "src/components",
@@ -46,8 +45,7 @@
     "./assets/*": "./src/assets/*",
     "./utils/merge": "./src/utils/merge.ts",
     "./utils/*": "./src/utils/*",
-    "./content-schema": "./src/content-schema.ts",
-    "./consts": "./src/consts.ts"
+    "./content-schema": "./src/content-schema.ts"
   },
   "peerDependencies": {
     "astro": "^5.0.0 || ^6.0.0-beta.0"

package/src/components/BaseHead.astro

@@ -6,105 +6,109 @@ import type { ImageMetadata } from 'astro';
 import FallbackImage from '../assets/theme/placeholders/theme-placeholder-1.jpg';
 import { SITE_AUTHOR, SITE_TITLE, SITE_URL } from '@anglefeint/site-config/site';
 import {
-	DEFAULT_LOCALE,
-	SUPPORTED_LOCALES,
-	alternatePathForLocale,
-	isLocale,
-	stripLocaleFromPath,
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  alternatePathForLocale,
+  isLocale,
+  stripLocaleFromPath,
 } from '@anglefeint/site-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;
+  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,
+  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 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(),
+  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',
+  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 ogLocaleAlternates = SUPPORTED_LOCALES.filter((l) => l !== currentLocale).map(
+  (l) => OG_LOCALE[l]
+);
+const articleModifiedISO = (modifiedTime ?? publishedTime)?.toISOString();
 
 const websiteSchema = {
-	'@context': 'https://schema.org',
-	'@type': 'WebSite',
-	name: SITE_TITLE,
-	url: siteURL.toString(),
-	description,
-	publisher: {
-		'@type': 'Person',
-		name: SITE_AUTHOR,
-	},
+  '@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(),
+  '@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;
+  ? {
+      '@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);
@@ -116,12 +120,7 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 <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}
-/>
+<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} />
@@ -133,9 +132,9 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 <!-- Canonical URL -->
 <link rel="canonical" href={canonicalURL} />
 {
-	alternatePaths.map((alternate) => (
-		<link rel="alternate" hreflang={alternate.locale} href={alternate.href} />
-	))
+  alternatePaths.map((alternate) => (
+    <link rel="alternate" hreflang={alternate.locale} href={alternate.href} />
+  ))
 }
 <link rel="alternate" hreflang="x-default" href={xDefaultHref} />
 
@@ -151,16 +150,28 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 <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)} />}
+{
+  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()} />
-)}
+{ogLocaleAlternates.map((loc) => <meta property="og:locale:alternate" content={loc} />)}
+{
+  isArticle && publishedTime && (
+    <meta property="article:published_time" content={publishedTime.toISOString()} />
+  )
+}
+{
+  isArticle && articleModifiedISO && (
+    <meta property="article:modified_time" content={articleModifiedISO} />
+  )
+}
 {isArticle && <meta property="article:author" content={author} />}
 
 <!-- Twitter -->
@@ -170,8 +181,8 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 <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)} />
-		))
-	}
+{
+  jsonLdSchemas.map((schemaItem) => (
+    <script is:inline type="application/ld+json" set:html={JSON.stringify(schemaItem)} />
+  ))
+}

package/src/config/theme.ts

@@ -27,4 +27,14 @@ export const THEME = {
   EFFECTS: {
     ENABLE_RED_QUEEN: true,
   },
+  /** Optional comments integration (Giscus) */
+  COMMENTS: {
+    ENABLED: false,
+    REPO: '',
+    REPO_ID: '',
+    CATEGORY: '',
+    CATEGORY_ID: '',
+    THEME: 'dark',
+    LANG: 'en',
+  },
 } as const;

package/src/i18n/messages.ts

@@ -37,7 +37,13 @@ export type Messages = {
     jumpGo: string;
     jumpInputLabel: string;
     backToBlog: string;
+    backToTop: string;
     related: string;
+    comments: string;
+    responseOutput: string;
+    heroMonitor: string;
+    heroSignalSync: string;
+    heroModelOnline: string;
     regenerate: string;
     toastP10: string;
     toastP30: string;
@@ -79,7 +85,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       jumpGo: 'Go',
       jumpInputLabel: 'Page number',
       backToBlog: 'Back to blog',
+      backToTop: 'Back to top',
       related: 'Related',
+      comments: 'Comments',
+      responseOutput: 'Output',
+      heroMonitor: 'neural monitor',
+      heroSignalSync: 'signal sync active',
+      heroModelOnline: 'model online',
       regenerate: 'Regenerate',
       toastP10: 'context parsed 10%',
       toastP30: 'context parsed 30%',
@@ -119,7 +131,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       jumpGo: '移動',
       jumpInputLabel: 'ページ番号',
       backToBlog: 'ブログへ戻る',
+      backToTop: '先頭へ戻る',
       related: '関連記事',
+      comments: 'コメント',
+      responseOutput: '出力',
+      heroMonitor: 'ニューラルモニター',
+      heroSignalSync: 'シグナル同期中',
+      heroModelOnline: 'モデルオンライン',
       regenerate: '再生成',
       toastP10: '文脈解析 10%',
       toastP30: '文脈解析 30%',
@@ -159,7 +177,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       jumpGo: '이동',
       jumpInputLabel: '페이지 번호',
       backToBlog: '블로그로 돌아가기',
+      backToTop: '맨 위로',
       related: '관련 글',
+      comments: '댓글',
+      responseOutput: '출력',
+      heroMonitor: '뉴럴 모니터',
+      heroSignalSync: '신호 동기화 활성',
+      heroModelOnline: '모델 온라인',
       regenerate: '재생성',
       toastP10: '컨텍스트 파싱 10%',
       toastP30: '컨텍스트 파싱 30%',
@@ -200,7 +224,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       jumpGo: 'Ir',
       jumpInputLabel: 'Número de página',
       backToBlog: 'Volver al blog',
+      backToTop: 'Volver arriba',
       related: 'Relacionados',
+      comments: 'Comentarios',
+      responseOutput: 'Salida',
+      heroMonitor: 'monitor neural',
+      heroSignalSync: 'sincronización de señal activa',
+      heroModelOnline: 'modelo en línea',
       regenerate: 'Regenerar',
       toastP10: 'contexto analizado 10%',
       toastP30: 'contexto analizado 30%',
@@ -240,7 +270,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       jumpGo: '跳转',
       jumpInputLabel: '页码',
       backToBlog: '返回博客',
+      backToTop: '返回顶部',
       related: '相关文章',
+      comments: '评论',
+      responseOutput: '输出',
+      heroMonitor: '神经监视器',
+      heroSignalSync: '信号同步中',
+      heroModelOnline: '模型在线',
       regenerate: '重新生成',
       toastP10: '语境解析 10%',
       toastP30: '语境解析 30%',

package/src/index.ts

@@ -1,4 +1,3 @@
-export * from './consts';
 export * from './i18n/config';
 export * from './i18n/posts';
 export { getMessages } from './i18n/messages';

package/src/layouts/BlogPost.astro

@@ -57,6 +57,10 @@ const hasResponseMeta = aiLatencyMs !== undefined || aiConfidence !== undefined;
 const hasStats = aiModel || wordCount !== undefined || tokenCount !== undefined;
 const confidenceText = aiConfidence !== undefined ? aiConfidence.toFixed(2) : undefined;
 const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
+const comments = THEME.COMMENTS;
+const hasCommentsConfig = Boolean(
+  comments.ENABLED && comments.REPO && comments.REPO_ID && comments.CATEGORY && comments.CATEGORY_ID
+);
 ---
 
 <AiShell
@@ -116,8 +120,11 @@ const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
       )
     }
     <div class="ai-read-progress" aria-hidden="true"></div>
-    <button type="button" class="ai-back-to-top" aria-label="Back to top" title="Back to top"
-      >↑</button
+    <button
+      type="button"
+      class="ai-back-to-top"
+      aria-label={messages.blog.backToTop}
+      title={messages.blog.backToTop}>↑</button
     >
     <div
       class="ai-stage-toast"
@@ -156,13 +163,13 @@ const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
                 </div>
               </div>
               <div class="hero-frame" aria-hidden="true">
-                <span>neural monitor</span>
+                <span>{messages.blog.heroMonitor}</span>
                 <span class="hero-frame-dot" />
               </div>
             </div>
             <div class="hero-threat-bar" aria-hidden="true">
-              <span>signal sync active</span>
-              <span>model online</span>
+              <span>{messages.blog.heroSignalSync}</span>
+              <span>{messages.blog.heroModelOnline}</span>
             </div>
           </div>
         </div>
@@ -199,7 +206,7 @@ const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
       <div class="ai-response-wrap">
         <div class="ai-response-header">
           <div class="ai-response-avatar" aria-hidden="true"></div>
-          <span class="ai-response-label">Output</span>
+          <span class="ai-response-label">{messages.blog.responseOutput}</span>
           {
             hasResponseMeta && (
               <div class="ai-response-meta">
@@ -273,24 +280,29 @@ const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
       <span class="ai-back-text">← {messages.blog.backToBlog}</span>
     </a>
   </nav>
-  <section class="prose ai-comments" aria-label="Comments">
-    <script
-      src="https://giscus.app/client.js"
-      data-repo="anglefeint/astro-theme-anglefeint"
-      data-repo-id="R_kgDORRyzkg"
-      data-category="Comments"
-      data-category-id="DIC_kwDORRyzks4C3pRw"
-      data-mapping="pathname"
-      data-strict="0"
-      data-reactions-enabled="1"
-      data-emit-metadata="0"
-      data-input-position="bottom"
-      data-theme="dark"
-      data-lang="en"
-      data-loading="lazy"
-      crossorigin="anonymous"
-      async></script>
-  </section>
+  {
+    hasCommentsConfig && (
+      <section class="prose ai-comments" aria-label={messages.blog.comments}>
+        <script
+          src="https://giscus.app/client.js"
+          data-repo={comments.REPO}
+          data-repo-id={comments.REPO_ID}
+          data-category={comments.CATEGORY}
+          data-category-id={comments.CATEGORY_ID}
+          data-mapping="pathname"
+          data-strict="0"
+          data-reactions-enabled="1"
+          data-emit-metadata="0"
+          data-input-position="bottom"
+          data-theme={comments.THEME}
+          data-lang={comments.LANG || resolvedLocale}
+          data-loading="lazy"
+          crossorigin="anonymous"
+          async
+        />
+      </section>
+    )
+  }
   <Fragment slot="body-end">
     <script>
       import { initBlogpostEffects } from '../scripts/blogpost-effects.js';

package/src/layouts/HomePage.astro

@@ -7,8 +7,8 @@ import { getMessages } from '@anglefeint/site-i18n/messages';
 import MatrixShell from './shells/MatrixShell.astro';
 
 interface Props {
-	locale: Locale;
-	latestPosts: CollectionEntry<'blog'>[];
+  locale: Locale;
+  latestPosts: CollectionEntry<'blog'>[];
 }
 
 const { locale, latestPosts } = Astro.props;
@@ -17,31 +17,33 @@ const heroText = SITE_HERO_BY_LOCALE[locale] ?? messages.home.hero;
 ---
 
 <MatrixShell locale={locale} title={SITE_TITLE} description={messages.siteDescription}>
-	<link slot="head" rel="preload" href="/fonts/ff2a407fe06752facf8828a86955e988.woff2" as="font" type="font/woff2" crossorigin />
-	<h1>{SITE_TITLE}</h1>
-	<p class="home-hero-copy">{heroText}</p>
+  <h1>{SITE_TITLE}</h1>
+  <p class="home-hero-copy">{heroText}</p>
 
-	<section class="home-latest">
-		<h2 class="home-section-title">{messages.home.latest}</h2>
-		<ul class="home-post-list">
-			{
-				latestPosts.length > 0 ? (
-					latestPosts.map((post) => (
-						<li>
-							<a class="home-post-title" href={localePath(locale, `/blog/${blogIdToSlugAnyLocale(post.id)}`)}>
-								{post.data.title}
-							</a>
-							<div class="home-post-meta">
-								<FormattedDate date={post.data.pubDate} locale={locale} />
-								{post.data.description && <> · {post.data.description}</>}
-							</div>
-						</li>
-					))
-				) : (
-					<li>{messages.home.noPosts}</li>
-				)
-			}
-		</ul>
-		<p><a href={localePath(locale, '/blog/')}>{messages.home.viewAll}</a></p>
-	</section>
+  <section class="home-latest">
+    <h2 class="home-section-title">{messages.home.latest}</h2>
+    <ul class="home-post-list">
+      {
+        latestPosts.length > 0 ? (
+          latestPosts.map((post) => (
+            <li>
+              <a
+                class="home-post-title"
+                href={localePath(locale, `/blog/${blogIdToSlugAnyLocale(post.id)}`)}
+              >
+                {post.data.title}
+              </a>
+              <div class="home-post-meta">
+                <FormattedDate date={post.data.pubDate} locale={locale} />
+                {post.data.description && <> · {post.data.description}</>}
+              </div>
+            </li>
+          ))
+        ) : (
+          <li>{messages.home.noPosts}</li>
+        )
+      }
+    </ul>
+    <p><a href={localePath(locale, '/blog/')}>{messages.home.viewAll}</a></p>
+  </section>
 </MatrixShell>

package/src/consts.ts

@@ -1,12 +0,0 @@
-/**
- * @deprecated Use src/config/site.ts instead.
- * Re-exported for backwards compatibility.
- */
-export {
-	SITE_TITLE,
-	SITE_DESCRIPTION,
-	SITE_URL,
-	SITE_AUTHOR,
-	SITE_TAGLINE,
-	SITE_HERO_BY_LOCALE,
-} from '@anglefeint/site-config/site';