1
0
mirror of https://github.com/ZSCNetSupportDept/website.git synced 2025-10-29 09:25:04 +08:00

Deploy website - based on 13aeb772ed

This commit is contained in:
2024-08-17 01:24:05 +08:00
parent 13aeb772ed
commit 63d12ed3d1
224 changed files with 1439 additions and 17432 deletions

View File

@@ -1,22 +0,0 @@
# 开发组首页
**欢迎来到中山学院网络维护科开发组!**\
**开发组是一个相对独立的小组,负责维护网维日常所用的系统,**\
**这里是开发组所维护系统的文档**
## 项目清单
我们手头上的项目
### 网站
zsxyww.com,网维的官网
### 网维报修系统
负责受理用户的故障保修,允许网维成员跟踪问题的解决情况,并管理工单\
目前所使用的是上一届开发组成员所开发的系统,目前我们不熟悉其架构和细节,计划开发新的报修系统
### 招新系统
招新的系统
### 基础设施
开发组所持有的基础设施,包括云服务器,域名等
## 你应该知道......
### 项目托管
我们的项目托管在github上私聊组长来获得进入organization的权限
### 文档编写
为了项目的持续维护对于我们的每一个项目都应该留有详尽的文档文档以markdown格式编写可以自动构建成静态网页详见**网站/如何修改开发组网站内容**

View File

@@ -1,7 +0,0 @@
# 子站点
## www.zsxyww.com
www.zsxyww.com是网维的官网
## wiki.zsxyww.com
wiki.zsxyww.com是网维的旧版wiki
## developer.zsxyww.com
developer.zsxyww.com是网维开发组的站点托管了新版wiki和网维各种系统的文档

View File

@@ -1,17 +0,0 @@
# 开发组网站概览
## 技术
网站基于Docusaurus开发,一个静态网页生成的框架尤其对于生成技术文档来说它提供了一个美观现代的前端界面这个项目本身是一个react.js应用生成网页时只要输入`npm run build`便可以在build目录里构建网站的所有资源以进一步部署关于详细的配置可以去看官方的文档[文档连接](https://www.docusaurus.cn/docs/category/guides)
## 工作流程
基本上我们需要把markdown文件放在目录里面系统就会根据目录的结构自动生成网页但是我们必须写好配置文件如果我们想自定义网站的外观的话也需要好好研究一下配置文件有关文档还在编写中
## 目录
所有的文档文件都储存在docs文件夹下\
所有的公告文件都储存在blog文件夹下\
所有的静态页面都储存在src/pages文件夹下\
所有的媒体文件都储存在static文件夹下\
系统会根据这些文件在build里生成网站的所有页面文件以供我们部署
docusaurus.config.js是项目的配置文件配置格式请参照官方文档
## 部署
目前不确定
## 注意事项
最好还是看官方文档

View File

@@ -1,22 +0,0 @@
# 开发组网站-内容发布
**本篇文章将教你如何为开发组网站贡献内容,修改内容,以及内容的维护**
## Edit This Page
页面最下面有一个Edit This Page的超链接点击就可以进入github里这个页面的源代码可以提交PR有权限的也可以直接修改
## 增加内容
docusaurus按照一定的文件层次将markdown文档转换成静态页面在仓库里docs文件夹下的是网站的文档blog文件夹下的为公告src/pages下的为独立页面如首页如果要增添新的内容记得把内容放在正确的地方里
### 前缀
所有文件都要加入一个数字前缀用来指示构建系统按照序号生成文章在sidebar中的顺序,按照`order-filename.md`的格式命名
btw,docusaurus不会将以"_"开头的文件加入完成的网页中,所以可以在暂时不想要展现在最终网站的里的的文章前面加上一个下划线
### Markdown 文档
Markdown 是一个标记文本格式的语言轻便简单快捷markdown最基本的语法如下[markdown语法](https://commonmark.org/) 我们用Markdown来编写文档,需要注意的是文档只能有一个h1系统用它来产生sidebar条目
另外docusaurus好像支持mdx格式的文档可以把一些动态元素插入到文本中
### 媒体资源引用
将所有媒体资源放在static目录内然后在文档中调用
## 公告
docusaurus自带一个blog插件需要按照`yyyy-mm-dd-filename.md`的格式发布
## 文档的维护
如果发现了文档有错误的地方请提交PR修改或者告知开发组成员

View File

@@ -1,2 +0,0 @@
# 网站外观修改
**本篇指南将教你如何修改开发组网站的外观**

View File

@@ -1 +0,0 @@
# 旧版wiki

View File

@@ -1,11 +0,0 @@
# 网站
## 概述
目前网站有www.zsxyww.com(主站点)wiki.zsxyww.com(旧wiki),和developer.zsxyww.com(开发组网站),这些子域
### www.zsxyww.com
好像是前辈们留下来的项目,暂时不清楚情况
### wiki.zsxyww.com
旧版的wiki,使用wiki.js构建上面存放了累积下来的许多文章目前准备迁移
### developer.zsxyww.com
目前集中开发的新站点把计划发布的新版wiki和开发组的文档都放在上面了使用docusaurus构建
## 部署
网站部署在腾讯云的服务器上dnspod进行解析nginx反向代理官网和旧wiki是封装在docker容器里的监听8090端口和3000端口

View File

@@ -1 +0,0 @@
# 网维报修系统

View File

@@ -1,2 +0,0 @@
# 网维报修系统
目前所使用的系统在这里:[系统](https://github.com/ZSCNetSupportDept/WechatTicketSystem) 暂时不了解,难以维护,准备开发新的报修系统

View File

@@ -1 +0,0 @@
# 招新系统

View File

@@ -1,2 +0,0 @@
# 招新系统
不了解

View File

@@ -1,5 +0,0 @@
# 基础设施
## 服务器
我们目前拥有负责报修系统和网站的两台服务器位于tx云上,联系组长以获得访问权限
## 域名
我们拥有一个域名zsxyww.com

View File

@@ -1,2 +0,0 @@
# zsxyww.com
这个域名目前托管在west.cn上腾讯云dns关于域名的交接事项请联系组长

View File

@@ -1,2 +0,0 @@
# 报修服务器

View File

@@ -1,13 +0,0 @@
# 网站服务器
## 概况
ip:**43.129.159.235**
OS:**Debian 10.2 64bit**
配置CPU - 1核 内存 - 1GB\
系统盘 - SSD云硬盘 25GB\
流量包 - 1024GB/月峰值带宽30Mbps
服务:官网(通过docker部署8090端口nginx反代)\
旧版wiki(docker3000端口,nginx反代)\
新网站(TODO:补充部署方式)

View File

@@ -1,6 +0,0 @@
# 加入开发组
可以参照下面的联系方式和开发组进行联系
## 联系方式
QQ群961797864
QQ:2597760847(组长)

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long