跳到正文
TariTalk
返回

示例文章:TariTalk 的内容结构与写作字段

更新于

这篇文章暂无英文版。

这是演示内容。 本文说明的是站点自身的写作方式,不涉及任何生态项目的事实性判断。

每篇文章是一个 Markdown(或 MDX)文件,按语言放进对应目录:

src/content/posts/zh/my-post.md   →  /posts/my-post/
src/content/posts/en/my-post.md   →  /en/posts/my-post/

TariTalk 的双语内容结构示意图:中文内容在根路径,英文内容在 /en/ 前缀下,两者通过 translationKey 关联

可用字段

字段是否必填说明
langzhen,必须与所在目录一致
title / description标题与摘要,同时用于 SEO 和 RSS
pubDatetime发布时间,带时区
modDatetime更新时间
author默认是站点作者
tags主题键,取值见 src/i18n/topics.ts
translationKey与另一语言的同一篇文章共用的标识
drafttrue 时不进入页面、RSS、Sitemap 和搜索
featured是否在首页“精选文章”中置顶
cover / coverAlt封面图与替代文本,写了封面就必须写替代文本

主题是怎么定义的

主题使用固定的英文键(例如 tariminotariootlextmxtrtechecosystemgovernancecommunity), 中英文各自显示对应的名称,所以同一个主题在两种语言下共用同一个网址。新增主题只需要在 src/i18n/topics.ts 里加一行, 写错主题名时构建会直接报错,不会悄悄发布。

这篇文章没有英文版

这是故意的:用来验证在没有译文时,语言切换会退回到英文文章列表,并明确提示“本页暂无英文版”,而不是产生 404。


分享这篇文章:

上一篇
示例文章:欢迎来到 TariTalk