1
0
mirror of https://github.com/ZSCNetSupportDept/website.git synced 2025-10-28 00:45:03 +08:00

更新开发组文档,完善wiki的错误码板块,优化了结构

This commit is contained in:
2025-06-21 15:30:30 +08:00
parent 91b2352507
commit 92ae4a93d0
30 changed files with 171 additions and 32 deletions

2
.gitignore vendored
View File

@@ -18,3 +18,5 @@
npm-debug.log*
yarn-debug.log*
yarn-error.log*
/docs/wiki/gitignore

View File

@@ -20,15 +20,7 @@ npm run docusaurus build
然后在`build`文件夹下就出现了编译过后的结果,可以进行下一步的部署
运行`npm run docusaurus deploy`可以自动构建并部署静态网站在构建之后,还会自动将结果推送到仓库的`build`分支上,服务器部署了脚本自动抓取这个分支的内容来更新网站\
如果你有直接push本仓库的权限你可以运行`npm run docusaurus deploy`自动构建并部署静态网站在构建之后,还会自动将结果推送到仓库的`build`分支上,服务器部署了脚本自动抓取这个分支的内容来更新网站\
https://zscdev-demo.pages.dev 是本仓库的一个demo网站基于master构建而不是build
## 部署
参见 https://zscdev-demo.pages.dev/docs/devdocs/网站/开发组网站/开发组网站-部署
## 内容发布
参见文档
## 开发
务必在本地测试好改动后再push
## 关于
若有问题,可以联系开发组组长
针对新手我们有一个教程帮助你快速入门https://zscdev-demo.pages.dev/docs/devdocs/网站/开发组网站/快速上手
任何问题,联系开发组组长~^_^~

View File

@@ -0,0 +1,7 @@
---
description: 项目的概述
---
# 概述
网维原来的老报修系统从13年开始开发16年完成的第二版一直用到了现在2025年确实有必要更新了

View File

@@ -0,0 +1,3 @@
{
"description": "..."
}

View File

@@ -1 +1,8 @@
# 网维报修系统
网维的新报修系统
import DocCardList from '@theme/DocCardList';
<DocCardList className="docs-card" />

View File

@@ -0,0 +1,24 @@
---
description: 项目的概述
---
# 概述
项目的概述
## 介绍
本站采用Docusaurus框架Docusaurus是一个静态网页生成器也就是说项目的构建目标是一堆静态网页文件拿去给HTTP服务器部署
要想为网站写内容只需要把写好的Markdown丢进项目特定的路径里Docusaurus生成器会自动把文件变成成品网站这样我们可以专注内容写作不用担心其它的
框架本身使用React本地构建时需要对应的前端工具链官方要求的运行时为`Node.js >= 18.0`,至于包管理器,就看个人喜好了,我们以`npm`举例;
## 结构
从项目根目录下开始看起:
- `docs`:存放wiki和开发组文档的内容
- `blog`:存放文章的内容
- `src`:存放其它不是Markdown,但是又属于网站内容的部分;例如独立页面(如首页)自定义CSS和React Component等
- `static`:存放静态文件,内容会被原样拷贝到构建目标的根目录下
- `docusaurus.config.js`:主配置文件
- `sidebars.js`:Sidebar(就是访问`docs`下文档时出现在左边的栏目)配置文件

View File

@@ -0,0 +1,3 @@
{
"description": "..."
}

View File

