Wiki Repository

贡献指南

秉承着知识属于我们每一个人的信念，网络维护科Wiki欢迎每一个人贡献内容。同时，网络维护科感谢为网络维护科Wiki做出过贡献的每一个人。

文档格式

所有Wiki页面均使用Markdown语言撰写。你可以通过马克飞象的样例文档了解如何开始上手并撰写Markdown文档。

贡献途径

目前可以通过在线编辑和提交至Git仓库两种方式贡献内容。

Git

所有Wiki页面的源文件都存放在 Github 仓库上， Wiki系统会定时(每5分钟)从Github仓库拉取最新内容并更新。

你如果你不了解什么是Git，我们为你准备了一个入门教程(中文)

Tips: 若想快速同步，请登录Wiki网站，执行设置->系统信息->管理工具->清空缓存和重建索引。

直接提交至代码仓库

若你拥有直接向Git仓库提交代码的权限，你可以通过直接向代码仓库提交commit的方式贡献内容。

通过创建Pull Request

目前，每一个人都可以通过提交 Pull Request 的方式向代码仓库提交更改。

你可以点击这里了解如何创建 Pull Request。

在线编辑

如果你拥有在线页面的编辑权限，你可以直接使用在线编辑器在浏览器中对页面直接进行更改。

文件名称

系统只会识别 kebab-case 的文件，并为其生成Wiki页面。

文件名	是否识别
`foo`	Y
`FOO`	N
`foo_bar`	N
`fooBar`	N
`foo-bar`	Y

编辑规范

为了便于协作以及维护，请遵循该规范

故障页
- 名称: 故障故障代码-故障名称 eg. 故障651-物理连接错误
- 路径: /article/fault文件夹
- 内容要求: 需要有原因及相应的解决方案
- 上传的文件
  - 名称: 故障代码-文件名称 eg. 651-overview.png
  - 路径: /uploads文件夹
科普页
- 名称: 科普-文章名称 eg. 科普-DNS服务器介绍
- 路径: /article/polular文件夹
- 内容要求: 科普性质的文章，内容准确，语言通俗易懂
- 上传的文件
  - 名称: kp-文章标题前六个字符的拼音首字母小写-文件名称 eg. kp-dnsfwq-overview.png
  - 路径: /uploads文件夹

新建文章

使用在线编辑器
1. 点击右上角的创建按钮
2. 输入新页面的路径（若为故障页面，推荐 /article/文件名称）
3. 点击创建即可
4. 更新索引页
使用编辑器
1. 在需要的位置新建一个Markdown文件即可
2. 更新索引页

编辑文章

使用在线编辑器
1. 打开想要编辑的页面，点击右上角的编辑按钮
2. 进行编辑，然后点击右上角的保存即可
使用编辑器
1. 打开想要编辑的文件，更改即可

如何上传文件

使用在线编辑器
1. 进入编辑页面
2. 点击工具栏的 Insert Image 或者 Insert File按钮
3. 点击 上传图片，选择上传的图片或者文件即可
使用编辑器
1. 将文件放进你想放进的文件夹

如何移动页面

使用在线编辑器
1. 进入要移动的页面
2. 点击右上角移动按钮
3. 输入新的路径
4. 点击移动即可
5. 更新索引页
使用编辑器
1. 直接更改文件路径即可
2. 更新索引页

如何删除页面

使用在线编辑器
1. 进入要删除的页面
2. 点击右上角垃圾桶的图标
3. 然后点击确定即可
4. 更新索引页
使用编辑器
1. 直接删除文件即可
2. 更新索引页

如何找到已创建的页面的URL

使用在线编辑器
1. 点击网站左上角的 所有页面 按钮
2. 找到想找的页面
3. 复制浏览器地址栏的URL
使用编辑器
1. 自己算吧233333

如何创建Overview栏

将下面的模版代码，放在 SUBTITLE 下，请不要在标签前加空格

<!-- overview: 请将代码放于 SUBTITLE 下 -->
<div class="overview" style="float:right;width:280px;padding:10px;margin:10px;border: 1px solid #4054b2;background-color: #f9f9fb;">
<div class="overview-header" style="width:100%;margin: 5px 0;text-align: center;">
<h3 style="margin:0 0 10px;">物理连接错误</h3>

<img style="display:block;width:100%;max-width:100%;margin-left:-10px;" src="/uploads/651-overview.png" />
</div>

<div class="overview-main" style="display: flex; flex-direction: column;padding:10px 5px 0 5px;">
<div class="overview-item" style="display: flex;margin: 5px 0;">
<p style="flex:0 0 100px;padding:0;font-weight: 600;">故障名称</p>
<p style="padding:0;">物理连接错误</p>
</div>

<div class="overview-item" style="display: flex;margin: 5px 0;">
<p style="flex:0 0 100px;padding:0;font-weight: 600;">故障代码</p>
<p style="padding:0;">651</p>
</div>

<div class="overview-item" style="display: flex;margin: 5px 0;">
<p style="flex:0 0 100px;padding:0;font-weight: 600;">所属运营商</p>
<p style="padding:0;">移动、联通</p>
</div>
</div>
</div>

对代码进行修改即可

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

ZSCNetSupportDept/wiki