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

初始化仓库

This commit is contained in:
2024-08-17 00:55:30 +08:00
commit 13aeb772ed
92 changed files with 17814 additions and 0 deletions

View File

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

View File

@@ -0,0 +1,17 @@
# 开发组网站概览
## 技术
网站基于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

@@ -0,0 +1,22 @@
# 开发组网站-内容发布
**本篇文章将教你如何为开发组网站贡献内容,修改内容,以及内容的维护**
## 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

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

View File

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

View File

@@ -0,0 +1,11 @@
# 网站
## 概述
目前网站有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端口