参与贡献

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

贡献方式

反馈问题

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

• 发送邮件至项目维护者
• 在社区渠道中提出

补充内容

如果你想补充新的教程或完善现有内容，请联系项目维护者获取贡献指引。

写作规范

文件格式

• 纯文本教程使用 .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