From 92ae4a93d04b2194798a14fc38f517be6b4a463e Mon Sep 17 00:00:00 2001 From: govolokatliai Date: Sat, 21 Jun 2025 15:30:30 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=BC=80=E5=8F=91=E7=BB=84?= =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E5=AE=8C=E5=96=84wiki=E7=9A=84?= =?UTF-8?q?=E9=94=99=E8=AF=AF=E7=A0=81=E6=9D=BF=E5=9D=97=EF=BC=8C=E4=BC=98?= =?UTF-8?q?=E5=8C=96=E4=BA=86=E7=BB=93=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 2 ++ README.md | 12 ++-------- docs/devdocs/02-网维报修系统/01-概述.md | 7 ++++++ docs/devdocs/02-网维报修系统/_category_.json | 3 +++ docs/devdocs/02-网维报修系统/index.md | 7 ++++++ docs/devdocs/03-开发组网站/01-概述.md | 24 +++++++++++++++++++ docs/devdocs/03-开发组网站/_category_.json | 3 +++ docs/devdocs/03-开发组网站/index.md | 24 +++++++++++++++++++ docs/devdocs/03-开发组网站/撰写内容.md | 2 ++ docs/devdocs/03-开发组网站/项目构建与部署.md | 2 ++ docs/devdocs/03-开发组网站/项目配置.md | 2 ++ docs/wiki/01-首页.md | 8 +++---- docs/wiki/05-基础知识/02-学校内的运营商.md | 4 ++-- docs/wiki/08-故障/01-通用/_category_.json | 3 +++ docs/wiki/08-故障/02-电信特定/101.md | 6 ++++- docs/wiki/08-故障/02-电信特定/107.md | 6 ++++- docs/wiki/08-故障/02-电信特定/109.md | 6 ++++- docs/wiki/08-故障/02-电信特定/114.md | 6 ++++- docs/wiki/08-故障/02-电信特定/_category_.json | 3 +++ .../08-故障/02-电信特定/需要升级客户端.md | 6 +++++ docs/wiki/08-故障/03-联通特定/651.md | 6 ++++- docs/wiki/08-故障/03-联通特定/691.md | 3 ++- docs/wiki/08-故障/03-联通特定/711.md | 5 +++- docs/wiki/08-故障/03-联通特定/720.md | 5 +++- docs/wiki/08-故障/03-联通特定/734.md | 5 +++- docs/wiki/08-故障/03-联通特定/_category_.json | 3 +++ docs/wiki/08-故障/03-联通特定/账号不正确.md | 10 ++++++++ docs/wiki/08-故障/04-移动特定/_category_.json | 3 +++ docs/wiki/08-故障/index.md | 10 ++++++-- src/css/custom.css | 17 +++++++++---- 30 files changed, 171 insertions(+), 32 deletions(-) create mode 100644 docs/devdocs/02-网维报修系统/01-概述.md create mode 100644 docs/devdocs/02-网维报修系统/_category_.json create mode 100644 docs/devdocs/03-开发组网站/01-概述.md create mode 100644 docs/devdocs/03-开发组网站/_category_.json create mode 100644 docs/devdocs/03-开发组网站/index.md create mode 100644 docs/devdocs/03-开发组网站/撰写内容.md create mode 100644 docs/devdocs/03-开发组网站/项目构建与部署.md create mode 100644 docs/devdocs/03-开发组网站/项目配置.md create mode 100644 docs/wiki/08-故障/01-通用/_category_.json create mode 100644 docs/wiki/08-故障/02-电信特定/_category_.json create mode 100644 docs/wiki/08-故障/03-联通特定/_category_.json create mode 100644 docs/wiki/08-故障/04-移动特定/_category_.json diff --git a/.gitignore b/.gitignore index b2d6de3..f036a70 100644 --- a/.gitignore +++ b/.gitignore @@ -18,3 +18,5 @@ npm-debug.log* yarn-debug.log* yarn-error.log* + +/docs/wiki/gitignore diff --git a/README.md b/README.md index e3780b9..8869219 100644 --- a/README.md +++ b/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/网站/开发组网站/快速上手 +任何问题，请联系开发组组长~^_^~ diff --git a/docs/devdocs/02-网维报修系统/01-概述.md b/docs/devdocs/02-网维报修系统/01-概述.md new file mode 100644 index 0000000..1a0be8c --- /dev/null +++ b/docs/devdocs/02-网维报修系统/01-概述.md @@ -0,0 +1,7 @@ +--- + +description: 项目的概述 + +--- +# 概述 +网维原来的老报修系统从13年开始开发，16年完成的第二版一直用到了现在2025年，确实有必要更新了 ， diff --git a/docs/devdocs/02-网维报修系统/_category_.json b/docs/devdocs/02-网维报修系统/_category_.json new file mode 100644 index 0000000..795f78d --- /dev/null +++ b/docs/devdocs/02-网维报修系统/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "..." +} diff --git a/docs/devdocs/02-网维报修系统/index.md b/docs/devdocs/02-网维报修系统/index.md index aa9be60..989e885 100644 --- a/docs/devdocs/02-网维报修系统/index.md +++ b/docs/devdocs/02-网维报修系统/index.md @@ -1 +1,8 @@ # 网维报修系统 +网维的新报修系统 + + +import DocCardList from '@theme/DocCardList'; + + + diff --git a/docs/devdocs/03-开发组网站/01-概述.md b/docs/devdocs/03-开发组网站/01-概述.md new file mode 100644 index 0000000..39bac91 --- /dev/null +++ b/docs/devdocs/03-开发组网站/01-概述.md @@ -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`下文档时出现在左边的栏目)配置文件 + + + diff --git a/docs/devdocs/03-开发组网站/_category_.json b/docs/devdocs/03-开发组网站/_category_.json new file mode 100644 index 0000000..795f78d --- /dev/null +++ b/docs/devdocs/03-开发组网站/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "..." +} diff --git a/docs/devdocs/03-开发组网站/index.md b/docs/devdocs/03-开发组网站/index.md new file mode 100644 index 0000000..6966c3c --- /dev/null +++ b/docs/devdocs/03-开发组网站/index.md @@ -0,0 +1,24 @@ +# 开发组网站 +就是你所看到的网站；这个网站大概包含了三个部分： + +1. 网维的新wiki + +2. 开发组相关文档 + +3. 一个博客系统，可以用来放独立的文章 + + + +因为感觉没有必要搭建两个基础设施，所以把wiki和开发组文档放在一起，这样也比较方便运维 + +网站采用[Docusaurus](https://www.docusaurus.io)框架，详细文档移步官网查看 + +**项目地址**：https://github.com/ZSCNetSupportDept/website + + +## 目录 + +import DocCardList from '@theme/DocCardList'; + + + diff --git a/docs/devdocs/03-开发组网站/撰写内容.md b/docs/devdocs/03-开发组网站/撰写内容.md new file mode 100644 index 0000000..5129ac4 --- /dev/null +++ b/docs/devdocs/03-开发组网站/撰写内容.md @@ -0,0 +1,2 @@ +# 撰写内容 +如何向wiki,开发组文档和文章板块添加内容 diff --git a/docs/devdocs/03-开发组网站/项目构建与部署.md b/docs/devdocs/03-开发组网站/项目构建与部署.md new file mode 100644 index 0000000..b78add4 --- /dev/null +++ b/docs/devdocs/03-开发组网站/项目构建与部署.md @@ -0,0 +1,2 @@ +# 项目构建与部署 +如何构建与部署该项目 diff --git a/docs/devdocs/03-开发组网站/项目配置.md b/docs/devdocs/03-开发组网站/项目配置.md new file mode 100644 index 0000000..9066e03 --- /dev/null +++ b/docs/devdocs/03-开发组网站/项目配置.md @@ -0,0 +1,2 @@ +# 项目配置 +如何修改项目的配置(界面，行为等) diff --git a/docs/wiki/01-首页.md b/docs/wiki/01-首页.md index a1c8233..34f7822 100644 --- a/docs/wiki/01-首页.md +++ b/docs/wiki/01-首页.md @@ -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尚在撰写当中🤗，许多条目可能会不完善或者缺失内容，请多多包涵😥；如果你在文章中发现了错误，或者对网页的界面和交互体验有建议，请联系开发组组长´ ▽ ` )ﾉ ::: diff --git a/docs/wiki/05-基础知识/02-学校内的运营商.md b/docs/wiki/05-基础知识/02-学校内的运营商.md index cc78634..9127e5e 100644 --- a/docs/wiki/05-基础知识/02-学校内的运营商.md +++ b/docs/wiki/05-基础知识/02-学校内的运营商.md @@ -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`,联通使用系统自带拨号渠道即可，对于移动，需要使用网页认证方式，可以去看`技能/电脑技能/拨号` diff --git a/docs/wiki/08-故障/01-通用/_category_.json b/docs/wiki/08-故障/01-通用/_category_.json new file mode 100644 index 0000000..3aa2020 --- /dev/null +++ b/docs/wiki/08-故障/01-通用/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "运营商之间通用的错误" +} diff --git a/docs/wiki/08-故障/02-电信特定/101.md b/docs/wiki/08-故障/02-电信特定/101.md index 6cbab5a..ab432a7 100644 --- a/docs/wiki/08-故障/02-电信特定/101.md +++ b/docs/wiki/08-故障/02-电信特定/101.md @@ -1,4 +1,8 @@ -# 电信101 +# 电信101错误代码 +... +## 现象 + +电信客户端连接失败，出现错误代码101 ## 原因 1. 可能是电脑没有按照正确的方式接入校园专网环境导致 diff --git a/docs/wiki/08-故障/02-电信特定/107.md b/docs/wiki/08-故障/02-电信特定/107.md index 0dd254c..dafbd82 100644 --- a/docs/wiki/08-故障/02-电信特定/107.md +++ b/docs/wiki/08-故障/02-电信特定/107.md @@ -1,4 +1,8 @@ -# 电信107 +# 电信107错误代码 +... +## 现象 + +电信客户端连接失败，出现错误代码107 ## 原因 - 设备没连通校园网络 diff --git a/docs/wiki/08-故障/02-电信特定/109.md b/docs/wiki/08-故障/02-电信特定/109.md index c8c09e3..034327a 100644 --- a/docs/wiki/08-故障/02-电信特定/109.md +++ b/docs/wiki/08-故障/02-电信特定/109.md @@ -1,4 +1,8 @@ -# 电信109 +# 电信109错误代码 +... +## 现象 + +电信客户端连接失败，出现错误代码109 ## 原因 - 此错误为设备网络不通，导致设备与客户端服务连接失败。 diff --git a/docs/wiki/08-故障/02-电信特定/114.md b/docs/wiki/08-故障/02-电信特定/114.md index d26777b..8873d43 100644 --- a/docs/wiki/08-故障/02-电信特定/114.md +++ b/docs/wiki/08-故障/02-电信特定/114.md @@ -1,4 +1,8 @@ -# 电信114 +# 电信114错误代码 +... +## 现象 + +电信客户端连接失败，出现错误代码114 ## 原因 - 由于本机时间不正确导致天翼校园客户端报错 diff --git a/docs/wiki/08-故障/02-电信特定/_category_.json b/docs/wiki/08-故障/02-电信特定/_category_.json new file mode 100644 index 0000000..a06880d --- /dev/null +++ b/docs/wiki/08-故障/02-电信特定/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "电信特定的错误" +} diff --git a/docs/wiki/08-故障/02-电信特定/需要升级客户端.md b/docs/wiki/08-故障/02-电信特定/需要升级客户端.md index ad85e35..ed42a7f 100644 --- a/docs/wiki/08-故障/02-电信特定/需要升级客户端.md +++ b/docs/wiki/08-故障/02-电信特定/需要升级客户端.md @@ -6,3 +6,9 @@ 这篇文章还没有写完呢！😛 ::: +## 现象 +反复尝试后排除大部分问题，网络仍然无法连通。 +## 原因 +可能是电信客户端版本过于老旧 +## 解决方案 +升级客户端 diff --git a/docs/wiki/08-故障/03-联通特定/651.md b/docs/wiki/08-故障/03-联通特定/651.md index 0214967..dcb060a 100644 --- a/docs/wiki/08-故障/03-联通特定/651.md +++ b/docs/wiki/08-故障/03-联通特定/651.md @@ -1,4 +1,8 @@ -# 联通651,移动651 +# 故障代码651 +... +## 现象 +联通宽带拨号失败，提示错误代码`651` + ## 原因 - 配置错误 diff --git a/docs/wiki/08-故障/03-联通特定/691.md b/docs/wiki/08-故障/03-联通特定/691.md index cfbb21c..bf51deb 100644 --- a/docs/wiki/08-故障/03-联通特定/691.md +++ b/docs/wiki/08-故障/03-联通特定/691.md @@ -1,4 +1,5 @@ -# 联通691，移动691 +# 故障代码691 +... ## 现象 PPPoE宽带拨号提示 `已拒绝远程连接,因为未识别出你提供的用户名和密码组合,或在远程访问服务器上禁止使用选定的身份验证协议` ,甚至提示错误代码`691` diff --git a/docs/wiki/08-故障/03-联通特定/711.md b/docs/wiki/08-故障/03-联通特定/711.md index c469ec7..3dca817 100644 --- a/docs/wiki/08-故障/03-联通特定/711.md +++ b/docs/wiki/08-故障/03-联通特定/711.md @@ -1,4 +1,7 @@ -# 移动,联通711 +# 故障代码711 +... +## 现象 +联通宽带拨号失败，提示错误代码`711` ## 原因 diff --git a/docs/wiki/08-故障/03-联通特定/720.md b/docs/wiki/08-故障/03-联通特定/720.md index 8f96691..25ebf14 100644 --- a/docs/wiki/08-故障/03-联通特定/720.md +++ b/docs/wiki/08-故障/03-联通特定/720.md @@ -1,4 +1,7 @@ -# 联通,移动720 +# 故障代码720 +... +## 现象 +联通宽带拨号失败，提示错误代码`720` ## 原因 - 网络协议崩溃 diff --git a/docs/wiki/08-故障/03-联通特定/734.md b/docs/wiki/08-故障/03-联通特定/734.md index 4a25c54..0def406 100644 --- a/docs/wiki/08-故障/03-联通特定/734.md +++ b/docs/wiki/08-故障/03-联通特定/734.md @@ -1,4 +1,7 @@ -# 联通,移动734 +# 故障代码734 +... +## 现象 +联通宽带拨号失败，提示错误代码`734` ## 原因 - 网络协议崩溃 diff --git a/docs/wiki/08-故障/03-联通特定/_category_.json b/docs/wiki/08-故障/03-联通特定/_category_.json new file mode 100644 index 0000000..13a4e1f --- /dev/null +++ b/docs/wiki/08-故障/03-联通特定/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "联通特定的错误" +} diff --git a/docs/wiki/08-故障/03-联通特定/账号不正确.md b/docs/wiki/08-故障/03-联通特定/账号不正确.md index 151d981..b85cba6 100644 --- a/docs/wiki/08-故障/03-联通特定/账号不正确.md +++ b/docs/wiki/08-故障/03-联通特定/账号不正确.md @@ -1,4 +1,5 @@ # 账号不正确 + :::warning 注意 🚧施工中🚧 @@ -6,3 +7,12 @@ 这篇文章还没有写完呢！😛 ::: + +## 现象 +已确认网络没有其它的问题，使用默认的账号格式无法登录(找不到用户)，用户确认密码正确/没有改过密码，且没有欠费。 + +## 原因 +有些用户的账号格式不同于wiki上写的那样，常见于更换宽带的用户 + +## 解决方案 +让用户登录联通APP,查询正确的账号登录 diff --git a/docs/wiki/08-故障/04-移动特定/_category_.json b/docs/wiki/08-故障/04-移动特定/_category_.json new file mode 100644 index 0000000..bea0d1c --- /dev/null +++ b/docs/wiki/08-故障/04-移动特定/_category_.json @@ -0,0 +1,3 @@ +{ + "description": "移动特定的错误" +} diff --git a/docs/wiki/08-故障/index.md b/docs/wiki/08-故障/index.md index d786756..da1cc08 100644 --- a/docs/wiki/08-故障/index.md +++ b/docs/wiki/08-故障/index.md @@ -1,7 +1,13 @@ # 错误 -这里列举了维修过程中常见的一些问题和错误代码 +这里列举了维修过程中常见的一些问题 -当前还有很多的条目没有搬过来，可以去看旧版wiki😆 +当前还有很多的错误码条目没有搬过来，可以去看旧版wiki😆 + +:::tip 提示 + +目前这个板块还在紧锣密鼓地编写当中，如果你想与大家分享你在修网过程中遇到的问题和解决方案，欢迎向开发组投稿！ + +::: import DocCardList from '@theme/DocCardList'; diff --git a/src/css/custom.css b/src/css/custom.css index b00a108..5e8cde5 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -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; +}*/