参与贡献

RunEntLinux 是一个文档项目，欢迎任何形式的贡献。

贡献方式

反馈问题

如果发现内容错误、过期命令或不准确的描述，欢迎通过以下方式反馈：

• 在 GitHub Issues 提交问题
• 点击每篇文章底部的「在 GitHub 上编辑此页」，直接修改并提交 PR

补充内容

如果你想补充新的教程或完善现有内容：

1. Fork 仓库并创建分支
2. 按 WRITING_GUIDE.md 的规范编写；新增页面需同时提供中英文两个版本
3. 在 astro.config.mjs 的 sidebar 中注册新页面
4. 提交 PR，并说明改动内容

写作规范

文件格式

• 纯文本教程使用 .md，需要组件交互的用 .mdx
• 文件名使用英文 kebab-case：dnf-basics.mdx
• 每个文件必须有 title 和 description frontmatter

命令示例

• $ 前缀表示普通用户，# 表示 root
• 推荐使用 sudo 而非切换到 root
• 每个代码块加 title 说明用途
• 标注适用的发行版和版本

风格

• 使用「你」称呼读者
• 段落简短，每段不超过 5 行
• 避免连续使用两个 admonition
• 术语统一：DNF、SELinux、systemd、firewalld、NetworkManager

内容结构

教程页推荐结构：

1. 一句话导语
2. 「你将学到」列表
3. 前置条件
4. 分步骤正文
5. 常见问题
6. 延伸阅读

详细规范参见项目中的 WRITING_GUIDE.md。

本地开发

安装依赖并启动开发环境

$ npm install
$ npm run dev

浏览器访问 http://localhost:4321/ 预览。

构建生产版本

$ npm run build