@@ -0,0 +1,24 @@
# 开发组网站
就是你所看到的网站;这个网站大概包含了三个部分:
1. 网维的新wiki
2. 开发组相关文档
3. 一个博客系统,可以用来放独立的文章
因为感觉没有必要搭建两个基础设施所以把wiki和开发组文档放在一起这样也比较方便运维
网站采用[Docusaurus](https://www.docusaurus.io)框架,详细文档移步官网查看
**项目地址**https://github.com/ZSCNetSupportDept/website
## 目录
import DocCardList from '@theme/DocCardList';
<DocCardList className="docs-card" />

View File

@@ -0,0 +1,2 @@
# 撰写内容
如何向wiki,开发组文档和文章板块添加内容

View File

@@ -0,0 +1,2 @@
# 项目构建与部署
如何构建与部署该项目

View File

@@ -0,0 +1,2 @@
# 项目配置
如何修改项目的配置(界面,行为等)

View File

@@ -6,15 +6,15 @@ import DocsCardList from '@site/src/components/wiki_menu/index';
**你好呀!**
你好呀!
**这里是中山学院网络维护科wiki,记录了我们网络维护工作的知识📝**
这里是中山学院网络维护科wiki,记录了我们网络维护工作的知识📝
**wiki的内容都是历代网维的成员整理总结的欢迎你[贡献自己的内容!](https://github.com/ZSCNetSupportDept/website)**
wiki的内容都是历代网维的成员整理总结的欢迎你[贡献自己的内容!](https://github.com/ZSCNetSupportDept/website/tree/master/docs/wiki)
:::warning 注意
本wiki尚在撰写当中🤗许多条目可能会不完善或者缺失内容😥,请多多包涵;如果你发现本wiki有任何错误的内容,请联系开发组组长🫡
本wiki尚在撰写当中🤗许多条目可能会不完善或者缺失内容请多多包涵😥;如果你在文章中发现了错误,或者对网页的界面和交互体验有建议,请联系开发组组长´ ▽ ` )ノ
:::

View File

@@ -28,8 +28,8 @@
| |**账号格式** |**初始密码** |**备注** |
|- |- |- |- |
|**电信**|`${用户手机号}` |`A1234567` |在电信client中使用这个账号和密码另外有的情况下还要在后面加上一个`@zsdzkd`的后缀(比如在线自助改密码的情况) |
|**联通**|`ZSLAN${用户手机号}@16900.gd`|`900.gd` |在拨号系统里使用这个账号和密码,注意账号可能不准确 |
|**移动**|`${用户手机号}@139.gd` |`手机号后六位` |在移动网页认证里面的绑定环节使用这个账号和密码来绑定|
|**联通**|`ZSLAN${用户手机号}@16900.gd`|`900.gd` |在系统的拨号菜单里使用这个账号和密码,注意账号可能不准确以用户“中国联通”APP上显示的账号格式为准[Click Me](/docs/wiki/故障/联通特定/账号不正确) |
|**移动**|`${用户手机号}@139.gd` |`手机号后六位` |在移动网页认证里面的绑定界面使用这个账号和密码来绑定|
### 认证方式
电信需要下载专用客户端下载地址为:`zsteduapp.10000.gd.cn`,联通使用系统自带拨号渠道即可,对于移动,需要使用网页认证方式,可以去看`技能/电脑技能/拨号`

View File

@@ -0,0 +1,3 @@
{
"description": "运营商之间通用的错误"
}

View File

@@ -1,4 +1,8 @@
# 电信101
# 电信101错误代码
...
## 现象
电信客户端连接失败出现错误代码101
## 原因
1. 可能是电脑没有按照正确的方式接入校园专网环境导致

View File

@@ -1,4 +1,8 @@
# 电信107
# 电信107错误代码
...
## 现象
电信客户端连接失败出现错误代码107
## 原因
- 设备没连通校园网络

View File

@@ -1,4 +1,8 @@
# 电信109
# 电信109错误代码
...
## 现象
电信客户端连接失败出现错误代码109
## 原因
- 此错误为设备网络不通,导致设备与客户端服务连接失败。

View File

@@ -1,4 +1,8 @@
# 电信114
# 电信114错误代码
...
## 现象
电信客户端连接失败出现错误代码114
## 原因
- 由于本机时间不正确导致天翼校园客户端报错

View File

@@ -0,0 +1,3 @@
{
"description": "电信特定的错误"
}

View File

@@ -6,3 +6,9 @@
这篇文章还没有写完呢!😛
:::
## 现象
反复尝试后排除大部分问题,网络仍然无法连通。
## 原因
可能是电信客户端版本过于老旧
## 解决方案
升级客户端

View File

@@ -1,4 +1,8 @@
# 联通651,移动651
# 故障代码651
...
## 现象
联通宽带拨号失败,提示错误代码`651`
## 原因
- 配置错误

View File

@@ -1,4 +1,5 @@
# 联通691移动691
# 故障代码691
...
## 现象
PPPoE宽带拨号提示 `已拒绝远程连接,因为未识别出你提供的用户名和密码组合,或在远程访问服务器上禁止使用选定的身份验证协议` ,甚至提示错误代码`691`

View File

@@ -1,4 +1,7 @@
# 移动,联通711
# 故障代码711
...
## 现象
联通宽带拨号失败,提示错误代码`711`
## 原因

View File

@@ -1,4 +1,7 @@
# 联通,移动720
# 故障代码720
...
## 现象
联通宽带拨号失败,提示错误代码`720`
## 原因
- 网络协议崩溃

View File

@@ -1,4 +1,7 @@
# 联通,移动734
# 故障代码734
...
## 现象
联通宽带拨号失败,提示错误代码`734`
## 原因
- 网络协议崩溃

View File

@@ -0,0 +1,3 @@
{
"description": "联通特定的错误"
}

View File

@@ -1,4 +1,5 @@
# 账号不正确
:::warning 注意
🚧施工中🚧
@@ -6,3 +7,12 @@
这篇文章还没有写完呢!😛
:::
## 现象
已确认网络没有其它的问题,使用默认的账号格式无法登录(找不到用户),用户确认密码正确/没有改过密码,且没有欠费。
## 原因
有些用户的账号格式不同于wiki上写的那样常见于更换宽带的用户
## 解决方案
让用户登录联通APP,查询正确的账号登录

View File

@@ -0,0 +1,3 @@
{
"description": "移动特定的错误"
}

View File

@@ -1,7 +1,13 @@
# 错误
这里列举了维修过程中常见的一些问题和错误代码
这里列举了维修过程中常见的一些问题
当前还有很多的条目没有搬过来可以去看旧版wiki😆
当前还有很多的错误码条目没有搬过来可以去看旧版wiki😆
:::tip 提示
目前这个板块还在紧锣密鼓地编写当中,如果你想与大家分享你在修网过程中遇到的问题和解决方案,欢迎向开发组投稿!
:::
import DocCardList from '@theme/DocCardList';

View File

@@ -18,7 +18,7 @@
}
/* For readability concerns, you should choose a lighter palette in dark mode. */
[data-theme='dark'] {
[data-theme="dark"] {
--ifm-color-primary: #25c2a0;
--ifm-color-primary-dark: #21af90;
--ifm-color-primary-darker: #1fa588;
@@ -43,13 +43,17 @@
max-width: fit-content;
}
html[data-theme='dark'] .markdown h2 {
background: linear-gradient(to right, rgba(255, 255, 255, 0.01), rgba(255, 255, 255, 0));
html[data-theme="dark"] .markdown h2 {
background: linear-gradient(
to right,
rgba(255, 255, 255, 0.01),
rgba(255, 255, 255, 0)
);
border-left-color: var(--ifm-color-primary-light);
}
/* 强制 Mermaid 图表在黑暗模式下使用白色背景 */
html[data-theme='dark'] .mermaid {
html[data-theme="dark"] .mermaid {
background-color: #ffffff !important;
color: #000000 !important;
}
@@ -62,5 +66,8 @@ html[data-theme='dark'] .mermaid {
padding: initial;
border-radius: initial;
background: initial;
}
/*.pagination-nav {
display: none;
}*/