docs: README.md and LaTeX.md
This commit is contained in:
parent
ce6ac2ed34
commit
2d75867f09
40
README.md
40
README.md
@ -3,11 +3,40 @@
|
||||
- Node.js v18.20.0+
|
||||
- pnpm 8+ 或 Yarn 2+
|
||||
|
||||
- 推荐使用nvm做Node.js环境管理
|
||||
## 项目结构
|
||||
|
||||
`docs`: 静态编译的网站页面内容
|
||||
|
||||
`.vuepress`
|
||||
- `public/`: 静态资源文件夹
|
||||
- `theme`: 主题参数设置文件夹
|
||||
- client.ts: 客户端配置文件
|
||||
- config.ts: 全局配置文件
|
||||
- navbar.ts: 导航栏配置文件
|
||||
- notes.ts: 文档结构配置文件
|
||||
- plume.config.ts: 主题配置文件
|
||||
|
||||
## 项目安装
|
||||
- 使用nvm安装npm(以版本18.20.0为例)
|
||||
- 推荐使用nvm做Node.js环境管理
|
||||
- [nvm windows](https://github.com/coreybutler/nvm-windows)
|
||||
- IDE:WebStorm 或 VSCode
|
||||
|
||||
|
||||
|
||||
- 使用nvm安装npm
|
||||
```shell
|
||||
nvm install 18.20.0
|
||||
nvm install lts
|
||||
```
|
||||
- 配置NodeJS Release 软件仓库镜像
|
||||
- 校园网联合镜像站:
|
||||
参考 [https://help.mirrors.cernet.edu.cn/nodejs-release/](https://help.mirrors.cernet.edu.cn/nodejs-release/)
|
||||
|
||||
```shell
|
||||
nvm node_mirror https://mirrors.cernet.edu.cn/nodejs-release/
|
||||
```
|
||||
- 阿里云
|
||||
```shell
|
||||
nvm node_mirror https://mirrors.aliyun.com/nodejs-release/
|
||||
```
|
||||
- 全局安装pnpm
|
||||
```shell
|
||||
@ -17,9 +46,9 @@
|
||||
```shell
|
||||
pnpm i
|
||||
```
|
||||
- 启动项目
|
||||
- 启动项目开发环境
|
||||
```shell
|
||||
pnpm run:dev
|
||||
pnpm run docs:dev
|
||||
```
|
||||
|
||||
## 创建合并请求
|
||||
@ -40,6 +69,7 @@
|
||||
- 所有静态文件放在`docs/.vuepress/public`中
|
||||
- 其他地方引用静态文件时,从相对路径public开始
|
||||
- 例如:public下有AI.svg文件,引用时使用 `AI.svg` 路径即可
|
||||
- markdown文档隔行写
|
||||
|
||||
## 文档
|
||||
|
||||
|
1
docs/.vuepress/public/avatar/cernet.svg
Normal file
1
docs/.vuepress/public/avatar/cernet.svg
Normal file
@ -0,0 +1 @@
|
||||
<?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg t="1740865792961" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1502" xmlns:xlink="http://www.w3.org/1999/xlink" width="200" height="200"><path d="M377.6 547.2c-3.2 0-6.4 0-9.6 1.6s-4.8 3.2-6.4 4.8c-1.6 1.6-3.2 3.2-4.8 6.4-1.6 1.6-1.6 4.8-1.6 6.4h41.6c0-4.8-1.6-9.6-4.8-12.8-4.8-4.8-9.6-6.4-14.4-6.4zM704 547.2c-3.2 0-6.4 0-9.6 1.6-3.2 1.6-4.8 3.2-6.4 4.8-1.6 1.6-3.2 3.2-4.8 6.4-1.6 1.6-1.6 4.8-1.6 6.4h41.6c0-4.8-1.6-9.6-4.8-12.8-3.2-4.8-8-6.4-14.4-6.4z" fill="#333333" p-id="1503"></path><path d="M921.6 449.6c1.6-9.6 1.6-19.2 1.6-30.4 0-147.2-120-267.2-267.2-267.2-100.8 0-190.4 56-235.2 139.2-27.2-14.4-59.2-24-92.8-24-96 0-176 72-188.8 164.8-80 22.4-139.2 96-139.2 184 0 105.6 84.8 190.4 190.4 190.4h640c105.6 1.6 190.4-83.2 190.4-188.8 0-73.6-40-136-99.2-168z m-632 176c-9.6 4.8-19.2 6.4-28.8 6.4-11.2 0-22.4-1.6-32-4.8-9.6-3.2-17.6-8-25.6-16-6.4-6.4-12.8-14.4-16-24-3.2-9.6-6.4-20.8-6.4-32s1.6-22.4 6.4-32c3.2-9.6 9.6-17.6 16-24 6.4-6.4 16-11.2 25.6-16 9.6-3.2 20.8-4.8 32-4.8 4.8 0 8 0 12.8 1.6 4.8 0 9.6 1.6 12.8 3.2 4.8 1.6 8 3.2 12.8 6.4 4.8 3.2 8 6.4 11.2 9.6l-25.6 20.8c-3.2-3.2-6.4-6.4-11.2-9.6-4.8-1.6-9.6-3.2-16-3.2s-11.2 1.6-17.6 3.2c-4.8 1.6-9.6 6.4-12.8 9.6l-9.6 14.4c-3.2 4.8-3.2 12.8-3.2 19.2 0 6.4 1.6 12.8 3.2 19.2 1.6 6.4 4.8 11.2 9.6 14.4 3.2 4.8 8 8 12.8 9.6 4.8 1.6 11.2 3.2 16 3.2 6.4 0 12.8-1.6 17.6-4.8 4.8-3.2 9.6-6.4 12.8-11.2l27.2 20.8c-6.4 9.6-14.4 16-24 20.8z m137.6-38.4h-72c1.6 6.4 3.2 11.2 8 14.4 4.8 3.2 9.6 4.8 16 4.8 4.8 0 9.6-1.6 12.8-3.2 3.2-1.6 6.4-4.8 9.6-9.6l22.4 16c-4.8 6.4-11.2 11.2-19.2 14.4s-16 4.8-24 4.8-14.4-1.6-22.4-3.2c-6.4-3.2-12.8-6.4-17.6-11.2-4.8-4.8-9.6-9.6-11.2-16s-4.8-14.4-4.8-22.4c0-8 1.6-16 4.8-22.4 3.2-6.4 6.4-12.8 11.2-16 4.8-4.8 11.2-8 17.6-11.2 6.4-3.2 14.4-3.2 22.4-3.2 8 0 14.4 1.6 19.2 3.2s11.2 6.4 14.4 11.2c4.8 4.8 8 9.6 9.6 16 1.6 6.4 3.2 14.4 3.2 22.4v11.2z m89.6-33.6c-1.6 0-4.8-1.6-6.4-1.6h-6.4c-6.4 0-11.2 1.6-14.4 3.2-3.2 1.6-6.4 3.2-8 6.4-1.6 3.2-3.2 6.4-3.2 11.2s-1.6 8-1.6 14.4v41.6h-32V528h32v16c3.2-6.4 8-11.2 11.2-14.4 4.8-3.2 9.6-4.8 17.6-4.8h4.8c1.6 0 3.2 0 4.8 1.6v27.2z m115.2 73.6h-32v-49.6-9.6c0-3.2-1.6-6.4-1.6-8-1.6-3.2-3.2-4.8-4.8-6.4-1.6-1.6-4.8-3.2-9.6-3.2s-8 0-9.6 1.6c-3.2 1.6-4.8 3.2-6.4 6.4-1.6 3.2-1.6 4.8-3.2 8v59.2h-32v-100.8h30.4v14.4c1.6-1.6 1.6-3.2 4.8-6.4 1.6-1.6 3.2-3.2 6.4-4.8 3.2-1.6 4.8-3.2 8-3.2s6.4-1.6 9.6-1.6c8 0 14.4 1.6 19.2 3.2 4.8 3.2 8 6.4 11.2 9.6s4.8 9.6 4.8 14.4 1.6 12.8 1.6 19.2v57.6z m123.2-40h-72c1.6 6.4 3.2 11.2 8 14.4 4.8 3.2 9.6 4.8 16 4.8 4.8 0 9.6-1.6 12.8-3.2 3.2-1.6 6.4-4.8 9.6-9.6l22.4 16c-4.8 6.4-11.2 11.2-19.2 14.4-8 3.2-16 4.8-24 4.8s-14.4-1.6-22.4-3.2c-6.4-3.2-12.8-6.4-17.6-11.2-4.8-4.8-9.6-9.6-11.2-16-3.2-6.4-4.8-14.4-4.8-22.4 0-8 1.6-16 4.8-22.4 3.2-6.4 6.4-12.8 11.2-16s11.2-8 17.6-11.2c6.4-3.2 14.4-3.2 22.4-3.2 8 0 14.4 1.6 19.2 3.2s11.2 6.4 14.4 11.2c4.8 4.8 8 9.6 9.6 16 1.6 6.4 3.2 14.4 3.2 22.4v11.2z m88-35.2H816v41.6c0 1.6 1.6 4.8 1.6 6.4 1.6 1.6 3.2 3.2 4.8 3.2 1.6 1.6 4.8 1.6 8 1.6h6.4c3.2 0 4.8-1.6 6.4-1.6v25.6c-3.2 1.6-6.4 1.6-11.2 3.2h-11.2c-4.8 0-9.6 0-14.4-1.6s-8-3.2-11.2-4.8-6.4-4.8-8-9.6c-3.2-6.4-3.2-11.2-3.2-16v-48h-19.2v-25.6H784V496h32v30.4h27.2v25.6z" fill="#333333" p-id="1504"></path></svg>
|
After Width: | Height: | Size: 3.3 KiB |
103
docs/.vuepress/public/avatar/cqmu.svg
Normal file
103
docs/.vuepress/public/avatar/cqmu.svg
Normal file
File diff suppressed because one or more lines are too long
After Width: | Height: | Size: 281 KiB |
1
docs/.vuepress/public/avatar/qax.svg
Normal file
1
docs/.vuepress/public/avatar/qax.svg
Normal file
File diff suppressed because one or more lines are too long
After Width: | Height: | Size: 5.0 KiB |
@ -10,38 +10,11 @@ config:
|
||||
-
|
||||
title: Python
|
||||
icon: devicon:python
|
||||
details: 适配移动设备,PC,平板
|
||||
details: Everyone can do python things
|
||||
link: /csdiy/program-begin/python/
|
||||
-
|
||||
title: 博客 & 文档
|
||||
icon: 📖
|
||||
details: 无论是想写博客,或想写产品文档,或者两者兼顾
|
||||
-
|
||||
title: 开箱即用
|
||||
icon: 🚀
|
||||
details: 支持零配置即可使用,也支持丰富的自定义配置
|
||||
-
|
||||
title: 多语言
|
||||
icon: ⚖
|
||||
details: 内置了 中文/英文支持,还可以自定义添加更多的语言支持
|
||||
-
|
||||
title: 双色主题
|
||||
icon: 👨💻
|
||||
details: 支持 浅色/深色 主题,包括代码高亮
|
||||
-
|
||||
title: 插件
|
||||
icon: 📦
|
||||
details: 内置丰富的插件,一站式解决网站一般需求
|
||||
-
|
||||
title: 搜索、评论
|
||||
icon: 🔍
|
||||
details: 支持多种评论系统,支持本地搜索、Algolia搜索
|
||||
-
|
||||
title: 加密
|
||||
icon: 🔒
|
||||
details: 支持全站加密、部分加密(加密目录、加密文章)
|
||||
-
|
||||
title: Markdown 增强
|
||||
icon: 📝
|
||||
details: 支持 Markdown 语法,支持 代码块分组、提示容器、任务列表、数学公式、代码演示等
|
||||
title: C++
|
||||
icon: devicon:cplusplus
|
||||
details: System based programming language
|
||||
link: /csdiy/program-begin/c-plus/
|
||||
---
|
||||
|
8
docs/notes/CS-DIY/编程入门/c-plus.md
Normal file
8
docs/notes/CS-DIY/编程入门/c-plus.md
Normal file
@ -0,0 +1,8 @@
|
||||
---
|
||||
title: C++
|
||||
createTime: 2025/03/02 05:38:32
|
||||
permalink: /csdiy/program-begin/c-plus/
|
||||
icon: devicon:cplusplus
|
||||
---
|
||||
|
||||
C++入门
|
@ -2,6 +2,7 @@
|
||||
title: python
|
||||
createTime: 2025/03/01 03:00:38
|
||||
permalink: /csdiy/program-begin/python/
|
||||
icon: devicon:python
|
||||
---
|
||||
|
||||
[//]: # (TODO:chy待填写)
|
||||
|
@ -19,20 +19,15 @@ groups:
|
||||
location: Global distribution
|
||||
organization: PGuide Studio Yuque
|
||||
desc: Gracious thoughts stay in with simple words.
|
||||
- name: 艺术部
|
||||
link: https://art.pguide.studio
|
||||
avatar: /manage.svg
|
||||
location: Global distribution
|
||||
organization: PGuide Studio Art
|
||||
desc: Creative creates create creations.
|
||||
- title: 重庆医科大学信息中心
|
||||
desc: CQMU Central Network
|
||||
desc: CQMU Central NetWork
|
||||
list:
|
||||
- name: 二级门户
|
||||
link: https://cnw.cqmu.edu.cn/
|
||||
location: 重庆医科大学
|
||||
avatar: /avatar/cqmu.svg
|
||||
organization: 重庆医科大学信息中心
|
||||
desc:
|
||||
desc: 信息中心门户网站
|
||||
- title: MED Explorers+
|
||||
desc: A research team affiliated to the College of Basic Medical Science composed of undergraduates
|
||||
list:
|
||||
@ -45,11 +40,40 @@ groups:
|
||||
|
||||
- title: 西湖大学超算中心
|
||||
desc: HPC Base for computation in WLU.
|
||||
- title: 中国科学院大学
|
||||
# -
|
||||
# name:
|
||||
# link:
|
||||
# location:
|
||||
# avatar:
|
||||
# organization:
|
||||
# desc:
|
||||
- title: 中国教育和科研计算机网
|
||||
desc: visit https://www.cernet.net for more information
|
||||
desc: 中国教育和科研计算机网CERNET是党中央、国务院指定的中国教育信息化的基础平台,也是中国最早的四大骨干网之一,为中国教育信息化及人才培养作出了突出贡献。除为教育系统用户提供基本互联网接入服务外,还受国务院授权,负责教育系统域名管理(edu.cn),并承担各类大型国家教育信息化建设项目及研究任务。
|
||||
list:
|
||||
-
|
||||
name: CERNET官网
|
||||
link: https://www.edu.cn/
|
||||
location: 中国,北京
|
||||
avatar: /avatar/cernet.svg
|
||||
organization: 中国教育和科研计算机网网络中心
|
||||
desc: CERNET Secured.
|
||||
-
|
||||
name: 校园网联合镜像站
|
||||
link: https://mirrors.cernet.edu.cn/
|
||||
location: 中国各高校
|
||||
avatar: https://mirrors.cernet.edu.cn/static/img/mirrorz.svg
|
||||
organization: 清华大学MirrorZ项目组
|
||||
desc: 本站提供对校园网镜像站的索引和跳转服务。
|
||||
- title: 奇安信网神(北京)信息科技有限公司
|
||||
desc: 网络安全领军者
|
||||
list:
|
||||
-
|
||||
name: 官网
|
||||
link: https://www.qianxin.com/
|
||||
location: 中国,北京
|
||||
avatar: /avatar/qax.svg
|
||||
organization: 奇安信集团
|
||||
desc:
|
||||
- title: 中国科技云
|
||||
desc: China Science & Technology cloud
|
||||
list:
|
||||
@ -66,25 +90,25 @@ groups:
|
||||
name: MUA官网
|
||||
link: https://www.mualliance.cn/
|
||||
location: 中国
|
||||
avatar:
|
||||
organization:
|
||||
desc:
|
||||
avatar: https://www.mualliance.cn/wp-content/uploads/2023/01/mua.png
|
||||
organization: MUA
|
||||
desc: Minecraft University Alliance
|
||||
-
|
||||
name: 渝高联CQMUA官网
|
||||
link:
|
||||
link: https://3w.cqmua.cn/
|
||||
location: 中国,重庆市
|
||||
avatar:
|
||||
organization:
|
||||
avatar: https://3w.cqmua.cn/logo.svg
|
||||
organization: CQMUA、MUA
|
||||
desc: 重庆市 Minecraft 高校联盟
|
||||
-
|
||||
name: 上海交通大学SJMC
|
||||
link: https://mc.sjtu.cn
|
||||
location: 中国,上海闵行
|
||||
avatar:
|
||||
avatar: https://mc.sjtu.cn/welcome/_next/static/media/mcclub.d8834901.png
|
||||
organization: 上海交通大学、MUA
|
||||
desc:
|
||||
- title: 重庆医科大学LaTeX用户组
|
||||
desc: CQMU LaTeX user group.
|
||||
desc: SJTU Minecraft Club
|
||||
- title: 重庆医科大学TeX用户组
|
||||
desc: CQMU TeX user group.
|
||||
list:
|
||||
- name: 内网LaTeX在线协作平台
|
||||
link: http://192.168.183.171
|
||||
@ -101,13 +125,13 @@ groups:
|
||||
- title: 北京大学信息科学技术学院
|
||||
dsc: Peking University
|
||||
list:
|
||||
-
|
||||
name:
|
||||
link:
|
||||
location:
|
||||
avatar:
|
||||
organization:
|
||||
desc:
|
||||
# -
|
||||
# name:
|
||||
# link:
|
||||
# location:
|
||||
# avatar:
|
||||
# organization:
|
||||
# desc:
|
||||
-
|
||||
name: CS-DIY
|
||||
link: https://csdiy.wiki/
|
||||
|
@ -2,4 +2,25 @@
|
||||
title: LaTeX学习
|
||||
createTime: 2025/02/25 18:56:04
|
||||
permalink: /public-service/latex/
|
||||
icon: cib:latex
|
||||
---
|
||||
|
||||
推荐的学习路线如下:
|
||||
|
||||
● 阅读下面三篇 Tutorial: [Part-1](https://www.overleaf.com/learn/latex/Free_online_introduction_to_LaTeX_(part_1)), [Part-2](https://www.overleaf.com/learn/latex/Free_online_introduction_to_LaTeX_(part_2)), [Part-3](https://www.overleaf.com/learn/latex/Free_online_introduction_to_LaTeX_(part_3))。
|
||||
|
||||
● 学习 LaTeX 最好的方式当然是写论文,不过从一门数学课入手用 LaTeX 写作业也是一个不错的选择。
|
||||
|
||||
● 一份简短的安装 LaTeX 的介绍 [[GitHub]](https://github.com/OsbertWang/install-latex-guide-zh-cn) 或者 TEX Live 指南(texlive-zh-cn)[[PDF]](https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-zh-cn.pdf) 可以帮助你完成安装和环境配置过程
|
||||
|
||||
● 一份(不太)简短的 LaTeX2ε 介绍(lshort-zh-cn)[PDF] [GitHub] 是由 CTEX 开发小组翻译的,可以帮助你快速准确地入门,建议通读一遍
|
||||
|
||||
● 刘海洋的《LaTeX 入门》,可以当作工具书来阅读,有问题再查找,跳过 CTEX 套装部分
|
||||
|
||||
● 现代 LaTeX 入门讲座
|
||||
|
||||
● 一份其实很短的 LaTeX 入门文档
|
||||
|
||||
## 一份不太简短的LaTeX介绍~
|
||||
|
||||
@[pdf zoom="95" ratio="21:29"](https://mirror-hk.koddos.net/CTAN/info/lshort/chinese/lshort-zh-cn.pdf)
|
@ -48,7 +48,7 @@ Hello World! % 文档内容
|
||||
|
||||
### 学习LaTeX
|
||||
|
||||
@[pdf zoom="95" ratio="21:29"](https://mirror-hk.koddos.net/CTAN/info/lshort/chinese/lshort-zh-cn.pdf)
|
||||
请参考 [学习LaTeX](LaTeX.md)
|
||||
|
||||
## CQMU TUG
|
||||
|
||||
|
@ -2,5 +2,5 @@
|
||||
title: docker私有镜像管理
|
||||
createTime: 2025/02/25 18:48:25
|
||||
permalink: /public-service/data-center/docker-registry/
|
||||
icon: /docker.svg
|
||||
icon: teenyicons:docker-outline
|
||||
---
|
||||
|
Loading…
x
Reference in New Issue
Block a user