# @anglefeint/astro-theme 中文文档 规范地址：https://npmcn.com/package/%40anglefeint/astro-theme/ 版本：0\.25\.0 npm 元数据更新时间：2026-11-04T20:18:35.155Z 中文译文更新时间：2026-11-06T10:21:12.525Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40anglefeint/astro-theme 原文对照：https://npmcn.com/package/%40anglefeint/astro-theme/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：24.5 MB，261 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.12\.0 - 运行依赖：13 个 - peer 依赖：astro ^7\.3\.5 - 首次发布：2026-02-27T11:43:58.457Z - 最新版本发布：2026-11-04T20:18:34.990Z - 近 30 天下载量：3505（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：95（近 12 个月 95 个） ## 中文简介 Astro 的 Anglefeint 核心主题软件包 ## 安装 ```sh npm install @anglefeint/astro-theme ``` 也可以使用：`pnpm add @anglefeint/astro-theme`、`yarn add @anglefeint/astro-theme`、`bun add @anglefeint/astro-theme` ## README # @anglefeint/astro-主题 Anglefeint Astro主题的核心包. 0.9.0版本需要 Astro `^7.3.5`。其匹配启动器使用 Sharp `^0.35.5` 并刷新正式合并。 Astro 5/6不再支持;将站点依赖性与主题一起迁移. 主页开关 `src/site.config.ts`数字 : `theme.home.showInitialize` 控制初始化/done序列, `showFollow` 控制 醒起/随行,以及 `showTrace` 控制右下端终端状态。 全部默认为 `true`; 设置为 `false` 独立隐藏它. 可选 `theme.footer.links` 添加单独的点分隔行 `{ label, href }` 版权和主题信用之间的联系。 空或省略的链接隐藏它;它独立于社会图标和 `showCredits`,标签则在各地保留其配置的文本。 家用开关和页脚链接需要0.15.0版本并匹配起步器计划/默认/适应器更改. 见 [移徙](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md#0150-home-switches-and-footer-links)自定义集成 : `THEME.HOME.SHOW_INITIALIZE/SHOW_FOLLOW/SHOW_TRACE` 和链接 `THEME.FOOTER.LINKS` 通过他们的网站配置化名. 全数 **解码器实验室** 备查 `//decoder/`,具有本地文本处理历史,ERC-20/TRC-20呼叫解释(EVM/HyperEVM/TRON),以及EVM/TRON/Bitcoin地址检查. 从解码器对话框打开 。 设定 `theme.enableDecoderPage: false` 内 `src/site.config.ts` 以忽略页面及其链接。 不需要RPC,钱包连接或API密钥. 解码器实验室的视觉灵感来自 **密码** 自由、隐私和开放守则。 它的对等网络的动机和局部处理反映了将工具和数据保存在个人手中的想法. ## 归档和主页组件接线 当前来源提供有浏览器-局部视图内存的卡片/列表档案,链接到List标签和连续范围/计数元数据. 自定义路线通过 `BlogCards` 现有 `posts` 编号 : `locale` 和可选零基 `startIndex` / 已过滤 `totalPosts`。如果没有这些道具,则将默认值抵消为零,并将总值抵消为所提供的列表长度。 自定义家道通过完整的本地过滤计数为 `HomePage.totalPosts` 与最新贴出的部分。 这些是组件道具;不需要站点-schema或适配器更新. 匹配的项目自有路线也必须合并,以获得准确的跨页总数. 参见第0.24.0节 [升级](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md#0240-archive-views-and-homepage-counts)。 。 。 . ## 解码器读取配置 自0.20.1起:与佐藤中本于2008年11月6日的"关于P2P和自由的回信",尼克·斯扎博于1996年的"智能合同"散文,大卫·乔姆于1985年的"隐私报"和魏黛于1998年的"b-money"提议相接4张. 0.20.1版本有16张牌,被排列为宽屏上的两个八行. 电子邮件不是白纸公告. 十六个默认链接包括 `utm_source=anglefeint&utm_medium=referral&utm_campaign=decoder_lab` 转介的归属。 替换 `href` 值通过下面的配置来更改或去除这些参数;自定义链接按提供时使用,而不自动添加属性参数. 自0.2.0起:信头的独立边疆箭头打开了Decoder Lab;About仍然是直接链接. 已失效的Decoder Lab省略了它的箭头及其路线和已存在的条目. 目前的源默认为16张卡片,连接了8个原始文本和8个资源/项目网站;没有完整文本或翻译被捆绑. 配置其纪念和插图读取卡 `src/site.config.ts` 下级 `i18n.locales..messages.decoderPage.readings`。关闭此字段以保留本地化默认值. `tribute: ''` 隐藏文本, `links: []` 隐藏牌; 设置两个都去掉区域。 提供 `links` 数组取代完整的列表而无需总的项目计数限制;行在宽屏幕上最多有8张牌. 每张牌都要 `title`, (中文(简体) ), `href`选择 `author`, (中文(简体) ), `year`, (中文(简体) ), `cover`。封面可能使用捆绑的名称 `privacy-code`, (中文(简体) ), `cryptographic-autonomy`, (中文(简体) ), `cyberspace-freedom`, (中文(简体) ), `virtual-communities`, (中文(简体) ), `cypherpunk-archive`, (中文(简体) ), `satoshi-institute`, (中文(简体) ), `bitcoin`, (中文(简体) ), `tor-project`, (中文(简体) ), `signal`, (中文(简体) ), `telegram`, (中文(简体) ), `monero`, (中文(简体) ), `gnupg`, (中文(简体) ), `satoshi-freedom`, (中文(简体) ), `smart-contracts`, (中文(简体) ), `security-without-identification`, (中文(简体) ), `b-money`页:1 `/images/...` 公共路径, 或 HTTPS URL; 省略 `cover` 仅限文本卡。 这需要匹配的转发解码器路径 `messages.decoderPage.readings` 改为 `DecoderReadings`。 。 。 . 这些可选字段使用已存在的回落消息链. 英文配置的致敬或完整的列表可以服务回落的地语;每个语言的覆被优先. 没有这些场地配置,构成部分提供本地化的内置副本。 文本是纯文本,而不是HTML;被承认的本地化的 Cypherpunk 名称得到自动强调. 自定义 `links` 条目需要非空标题和 HTTP(S) 或 root- relative URL; 无效条目被省略。 公共图像路径和内部链接尊重Astro基础路径. 配置更改后重建并重新部署 . ```ts // Inside i18n.locales.en (or another locale): messages: { decoderPage: { readings: { tribute: 'Ideas and code in service of privacy and freedom.', links: [{ title: 'My reading', href: 'https://example.com/', cover: 'privacy-code' }], }, }, }, ``` 大约包括Hacker解码器用于本地 Base64/Base64URL,URL,Hex,HTML实体,Unicode逃生和JWT头/活口解码,有翻译控制,自动检测和带有主机特定颜色的共享数字结果动画. ## 安装 增加0.16.0 版本 `i18n.locales..site.homeTitle` 对于可见的主页标题。 非空的修剪文本遵循了地语后退链,然后是全球站点名称;站点元数据和共享的铬仍然是全球性的. 使用匹配的启动器计划/ 运行时间/ 站点适配器 。 自定义集成必须导出 `getHomeTitle(locale): string` 结束 `@anglefeint/site-config/site`; 直接包默认返回 `SITE_TITLE`。在安装此释放前, 老年启动者需要迁移;见 [升级步骤](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md#0160-localized-homepage-headings)。 。 。 . 可选 GA4 可用匹配的 0: 00 启动器 。 设置顶级 `analytics.googleAnalyticsId: 'G-XXXXXXXXXX'` 在现有的 `src/site.config.ts` 配置、重建和部署。 空会禁用它; 一个测量ID会覆盖所有语言. 开发及本地主机/loopback预览不在此列;远程和局域网预览不在此列. 检查GA4部署地点实时报告. 不包括同意标语/管理;必要时在许可前安排同意处理,并避免重复GTM/Zaraz/手动标记。 仅升级 npm 不添加新的启动器计划/ 默认/ 适应器; 遵循 [更新(md)](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md)。手动软件包消费者地图 `THEME.ANALYTICS.GOOGLE_ANALYTICS_ID` 通过其现有的站点配置别名. ```bash npm install @anglefeint/astro-theme ``` ## 升级 0.21.0, 合并根 `"overrides": { "fflate": "0.7.5" }` 进入现有的消费项目,然后重新合并。 相匹配的启动器已经包含此补丁,用于佐藤里被绑定的压缩依赖性. 依赖软件包不能强制执行根覆盖;整合/配置迁移也见 UPGRADING. ```bash npm update @anglefeint/astro-theme ``` 对于启动项目,当脚手架命令改变时审查寄存器释放注释. 如果老项目还在行驶 `npm run new-post` 或者说 `npm run new-page` 通过本地包装文件, 将软件包脚本迁移到软件包拥有的 bins : ```bash npm pkg set scripts.new-post="anglefeint-new-post" npm pkg set scripts.new-page="anglefeint-new-page" ``` ## 主页和甲骨文 主页增加了相继的终端文本,4个被洗发的白兔解码器,以及一个局部断裂/液态镜像,这些镜像在点击后进行修复直至刷新. 可选 `theme.effects.enableHomePassage` 默认为 `false`;使其能在主页后链接中增加8秒的绿色通道. 匹配的启动器将此字段映射到 `THEME.EFFECTS.ENABLE_HOME_PASSAGE`。关于添加独立的 `Oracle` 按钮,带有4个点击选择的调色板,不立即重复调色板,拖入外观探索,右键点击倒转出行,以及Escape/×解职。 减少运动使用本土家用导航和静态甲骨文预览. 完整特性需要启动程序/ 默认/ 适应器和“ About ” 路径的迁移; 见 [更新(md)](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md)。现有的可选音乐播放器按页面氛围选择其演示文稿;音频配置和回放控制不变. 宽屏主页终端使用与About相同的通道播放器. 它的文本可以选择并滚动;单独的密钥孔按钮开始预览. 配置 `i18n.locales.en.messages.home.transmission` 在匹配启动器中一次 `src/site.config.ts`,然后可选择覆盖单个语言。 分辨率是当前语言配置 → 英语配置 → `Knock, knock.`。这需要更新的启动器消息适配器以及软件包;仅更新npm并不能取代项目拥有的适配器. ## 启动/ 插入中使用 可选音乐(0.7.0)需要匹配的启动子 schema/defaults和主题适配器. 它默认是被禁用,船没有歌曲。 配置 `theme.music` 内 `src/site.config.ts` 与 `enabled: true` 财务报告和审定财务报表 `tracks: [{ title: 'My Song', src: '/music/my-song.mp3' }]`; 将文件放入 `public/music/` 或使用 HTTPS 音频 URL。 Play后第一次访问加载音频;0.8.1版本试图在导航后恢复活动标签会话,当浏览器阻断回放时需要点击. 在更新一个更古老的启动器之前,请参见寄存器 README 和升级指南. **介绍:** `MusicDeck` 在其初始 HTML 中开始压缩。 过 `initiallyCollapsed={false}` 用于桌面或移动上的扩展条目,或用于压缩条目的正本。 明确的初始化可以覆盖取景口和存储的演示文稿;用户仍然可以手动切换. `ThemeFrame` 转发与 `musicInitiallyCollapsed`这些是组件道具,不是新的 `theme.music` 配置字段。 回放恢复保持独立; BFcache 恢复最近保存的演示文稿 。 主页启用的状态项目也开始隐藏,并在徘徊或选择时独立显示;选择全部都显示两者,而块光标只跟随踪迹. 这些变化需要0.18.1或以后. 文章共享图像需要匹配的启动器 `theme.socialImage.enabled` 配置/适应器和 `socialImage()` 从 `@anglefeint/astro-theme/social-image` 在Astro的整合。 软件包拥有预发式的PNG端点,Satori/Sharp渲染,下行字体和捆绑的霓虹网背景. 卡片保留了用户的网站/标题/作者; `theme.footer.showCredits: false` 也隐藏右下方 `Theme by Anglefeint` 图像信用. 重建并部署以更新生成的 URL; 自定义 `ogImage` 文件从不盖章。 条款 `ogImage` 独立于 `heroImage`; 查看存储器 README 图像路径和禁用开关 。 这种能力需要0.5.0及其相匹配的起步器;0.4.0不包括. 使用页面/线程中的软件包导出, 例如 : ```astro --- import HomePage from '@anglefeint/astro-theme/layouts/HomePage.astro'; --- ``` 内容方案: ```ts export { collections } from '@anglefeint/astro-theme/content-schema'; ``` `sourceLinks` 在博客前题接受标准 `http(s)` URL 和空域, 如 `github.com/anglefeint/astro-theme-anglefeint`。将空域正常化为 `https://...` 在计划解析时. ## 条款内容 从0.25.0起,文章元数据显示现有 `author` 前题值或站点作者; 只有一个站点作者名称, 带有启用的链接到该本地化页面, 并将其URL添加到文章结构化的数据中 。 H2/H3复制图标再用已存在的ID,复制犬科的URL并显示成功内线,失败时有手抄字段. 匹配的0.24.1起动器不需要新的所需的配置或项目路由变化. 自0.8.5起, `BlogPost` 自动发现启用的、 已存在的用于标准的同斯lug 翻译 `//blog//` 文章 URL。 现有的0.83/0.8.4起步器只需要兼容的软件包更新,重建和部署;不需要路由编辑或新的作者设置. SEO 替代选项在语言菜单中不包括缺失的翻译 `localeHrefs` 保持它的倒数. `x-default` 在缺缺默认语言翻译时被省略。 可选 `seoLocaleHrefs` 0.8.4中引入的仍是一个明确的覆被,包括一个空的地图,用于不发射任何数据。 标准模式外的自定义路由需要覆盖以释放替代;自动发现不会猜测它们的URL. `BlogPost` 接受可选 `headings` 从 `const { Content, headings } = await render(post)`。通过这些和文章数据一起传递,使其能为 Markdown h2/h3 标题提供其原生、可折叠的目录。 面板将右侧接入宽屏幕,并用窄屏幕出现在身体前. 没有标题表示没有内容。 可选布尔前事字段 `toc` 覆盖 `THEME.TOC.ENABLED` (默认) `true`; 启动用户配置默认值 `theme.toc.enabled`。MDX 组件生成和原始 HTML/JSX 标题不自动收集. ## 站点配置注入 本套件从别名导入读取特定地点的配置 : - `@anglefeint/site-config/site` - `@anglefeint/site-config/theme` - `@anglefeint/site-config/social` - `@anglefeint/site-i18n/config` - `@anglefeint/site-i18n/messages` 在启动/现场项目中,将这些别名映射到 `src/config/*` 财务报告和审定财务报表 `src/i18n/*` 在Vite和TS配置中. 光是包安装并不能配置这些别名 。 手动集成必须明确提供;捆绑后倒置配置文件不会自动解决缺失的别名. Giscus 注释从站点侧面配置 `theme.comments` (核心ID + 行为字段如 `mapping`, (中文(简体) ), `inputPosition`, (中文(简体) ), `theme`,以及 `lang`) (中文(简体) ). 如果没有设置必要的核心字段,则不提供注释. 何时 `mapping="specific"` 设定 `term`; 当 `mapping="number"` 设定 `number`。 。 。 . ## 国 际 - `anglefeint-new-post` - `anglefeint-new-page` CLI 后执行您信任的 `src/site.config.ts` 与 Jiti 并使用合并的,启用的地籍登记。 配置失败在写入文章前停止生成 . `--locales` 优先于 `ANGLEFEINT_LOCALES`,然后配置地块; 明确覆盖跳过配置加载。 缺少配置需要明确的覆盖 。 现有员额从未被重叠. 明确的本地化覆盖只创建内容文件 。 它们不会在站点配置中添加/允许的地块;路线仍然需要启用目标地块. 默认封面选择对于固定的排序封面集和sult是稳定的;添加或去除封面可以改变未来生成的帖子的任务. 实例: ```bash # create one post slug in all default locales npx anglefeint-new-post my-first-post # create post only for selected locales npx anglefeint-new-post my-first-post --locales en,fr # or via environment variable ANGLEFEINT_LOCALES=en,fr npx anglefeint-new-post my-first-post # create a custom page with theme variant npx anglefeint-new-page projects --theme base npx anglefeint-new-page projects --theme ai npx anglefeint-new-page projects --theme cyber npx anglefeint-new-page projects --theme hacker npx anglefeint-new-page projects --theme matrix ``` 在安装主题的工程内运行这些 . `npx` 解析软件包的本地二进制; 本地 npm 安装不会将它们放到普通终端的 PATH 上 。 启动项目已经提供 `npm run new-post -- ...` 财务报告和审定财务报表 `npm run new-page -- ...`. 环境可变示例使用POSIX shell语法. 对于大多数用户来说, `#starter` 是推荐的安装路径. ## 机器可读文章 匹配启动器还预设了仅构建 `@anglefeint/astro-theme/machine-readable` 一体化。 正常构建生成 `/llms.txt`,每个语言的索引/全文捆绑和文章Markdown伴奏,发现链接在文章HTML中。 站点身份,URL,语言和公共元数据来自现有的设置/页面;不需要额外的配置或服务器. 自定义集成可以调用 `machineReadable({ title, description })` 内 `astro.config.mjs`删除旧的 `public/llms.txt` 迁移时的占位符;用户授权的相冲突文件永远不会被覆盖。 导出不包含索引页并排除导航/玩家/装饰内容; `search: false` 控制网站搜索,而不是公开的Markdown。 文件在构建/预览后可用,在dev期间不可用. 见 [更新(md)](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md) 用于现有项目. ## 静态文章搜索 登记册 `import search from '@anglefeint/astro-theme/search'` 在Astro的整合中 `search({ enabled: THEME.SEARCH.ENABLED })`。建成后, 整合写道 `pagefind/` 输入 Astro 输出目录。 软件包拥有依赖性,索引钩和对话框;启动器提供配置和集成注册. 仅 `BlogPost` 标出面板 `data-anglefeint-search` 其索引仅限于标题、字幕和正文。 前题 `search: false` 排除一条。 默认 `theme.search.enabled: true` 控制用户界面和索引. 索引仅在打开搜索后加载,使用当前的HTML语言. 在构建 + 预览中进行全面搜索并部署静态输出. Dev模式显示指令 。 此集成以静态输出为目标,不需要搜索服务器. ## 标签浏览 0.0版本支持 `theme.tags.enabled` (默认) `true`)和条款 `tags: string[]`启动器拥有 `/[lang]/tags/` 路由使用软件包标签和共享博客卡生成静态的每个语言档案。 采用此特性时包含新路由; 仅更新 npm 包不会安装路由 。 使用匹配的当前启动器 . ## 音乐会续会 与现有的 `theme.music` 配置, 0. 8.1 尝试在导航或重装后恢复活动标签会话. 手动暂停停止 。 第一次访问不会自动播放;被屏蔽的尝试显示一个局部的点击到连续的信息. 短暂中断是可能的。 不需要客户路透、新的依赖或配置字段。 请参看配置的主要README和兼容启动要求的UPGRADING. 音频在回放前被完全下载到浏览器 Blob,使得寻求独立于HTTP Range支持. 大轨和慢接会增加起动时间和内存使用. 外部音频主机必须允许跨源获取( CORS); 同源文件 `public/music/` 不需要 CORS 配置 。 暂停/ 恢复重用已装入的轨迹; 切换轨迹释放出轨迹 。 页面导航再次加载了音轨,但受浏览器HTTP缓存的限制. ## 社会联系关系 每个 `social.links` 条目接受可选 `rel: 'me'` 或诸如 `'me nofollow'`,独立于其平台/icon. 主题小写和折叠符号,总是保留 `noopener noreferrer`,而忽略冲突 `opener`. 允许/关闭 `rel` 保留现有行为。 内建的图标,本地图像和文本链接都支持;没有任意的HTML属性被曝光. 使用 `me` 只是为了你自己的身份 对于 [马斯托登核查](https://docs.joinmastodon.org/user/profile/#link-verification),将网站部署,然后将其 HTTPS URL 保存在您的 Mastodon 配置字段中。 使用包含后链接的页面( 例如) `/en/`;根 HTML 重定向页面可能不包含它。 链接存在于静态的HTML中,但成功验证取决于Mastodon服务器到达页面并匹配配置 URL. 匹配0.11.x启动器不需要配置迁移;安装 `@anglefeint/astro-theme@^0.12.0` 在小版本范围的升级时明确. ## 关于换行符 关于正文段落和签名保存所配置的行换行符(`\n` 编号 : `\n\n`),而长的文本仍然被包裹. 内容仍为纯文本 `
` 不作解释。 不需要配置迁移 . ## 额记额 版权、本地化主题/Astro信用和可选 `site.tagline` 占据不同的群体,然后是社会图标。 空标签行不需要空格; 长文本包在移动上 。 信用跟随页面语言,而自定义标记线在语言之间保持不变。 现有设置和 `PUBLIC_SITE_TAGLINE` 覆盖工作时没有计划或适配器迁移. 页脚显示构建年份和站点标题,默认情况下链接到Anglefeint/Astro信用. 使用匹配的0.8.0启动配置, 设置 `theme.footer.showCredits: false` 以省略两个信用链接。 版权和习俗 `site.tagline` 保留; 前一个默认标签行 `Built with Astro.` 以内置的信用为代表,以避免重复。 新标签行默认为空 。 在更新一个更古老的启动器之前, 请参看用户指南 3 和 UPGRADING . ## 代码块复制 条款 `pre > code` 块包括自动右上方复制按钮,带有本地化的成功/失败反馈. 复制使用 `code.textContent` 和浏览器 Clippboard API; 需要HTTPS/localhost和浏览器权限. 内置代码不包含. 不需要额外的依赖性,配置开关或作者标记. ## 图像预览 文章体外链接/按钮的图像包括带键盘/回放解析和本地化标签的本土模式预览. 英雄图像被排除在外. 预览使用 `currentSrc || src`,而不是单独获取的全解析正本,并恢复滚动/注重解职。 它随文章运行时间而初始化;没有图像表示没有模式. 没有画廊导航、手势缩放或配置开关。 不需要额外依赖或作者加价. ## 数学公式 Markdown和MDX的文章默认支持全球的LaTeX风格数学. 写入 `$C_{saved}$` 插入或将公式设置在分离之间 `$$` 线条。 不需要每站旗或额外插件安装. ```markdown Inline: $C_{saved}$ $$ \frac{a}{b} $$ ``` 禁用为 `theme: { math: { enabled: false } }` 内 `src/site.config.ts`。逃职美元 `\$` ; 代码跨度和栅栏代码仍为文字。 已失效的数学恢复了正常的MDX规则,包括在括号中的JavaScript表达式. 渲染发生在构建时,有本地的KaTeX风格/fonts和可访问的MathML,没有浏览器数学引擎. 长显示公式水平滚动 。 无效的公式用源/error消息停止构建 。 保留标题和描述纯文本;公式被排除在搜索索引之外。 所支持的数学是KaTeX语法,而不是完整的LaTeX文档. 旧项目需要升级指南所描述的一次性启动/配置迁移;仅更新主题包不会给Markdown处理器接线. ## 静态部署和文章统计 匹配启动器将静态文件构建到 `dist/`。将其内容上传到服务目录的静态服务器 `index.html` 文件; Cloudflare 和一个生产节点.js 进程不需要。 在建设前设定公共网站 URL 。 可选GA4,评论和远程音频仍然与各自的服务联系. 启动者估计出来自源文本的单词, 默认符号为 `round(max(words, 1) × 1.3)`。这些不是随机值,也不是实际的AI用法。 前题 `wordCount`, (中文(简体) ), `tokenCount` 财务报告和审定财务报表 `readMinutes` 独立覆盖他们的值。 公式和MDX源可以影响估计. 见寄存器 [条款统计参考](https://npmcn.com/package/docs/ARCHITECTURE.md#article-statistics) 准确的规则和显示限制. ### 可选的机器可读上下文 过 `aiReadableContent: THEME_CONFIG.aiReadableContent` 财务报告和审定财务报表 `locales: THEME_CONFIG.i18n.locales` 对建设一体化。 单位 `src/site.config.ts`选项 `aiReadableContent.notes` (马克倒地)和 `aiReadableContent.links` (单位:千美元)`{ label, href }[]`),在 `i18n.locales..aiReadableContent`。Oindient字段在全球继承;空字符串/阵列隐藏它们。 根索引使用全局语境;语言索引/全文和单个Markdown使用本地化语境,独立于文章文本. 见 [配置、链接分辨率和迁移](https://github.com/anglefeint/astro-theme-anglefeint/blob/main/UPGRADING.md#optional-machine-readable-context)政策表明作者的意图,但不能保证作者遵守. ## 常见问题 ### @anglefeint/astro-theme 是什么？ Astro 的 Anglefeint 核心主题软件包 ### 如何安装 @anglefeint/astro-theme？ 在项目目录运行 npm install @anglefeint/astro-theme，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：astro（^7\.3\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 anglefeint-new-page、anglefeint-new-post，可以用 npx anglefeint-new-page 直接运行。 ### @anglefeint/astro-theme 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @anglefeint/astro-theme 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @anglefeint/astro-theme 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @anglefeint/astro-theme 可以商用吗？ @anglefeint/astro-theme 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @anglefeint/astro-theme 的下载量有多少？ 根据 npm 官方下载统计，@anglefeint/astro-theme 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,505 次，日均约 117 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @anglefeint/astro-theme 还在维护吗？ 最新版本 0\.25\.0 发布于 2026/11/05（1 天前）；至今共发布 95 个版本，其中过去 12 个月发布了 95 个；首次发布于 2026/02/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。