@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版本并匹配起步器计划/默认/适应器更改. 见 移徙自定义集成 : THEME.HOME.SHOW_INITIALIZE/SHOW_FOLLOW/SHOW_TRACE 和链接 THEME.FOOTER.LINKS 通过他们的网站配置化名.
全数 解码器实验室 备查 /<locale>/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节 升级。 。 。 .
解码器读取配置
自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.<code>.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基础路径. 配置更改后重建并重新部署 .
// 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.<code>.site.homeTitle 对于可见的主页标题。 非空的修剪文本遵循了地语后退链,然后是全球站点名称;站点元数据和共享的铬仍然是全球性的. 使用匹配的启动器计划/ 运行时间/ 站点适配器 。 自定义集成必须导出 getHomeTitle(locale): string 结束 @anglefeint/site-config/site; 直接包默认返回 SITE_TITLE。在安装此释放前, 老年启动者需要迁移;见 升级步骤。 。 。 .
可选 GA4 可用匹配的 0: 00 启动器 。 设置顶级 analytics.googleAnalyticsId: 'G-XXXXXXXXXX' 在现有的 src/site.config.ts 配置、重建和部署。 空会禁用它; 一个测量ID会覆盖所有语言. 开发及本地主机/loopback预览不在此列;远程和局域网预览不在此列. 检查GA4部署地点实时报告. 不包括同意标语/管理;必要时在许可前安排同意处理,并避免重复GTM/Zaraz/手动标记。 仅升级 npm 不添加新的启动器计划/ 默认/ 适应器; 遵循 更新(md)。手动软件包消费者地图 THEME.ANALYTICS.GOOGLE_ANALYTICS_ID 通过其现有的站点配置别名.
npm install @anglefeint/astro-theme
升级
0.21.0, 合并根 "overrides": { "fflate": "0.7.5" } 进入现有的消费项目,然后重新合并。 相匹配的启动器已经包含此补丁,用于佐藤里被绑定的压缩依赖性. 依赖软件包不能强制执行根覆盖;整合/配置迁移也见 UPGRADING.
npm update @anglefeint/astro-theme
对于启动项目,当脚手架命令改变时审查寄存器释放注释. 如果老项目还在行驶 npm run new-post 或者说 npm run new-page 通过本地包装文件, 将软件包脚本迁移到软件包拥有的 bins :
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)。现有的可选音乐播放器按页面氛围选择其演示文稿;音频配置和回放控制不变.
宽屏主页终端使用与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不包括.
使用页面/线程中的软件包导出, 例如 :
---
import HomePage from '@anglefeint/astro-theme/layouts/HomePage.astro';
---
<HomePage {...Astro.props} />
内容方案:
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 翻译 /<locale>/blog/<slug>/ 文章 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-postanglefeint-new-page
CLI 后执行您信任的 src/site.config.ts 与 Jiti 并使用合并的,启用的地籍登记。 配置失败在写入文章前停止生成 . --locales 优先于 ANGLEFEINT_LOCALES,然后配置地块; 明确覆盖跳过配置加载。 缺少配置需要明确的覆盖 。 现有员额从未被重叠.
明确的本地化覆盖只创建内容文件 。 它们不会在站点配置中添加/允许的地块;路线仍然需要启用目标地块. 默认封面选择对于固定的排序封面集和sult是稳定的;添加或去除封面可以改变未来生成的帖子的任务.
实例:
# 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) 用于现有项目.
静态文章搜索
登记册 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 URL 保存在您的 Mastodon 配置字段中。 使用包含后链接的页面( 例如) /en/;根 HTML 重定向页面可能不包含它。 链接存在于静态的HTML中,但成功验证取决于Mastodon服务器到达页面并匹配配置 URL. 匹配0.11.x启动器不需要配置迁移;安装 @anglefeint/astro-theme@^0.12.0 在小版本范围的升级时明确.
关于换行符
关于正文段落和签名保存所配置的行换行符(\n 编号 : \n\n),而长的文本仍然被包裹. 内容仍为纯文本 <br> 不作解释。 不需要配置迁移 .
额记额
版权、本地化主题/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}$ 插入或将公式设置在分离之间 $$ 线条。 不需要每站旗或额外插件安装.
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源可以影响估计. 见寄存器 条款统计参考 准确的规则和显示限制.
可选的机器可读上下文
过 aiReadableContent: THEME_CONFIG.aiReadableContent 财务报告和审定财务报表 locales: THEME_CONFIG.i18n.locales 对建设一体化。 单位 src/site.config.ts选项 aiReadableContent.notes (马克倒地)和 aiReadableContent.links (单位:千美元){ label, href }[]),在 i18n.locales.<code>.aiReadableContent。Oindient字段在全球继承;空字符串/阵列隐藏它们。 根索引使用全局语境;语言索引/全文和单个Markdown使用本地化语境,独立于文章文本. 见 配置、链接分辨率和迁移政策表明作者的意图,但不能保证作者遵守.