参与贡献

RunEntLinux 是一个文档项目。本页说明反馈方式与写作规范。

贡献方式

反馈问题

如果发现内容错误、过期命令或不准确的描述，请反馈给本站维护者，并附上页面地址、系统版本和实际输出（去掉密钥等私人信息）。

补充内容

本站内容由维护者统一维护。补充新的教程或完善现有内容时：

1. 按 WRITING_GUIDE.md 的规范编写；新增页面需同时提供中英文两个版本
2. 在 astro.config.mjs 的 sidebar 中注册新页面
3. 说明改动内容与所依据的官方资料

写作规范

文件格式

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