kami

Kami. (Compatible Plan)

[!WARNING]
兼容计划，仅做一些有趣的功能以及 bugfix

^{如果你发现了 Kami 与 Core 的不兼容问题，请提交 issue 并描述具体问题，团队成员会尽快修复。}

---

Kami is Sunsetting, check here to read more.

[!IMPORTANT]
Next.js 13 低版本中存在内存泄露问题，在 issue 中，该 issue 表示已修复，但是由于 Node.js < 18.17.0 中可能存在漏内存问题，你也需要升级 Node.js 来解决这个问题。

小小空间，大大梦想。

Small space, big dream.

---

Kami 是一个为 Mix Space 打造的主站前端。完美覆盖全部功能。

Live Demo:

• https://dev.innei.ren
• https://www.timochan.cn/
• https://www.suemor.com/
• https://www.miaoer.net/

点击下面按钮，立即部署到 Vercel！

Feature

内容：

• 博文（技术文章）
• 手记
• 说说（一言）
• 动态
• 评论
• 独立页面
• 项目
• 分类/专栏
• etc.

功能：

• 埋点（umami, GA）
• 实时更新（Socket 支持）
• PWA 支持（看上去没必要的功能，在 v3.15.0 中移除）
• 配置动态化

视觉交互：

• 暗色模式
• 响应式支持
• Spring 动效全覆盖
• 打印样式适配（CMD+P）

附加：

• 音乐页
• 追番页

Tech Stack

• React
• NextJS
• Socket.IO

How to usage

在此之前，请先完成部署 Mix Space

参考文档

Clone

此仓库使用 Git LFS 管理图片等大文件，请先安装 Git LFS。

git clone https://github.com/mx-space/kami.git
cd kami
git lfs fetch --all
git lfs pull

方可获取到图片文件。

Markdown 扩展语法

• GFM
• Insert: ++Insert++
• Spoilder: ||Spoilder||
• Mention: {GH@Innei} {TW@Innei} {TG@Innei}
• KateX: $ c = \\pm\\sqrt{a^2 + b^2} $
• Mark: ==Mark==
• React Component (JSX)
• Container: ::: type {params}

支持的 Container

1. Gallery

一个多图展示容器。

::: gallery
![alt](url "title")
![alt](url "title")
:::

2. Banner

提示容器。可选参数 info warning error success

::: banner {info}
一个提示。
:::

或者：支持 info warning error success warn danger

::: warning
警告
:::

::: success
成功
:::

::: info
提示
:::

支持的 React Component

1. LinkCard

<LinkCard id="notes/111" source="self" />
<LinkCard id="https://openai.com" source="external" url="https://openai.com" />

type LinkCardSource = 'gh' | 'self' | 'external'

interface LinkCardProps {
  id: string
  source: LinkCardSource
  className?: string
  url?: string
}

[^1]: URL 脚注引用在正文中会尝试渲染 LinkCard：

• 同站 notes/{id}、posts/{category}/{slug} 走 self
• 其他 http/https 链接走 external（通过 /api/link-preview 拉取 metadata）

Migration to Kami v3

升级 Server 到 v3.13.0 以上，在设置中的「区块与片段」中新建一个名为 kami，引用为 theme，内容为可配置项，可参考： config.example.yaml

配置项

多语言主题覆盖

保留基础片段 theme/kami，并在 Core 的「区块与片段」中按需新增 theme/kami.en 与 theme/kami.ja。Kami 会请求 aggregate?theme=kami&lang=<locale>，由 Core 将对应语言片段深度合并到基础 主题。

覆盖片段只需要包含变更字段。例如可在其中配置 site.title、 site.description、site.introduction，以及菜单、首页分区标题、页脚和社交 提示等已有主题文本；未设置的字段继续使用基础主题或 Core 数据。

Notice

可以在此基础上保留署名进行二次创作，但是禁止用于以盈利为目的一切活动。

License

此项目 GPLv3 授权开源，使用此项目进行的二次创作或者衍生项目也必须开源。

---

风格参考于 保罗的小窝

Kami is Sunsetting

Kami 原本是我用于学习前端时建立的渐进式个人网站项目，随着代码越来越难以维护和 UI 风格越来越混杂，在 2023.6 我决定进行重写此项目。

下一个代替项目将会是 Shiro，当它完成之时，我便不再投入任何精力到 Kami 中。迎接未来总需要舍弃一些东西，非常感谢大家三年来使用 Kami，不管你是谁，都需要对你说声谢谢。

---

Kami was originally a progressive personal website project that I built while learning the front end, but as the code became more difficult to maintain and the UI style became more mixed, I decided to rewrite the project in 2023.6.

The next replacement project will be Shiro, and when it’s done, I won’t put any more effort into Kami. There are always things to let go of when embracing the future, so thank you very much for using Kami for three years, and thank you to whoever you are.

2020 - 2023.