mirror of
https://github.com/ZSCNetSupportDept/website.git
synced 2025-10-28 00:45:03 +08:00
更新开发组文档,完善wiki的错误码板块,优化了结构
This commit is contained in:
2
.gitignore
vendored
2
.gitignore
vendored
@@ -18,3 +18,5 @@
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
|
||||
/docs/wiki/gitignore
|
||||
|
||||
12
README.md
12
README.md
@@ -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/网站/开发组网站/快速上手
|
||||
任何问题,请联系开发组组长~^_^~
|
||||
|
||||
7
docs/devdocs/02-网维报修系统/01-概述.md
Normal file
7
docs/devdocs/02-网维报修系统/01-概述.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
|
||||
description: 项目的概述
|
||||
|
||||
---
|
||||
# 概述
|
||||
网维原来的老报修系统从13年开始开发,16年完成的第二版一直用到了现在2025年,确实有必要更新了 ,
|
||||
3
docs/devdocs/02-网维报修系统/_category_.json
Normal file
3
docs/devdocs/02-网维报修系统/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "..."
|
||||
}
|
||||
@@ -1 +1,8 @@
|
||||
# 网维报修系统
|
||||
网维的新报修系统
|
||||
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
|
||||
<DocCardList className="docs-card" />
|
||||
|
||||
|
||||
24
docs/devdocs/03-开发组网站/01-概述.md
Normal file
24
docs/devdocs/03-开发组网站/01-概述.md
Normal 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`下文档时出现在左边的栏目)配置文件
|
||||
|
||||
|
||||
|
||||
3
docs/devdocs/03-开发组网站/_category_.json
Normal file
3
docs/devdocs/03-开发组网站/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "..."
|
||||
}
|
||||
24
docs/devdocs/03-开发组网站/index.md
Normal file
24
docs/devdocs/03-开发组网站/index.md
Normal 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" />
|
||||
|
||||
2
docs/devdocs/03-开发组网站/撰写内容.md
Normal file
2
docs/devdocs/03-开发组网站/撰写内容.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# 撰写内容
|
||||
如何向wiki,开发组文档和文章板块添加内容
|
||||
2
docs/devdocs/03-开发组网站/项目构建与部署.md
Normal file
2
docs/devdocs/03-开发组网站/项目构建与部署.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# 项目构建与部署
|
||||
如何构建与部署该项目
|
||||
2
docs/devdocs/03-开发组网站/项目配置.md
Normal file
2
docs/devdocs/03-开发组网站/项目配置.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# 项目配置
|
||||
如何修改项目的配置(界面,行为等)
|
||||
@@ -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尚在撰写当中🤗,许多条目可能会不完善或者缺失内容,请多多包涵😥;如果你在文章中发现了错误,或者对网页的界面和交互体验有建议,请联系开发组组长´ ▽ ` )ノ
|
||||
|
||||
:::
|
||||
|
||||
|
||||
@@ -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`,联通使用系统自带拨号渠道即可,对于移动,需要使用网页认证方式,可以去看`技能/电脑技能/拨号`
|
||||
|
||||
3
docs/wiki/08-故障/01-通用/_category_.json
Normal file
3
docs/wiki/08-故障/01-通用/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "运营商之间通用的错误"
|
||||
}
|
||||
@@ -1,4 +1,8 @@
|
||||
# 电信101
|
||||
# 电信101错误代码
|
||||
...
|
||||
## 现象
|
||||
|
||||
电信客户端连接失败,出现错误代码101
|
||||
## 原因
|
||||
|
||||
1. 可能是电脑没有按照正确的方式接入校园专网环境导致
|
||||
|
||||
@@ -1,4 +1,8 @@
|
||||
# 电信107
|
||||
# 电信107错误代码
|
||||
...
|
||||
## 现象
|
||||
|
||||
电信客户端连接失败,出现错误代码107
|
||||
## 原因
|
||||
|
||||
- 设备没连通校园网络
|
||||
|
||||
@@ -1,4 +1,8 @@
|
||||
# 电信109
|
||||
# 电信109错误代码
|
||||
...
|
||||
## 现象
|
||||
|
||||
电信客户端连接失败,出现错误代码109
|
||||
## 原因
|
||||
|
||||
- 此错误为设备网络不通,导致设备与客户端服务连接失败。
|
||||
|
||||
@@ -1,4 +1,8 @@
|
||||
# 电信114
|
||||
# 电信114错误代码
|
||||
...
|
||||
## 现象
|
||||
|
||||
电信客户端连接失败,出现错误代码114
|
||||
## 原因
|
||||
|
||||
- 由于本机时间不正确导致天翼校园客户端报错
|
||||
|
||||
3
docs/wiki/08-故障/02-电信特定/_category_.json
Normal file
3
docs/wiki/08-故障/02-电信特定/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "电信特定的错误"
|
||||
}
|
||||
@@ -6,3 +6,9 @@
|
||||
这篇文章还没有写完呢!😛
|
||||
|
||||
:::
|
||||
## 现象
|
||||
反复尝试后排除大部分问题,网络仍然无法连通。
|
||||
## 原因
|
||||
可能是电信客户端版本过于老旧
|
||||
## 解决方案
|
||||
升级客户端
|
||||
|
||||
@@ -1,4 +1,8 @@
|
||||
# 联通651,移动651
|
||||
# 故障代码651
|
||||
...
|
||||
## 现象
|
||||
联通宽带拨号失败,提示错误代码`651`
|
||||
|
||||
## 原因
|
||||
|
||||
- 配置错误
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
# 联通691,移动691
|
||||
# 故障代码691
|
||||
...
|
||||
## 现象
|
||||
PPPoE宽带拨号提示 `已拒绝远程连接,因为未识别出你提供的用户名和密码组合,或在远程访问服务器上禁止使用选定的身份验证协议` ,甚至提示错误代码`691`
|
||||
|
||||
|
||||
@@ -1,4 +1,7 @@
|
||||
# 移动,联通711
|
||||
# 故障代码711
|
||||
...
|
||||
## 现象
|
||||
联通宽带拨号失败,提示错误代码`711`
|
||||
|
||||
## 原因
|
||||
|
||||
|
||||
@@ -1,4 +1,7 @@
|
||||
# 联通,移动720
|
||||
# 故障代码720
|
||||
...
|
||||
## 现象
|
||||
联通宽带拨号失败,提示错误代码`720`
|
||||
## 原因
|
||||
|
||||
- 网络协议崩溃
|
||||
|
||||
@@ -1,4 +1,7 @@
|
||||
# 联通,移动734
|
||||
# 故障代码734
|
||||
...
|
||||
## 现象
|
||||
联通宽带拨号失败,提示错误代码`734`
|
||||
## 原因
|
||||
|
||||
- 网络协议崩溃
|
||||
|
||||
3
docs/wiki/08-故障/03-联通特定/_category_.json
Normal file
3
docs/wiki/08-故障/03-联通特定/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "联通特定的错误"
|
||||
}
|
||||
@@ -1,4 +1,5 @@
|
||||
# 账号不正确
|
||||
|
||||
:::warning 注意
|
||||
|
||||
🚧施工中🚧
|
||||
@@ -6,3 +7,12 @@
|
||||
这篇文章还没有写完呢!😛
|
||||
|
||||
:::
|
||||
|
||||
## 现象
|
||||
已确认网络没有其它的问题,使用默认的账号格式无法登录(找不到用户),用户确认密码正确/没有改过密码,且没有欠费。
|
||||
|
||||
## 原因
|
||||
有些用户的账号格式不同于wiki上写的那样,常见于更换宽带的用户
|
||||
|
||||
## 解决方案
|
||||
让用户登录联通APP,查询正确的账号登录
|
||||
|
||||
3
docs/wiki/08-故障/04-移动特定/_category_.json
Normal file
3
docs/wiki/08-故障/04-移动特定/_category_.json
Normal file
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"description": "移动特定的错误"
|
||||
}
|
||||
@@ -1,7 +1,13 @@
|
||||
# 错误
|
||||
这里列举了维修过程中常见的一些问题和错误代码
|
||||
这里列举了维修过程中常见的一些问题
|
||||
|
||||
当前还有很多的条目没有搬过来,可以去看旧版wiki😆
|
||||
当前还有很多的错误码条目没有搬过来,可以去看旧版wiki😆
|
||||
|
||||
:::tip 提示
|
||||
|
||||
目前这个板块还在紧锣密鼓地编写当中,如果你想与大家分享你在修网过程中遇到的问题和解决方案,欢迎向开发组投稿!
|
||||
|
||||
:::
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
|
||||
|
||||
@@ -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;
|
||||
}*/
|
||||
|
||||
Reference in New Issue
Block a user