mirror of
https://github.com/ChenQihan666/MyBlog-Next.git
synced 2026-08-13 23:31:07 +08:00
f0b644de3a
* feat: add initial configuration and social icons for AstroPaper theme * feat: add theme styles and design tokens * chore: configure Astro with sitemap, i18n, fonts, and tooling - Set site URL, i18n (single locale, no prefix), sitemap integration - Add Google Sans Code font via stable fonts API - Configure Shiki dual-theme markdown (min-light / night-owl) - Fix astro-paper.config.ts to use relative import (alias not available when Vite loads root-level config files) - Add @astrojs/sitemap and @typescript-eslint/parser dependencies - Wire @typescript-eslint/parser into ESLint so TypeScript syntax in Astro frontmatter (type Props, etc.) parses correctly * feat: add base styles, dark variant, and typography - global.css: dark variant via [data-theme], base layer for * / a / button selectors, scrollbar tokens, layout utilities (max-w-app, app-layout), active-nav as @utility for Tailwind variant support - html and body classes moved directly onto elements in BaseLayout (Tailwind-native approach) so only truly global selectors remain here - typography.css: prose overrides, Shiki light/dark code block switching, diff/highlight/word-highlight transformer styles * feat: add i18n types, English strings, and useTranslations helper Plain typed object approach — no third-party i18n library needed. Paraglide.js was considered but requires SSR output (hard blocker for a static Astro site). - UIStrings interface with nav, post, pagination, and a11y groups - en.ts with `satisfies UIStrings` for literal-type preservation - useTranslations(locale) helper falls back to English automatically Adding a new language is a one-file addition; full routing stays as a registry add-on. * feat: add client-side theme toggle script - Reads window.__theme.value set by the inline FOUC-prevention script to avoid re-detecting the theme on first load - Toggles data-theme on <html> and persists to localStorage - Fills <meta name="theme-color"> with the computed background colour so Android's browser chrome matches the page - Re-runs setup on astro:after-swap for View Transitions navigation - Carries theme-color across astro:before-swap to prevent navbar flicker on Android during page transitions - Syncs with OS prefers-color-scheme changes at runtime * feat: add BaseLayout and PostLayout BaseLayout (replaces scaffold Layout.astro): - Font, canonical URL via Astro.site, RSS autodiscovery - FOUC-prevention inline script sets data-theme before first paint and exposes window.__theme.value for theme.ts to reuse - html/body classes on elements directly (Tailwind-native) - <slot name="head"> for child layout injection - ClientRouter for View Transitions (respects lightAndDarkMode flag) - googleVerification rendered from config instead of .env — it is a public string, not a secret, and not environment-specific PostLayout (new): - Wraps BaseLayout; injects article-specific head content via slot - Overrides og:type to "article" - Adds article:published_time / article:modified_time conditionally - JSON-LD BlogPosting with conditional datePublished/dateModified (fixes old bug where absent dates produced "undefined" string) - Structured data only on actual post pages (not home/archives/tags) SiteConfig: add optional googleVerification field * chore: replace scaffold index page with BaseLayout placeholder * feat: add Header component * feat: add Footer and Socials component * chore: install dayjs, slugify, zod, @astrojs/mdx and add MDX integration * feat: add resolved config that applies defaults in one place Defaults for posts, features, socials, and shareLinks are merged in src/config.ts so all consuming code gets non-optional types with no scattered ?? fallbacks. * feat: add content schema, blog path, and post utilities Renames collection blog→posts, moves content to src/content/posts/, adds .mdx support, and adds a typed pages collection. Includes getSortedPosts, postFilter, getPath, and slugify utilities. * feat: add Datetime and Card components * refactor: switch layouts and components to resolved config Replaces @/astro-paper.config imports with @/config and removes optional chaining on feature flags now that the resolved config guarantees non-optional values. * feat: add home and footer i18n strings * feat: implement home page with hero, featured, and recent posts Replaces the BaseLayout placeholder with the full index page: hero section with RSS link and social links, featured posts section, recent posts capped at posts.perIndex, and an All Posts link. All section labels come from i18n. * feat: add pagination component * feat: add Breadcrumb component with locale support * feat: add Main component * refactor: update code formatting in Card.astro * feat: add posts page * fix: add missing @astrojs/mdx dependency * refactor: rename meta to pages in i18n * refactor: improve code formatting in Breadcrumb * refactor: destructure props in Main component for clarity * feat: add tag pages * feat: add About page * chore: update i18n configuration to use site language from config * feat: add Archives page * feat: integrate Pagefind search functionality * feat: add dynamic Open Graph image generation for posts * feat: add post detail page * feat: add Shiki transformers * chore: remove unused edit link text * chore: update .gitignore to include generated Pagefind directory * chore: update site URL in configuration to production link * chore: replace favicon and remove unused SVG assets, add new Open Graph image * feat: update site config with default values * feat: add default OG image path resolution * fix: ensure edit post feature checks for enabled status correctly * feat: implement dynamic Open Graph image generation * feat: add RSS feed generation functionality * feat: add 404 Not Found page * feat: add robots.txt generation for SEO optimization * refactor: change getSortedPosts to a named export * refactor: change postFilter to a named export * refactor: rename BaseLayout to Layout * refactor: standardize locale handling across components * refactor: update getPostsByGroupCondition location * chore: remove unused Welcome component * refactor(i18n): update links using getRelativeLocaleUrl * refactor(i18n): add dynamic locale loading * fix: update language attribute to use current locale * fix: correct wording for updatedAt in post translations * fix: update layout titles to use correct translation keys for tags pages * chore: use new colors for better DX and a11y * feat: add underline icon for active icon nav * feat: add toc for markdown contents * refactor: remove unused feature flags in config * refactor(i18n): enhance locale handling and path management * fix: ts unused variable hint * refactor: extract locale stripping logic into a util func * refactor(i18n): improve locale handling in tag pages * refactor: update post URL helper functions * refactor(i18n): replace pathWithBase with getRelativeLocaleUrl for locale handling * refactor: rename fileWithBase to getAssetPath * refactor: use runtime agnostic APIs for file paths * refactor: use transition directive for heading transition * refactor: remove unused title element from tag page * fix: decouple ClientRouter from lightAndDarkMode flag * refactor: rename `postPaths.ts` to `getPostPaths.ts` * refactor: remove unused `minutesRead` string from post translations * refactor: simplify AdjacentPostNav component by passing prevPost and nextPost directly * refactor: remove unused code declaration * docs: add existing blog posts * chore: update astro and @astrojs/check dependencies to latest versions * build: use experimental svg optimizer * chore(repo): restore project meta files and Docker configs * refactor: update code formatting with Prettier * docs: update README and docs * docs: add JSDoc comments to utility functions * docs: add JSDoc comments to resolved config file * fix(og): avoid double slashes when appending index.png * chore(ci): update Node.js version to 22.12.0 in CI workflow * feat: improve og image generation with Astro's getFontFileURL API (#632) * feat: improve og image generation with Astro's getFontFileURL API - remove @resvg/resvg-js and use sharp to convert SVG to PNG - update og image generation to use Astro's getFontFileURL API for better font handling * docs: update README and dynamic OG images documentation - remove outdated content and clarify dynamic OG image generation process in README. - add new image example and update instructions for handling non-Latin characters in dynamic OG images. - adjust copyright year in README to 2026. * fix(header): adjust icon button alignment in mobile * feat(docs): add ResponsiveTable to use it in MDX posts (#634) * feat(docs): add ResponsiveTable to use it in MDX posts Introduce ResponsiveTable with variant-based styling. Rename docs posts to .mdx, wrap tables in the component, and remove redundant table `code` rules from prose typography. * chore(prettier): ignore .mdx files when checking format * chore(ci): update Node.js version to 24 in CI workflow * bump: upgrade Astro and dependencies * fix: remove redundant backUrl script bug * fix(header): adjust button and icon alignment * fix(a11y): improve muted-foreground color contrast * docs: update predefined color schemes * chore: support site verification env as fallback for googleVerification * docs: add astro paper v6 updates in docs * docs: add AstroPaper-v6.png in astro-paper-6 blog post * fix: update back-to-top button DOM placement (#641) Closes #626, #131, #493
175 lines
5.2 KiB
Plaintext
175 lines
5.2 KiB
Plaintext
---
|
|
import { getRelativeLocaleUrl } from "astro:i18n";
|
|
import "@pagefind/default-ui/css/ui.css";
|
|
import Layout from "@/layouts/Layout.astro";
|
|
import Header from "@/components/Header.astro";
|
|
import Breadcrumb from "@/components/Breadcrumb.astro";
|
|
import Main from "@/components/Main.astro";
|
|
import Footer from "@/components/Footer.astro";
|
|
import { getAssetPath } from "@/utils/withBase";
|
|
import { useTranslations } from "@/i18n";
|
|
import config from "@/config";
|
|
|
|
const locale = Astro.currentLocale ?? config.site.lang;
|
|
|
|
// Redirect to 404 page if `search` feature is not enabled
|
|
const notFoundUrl = getRelativeLocaleUrl(locale, "404");
|
|
if (config.features.search !== "pagefind" && notFoundUrl) {
|
|
return Astro.rewrite(notFoundUrl);
|
|
}
|
|
|
|
const backUrl = config.features.showBackButton
|
|
? `${Astro.url.pathname}`
|
|
: getRelativeLocaleUrl(locale, "");
|
|
|
|
const pagefindBundlePath = getAssetPath("pagefind/");
|
|
|
|
const t = useTranslations(locale);
|
|
---
|
|
|
|
<Layout title={`${t.pages.searchTitle} | ${config.site.title}`}>
|
|
<Header />
|
|
|
|
<Breadcrumb />
|
|
|
|
<Main pageTitle={t.pages.searchTitle} pageDesc={t.pages.searchDesc}>
|
|
<div
|
|
id="pagefind-search"
|
|
transition:persist
|
|
data-backurl={backUrl}
|
|
data-bundle-path={pagefindBundlePath}
|
|
>
|
|
</div>
|
|
</Main>
|
|
|
|
<Footer />
|
|
</Layout>
|
|
|
|
<script>
|
|
function initSearch() {
|
|
const pageFindSearch: HTMLElement | null =
|
|
document.querySelector("#pagefind-search");
|
|
|
|
if (!pageFindSearch) return;
|
|
|
|
const bundlePath = pageFindSearch?.dataset?.bundlePath;
|
|
if (!bundlePath) return;
|
|
|
|
const params = new URLSearchParams(window.location.search);
|
|
|
|
const onIdle = window.requestIdleCallback || (cb => setTimeout(cb, 1));
|
|
|
|
onIdle(async () => {
|
|
// @ts-expect-error — Missing types for @pagefind/default-ui package.
|
|
const { PagefindUI } = await import("@pagefind/default-ui");
|
|
|
|
// Display warning inn dev mode
|
|
if (import.meta.env.DEV) {
|
|
pageFindSearch.innerHTML = `
|
|
<div class="bg-muted/75 rounded p-4 space-y-4 mb-4">
|
|
<p><strong>DEV mode Warning! </strong>You need to build the project at least once to see the search results during development.</p>
|
|
<code class="block bg-black text-white px-2 py-1 rounded">pnpm run build</code>
|
|
</div>
|
|
`;
|
|
}
|
|
|
|
// Init pagefind ui
|
|
const search = new PagefindUI({
|
|
element: "#pagefind-search",
|
|
bundlePath,
|
|
showImages: false,
|
|
showSubResults: true,
|
|
processTerm: function (term: string) {
|
|
params.set("q", term); // Update the `q` parameter in the URL
|
|
history.replaceState(history.state, "", "?" + params.toString()); // Push the new URL without reloading
|
|
|
|
const backUrl =
|
|
pageFindSearch?.dataset?.backurl ?? window.location.pathname;
|
|
sessionStorage.setItem("backUrl", `${backUrl}?${params.toString()}`);
|
|
|
|
return term;
|
|
},
|
|
});
|
|
|
|
// If search param exists (eg: search?q=astro), trigger search
|
|
const query = params.get("q");
|
|
if (query) {
|
|
search.triggerSearch(query);
|
|
}
|
|
|
|
// Reset search param if search input is cleared
|
|
const searchInput = document.querySelector(".pagefind-ui__search-input");
|
|
const clearButton = document.querySelector(".pagefind-ui__search-clear");
|
|
searchInput?.addEventListener("input", resetSearchParam);
|
|
clearButton?.addEventListener("click", resetSearchParam);
|
|
|
|
function resetSearchParam(e: Event) {
|
|
if ((e.target as HTMLInputElement)?.value.trim() === "") {
|
|
history.replaceState(history.state, "", window.location.pathname);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
document.addEventListener("astro:after-swap", () => {
|
|
const pagefindSearch = document.querySelector("#pagefind-search");
|
|
|
|
// if pagefind search form already exists, don't initialize search component
|
|
if (pagefindSearch && pagefindSearch.querySelector("form")) return;
|
|
|
|
initSearch();
|
|
});
|
|
initSearch();
|
|
</script>
|
|
|
|
<style is:global>
|
|
#pagefind-search {
|
|
--pagefind-ui-font: var(--font-app);
|
|
--pagefind-ui-text: var(--foreground);
|
|
--pagefind-ui-background: var(--background);
|
|
--pagefind-ui-border: var(--border);
|
|
--pagefind-ui-primary: var(--accent);
|
|
--pagefind-ui-tag: var(--background);
|
|
--pagefind-ui-border-radius: 0.375rem;
|
|
--pagefind-ui-border-width: 1px;
|
|
--pagefind-ui-image-border-radius: 8px;
|
|
--pagefind-ui-image-box-ratio: 3 / 2;
|
|
|
|
form::before {
|
|
background-color: var(--foreground);
|
|
}
|
|
|
|
input {
|
|
font-weight: 400;
|
|
border: 1px solid var(--border);
|
|
}
|
|
|
|
input:focus-visible {
|
|
outline: 1px solid var(--accent);
|
|
}
|
|
|
|
.pagefind-ui__result-title a {
|
|
color: var(--accent);
|
|
outline-offset: 1px;
|
|
outline-color: var(--accent);
|
|
text-decoration-style: dashed;
|
|
text-underline-offset: 4px;
|
|
}
|
|
|
|
.pagefind-ui__result-title a:focus-visible,
|
|
.pagefind-ui__search-clear:focus-visible {
|
|
text-decoration-line: none;
|
|
outline-width: 2px;
|
|
outline-style: dashed;
|
|
}
|
|
|
|
.pagefind-ui__result:last-of-type {
|
|
border-bottom: 0;
|
|
}
|
|
|
|
.pagefind-ui__result-nested .pagefind-ui__result-link:before {
|
|
font-family: system-ui;
|
|
}
|
|
}
|
|
</style>
|