Stellaris Mod Document 群星 Mod 制作文档

本仓库部署于 pdxdoc-next @ netlify。

贡献指南

本仓库使用 pnpm 作为统一包管理工具。

文档部分

主文档内容位于 ./src/content/docs/guides 目录下。

如果你想要添加新的页面，在创建并编写完成后，修改侧边栏定义（位于 src/sidebar/guides.ts 中）并将你的文档置于合适的分类下。

注意

在修改侧边栏后，需要重启整个应用程序，因为这一配置直接被 astro.config.mjs 引用而无法热重载。

代码块

本仓库使用 Expressive Code 进行代码语法高亮，基于 Shiki 引擎。

内置语言支持：

• 本仓库提供了内置的 Paradox 脚本语言语法高亮，使用 pdx，pdx-lang 或 pdx_lang 即可
• VDF (Valve Data Format) 支持，使用 vdf 语言标识符
• YAML 支持增强

添加新语言支持：

如果想要增加新的语言支持，需要在 src/code/ 目录下添加对应的 TextMate 语法定义文件（.grammar.json 格式），然后在 astro.config.mjs 的 expressiveCode.shiki.langs 配置中引用：

shiki: {
    langs: [
        JSON.parse(fs.readFileSync("./src/code/your-lang.grammar.json", "utf-8")),
        // ... 其他语言
    ],
},

可用功能：

• 支持全屏模式查看代码
• 行号显示
• 双主题支持（深色/浅色模式）
• 语法高亮基于 Shiki，支持大量编程语言

博客

博客内容位于 ./src/content/docs/blog 目录下。

关于博客可选内容的更多信息，参考 Github: starlight-blog by HiDeoo。

如果你想要发表博客，请将你的个人标识添加到 author.ts 中。你的个人头像应该放在 ./public/authors 文件夹下。

其他注意事项

1. 在修改侧边栏 sidebar.json 或作者组 author.ts 后，需要重启整个应用程序，因为这些配置直接被 astro.config.mjs 引用而无法热重载。
2. 文章的图片应该放置于 .assets 结尾的子域中，例如：
   文章 src/content/docs/blog/practical_editor.mdx 的图片应放置在 src/content/docs/blog/practical_editor.assets/ 文件夹下。
3. 文章应配备合适的摘要，文件名不使用中文或中文拼音。

Emoji

当前，Starlight/Astro 并不支持 :emoji_code: 形式调用 emoji，需要复制原文。

以下是常见 emoji 列表：Github Gist: Emoji List。

构建命令

所有命令应该在终端中在项目根目录下运行：

命令	行为
pnpm install	下载依赖
pnpm run dev	在 localhost:4321 处启动开发服务器
pnpm run build	将站点构建于 ./dist/ 目录下
pnpm run preview	在部署前本地预览站点
pnpm run astro ...	运行 Astro 命令行程序，例如 astro add、astro check
pnpm run astro -- --help	获取 Astro 命令行程序的帮助

致谢

本站点基于 Astro 构建，UI 配置基于 Starlight。