Skip to content

Commit 608f00a

Browse files
为项目仓库添加了 README 文档,简要介绍了如何快速在本地进行项目开发。 (#10)
* docs:添加了 README 文件 * docs: 添加了搭建本地开发环境教程 * docs: 完善了项目介绍,改进项目 README 文档排版 --------- Co-authored-by: mistcoversmyeyes <mingjiangyu1@qq.com>
1 parent d529ba4 commit 608f00a

1 file changed

Lines changed: 78 additions & 0 deletions

File tree

README.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# 华南理工大学 OSC 学生指南
2+
# [![License](https://img.shields.io/github/license/mistcoversmyeyes/osc-guide-ym)](LICENSE)
3+
4+
osc-guide 是华工开源社区新生指南网页,旨在帮助新成员快速获取校内外学习资源,提升自己,参与社区活动当中。本仓库存放的是网页的内容和涉及到的各种静态资源,本项目使用 [VitePress](https://vitepress.dev/zh/) 搭建。
5+
6+
7+
## Usage
8+
9+
You can view the webPage below to access `OSC-Guide`
10+
```plantext
11+
https://guide.scutosc.cn/
12+
```
13+
14+
## Contributiong
15+
16+
Pull requests are welcome. For major changes, please open an issue first
17+
to discuss what you would like to change.
18+
19+
Please check you installation before your contributing by following the following guide:
20+
### Check the installation of `node`
21+
Run the following command to check if node version is greater than `v18.xx`
22+
```bash
23+
node -v
24+
```
25+
26+
If your node version is lower than `v18` ,run the following command to install nvm and manage node version.
27+
```bash
28+
sudo apt update # update the package source of apt package manager
29+
sudo apt-get install nvm
30+
```
31+
32+
then use nvm to install the newest stable version of `node`
33+
```bash
34+
nvm install node
35+
```
36+
37+
### Install `pnpm`
38+
VuePress use `pnpm` as node package manager ,you can use the following code to install `pnpm`,if you have already install `node.js`
39+
```bash
40+
npm install pnpm --global
41+
```
42+
43+
### Install the related package with `pnpm`
44+
45+
```bash
46+
pnpm install
47+
```
48+
49+
### Start the local Development Server
50+
After installing the dependencies, you can start the local development server with the following command:
51+
```bash
52+
pnpm run docs:dev
53+
```
54+
55+
Once started, the terminal will display the local access address (usually `http://localhost:8080`). Open this address in your browser to preview and develop your documentation website.
56+
57+
For more information about local uses of developping server, please read the official docs of [Vitepress Docs](https://vitepress.dev/zh/guide/what-is-vitepress)
58+
59+
### Structure of this Project
60+
```
61+
src/
62+
├── .vuepress/ # VuePress 配置
63+
│ ├── config.ts # 主配置文件
64+
│ ├── theme.ts # 主题配置
65+
│ ├── navbar.ts # 导航栏配置
66+
│ ├── sidebar.ts # 侧边栏配置
67+
│ └── ...
68+
├── guide/ # 主要文档内容
69+
├── demo/ # 演示内容
70+
└── README.md # 首页
71+
```
72+
73+
To wirte articles, you can open the `guide/` directory and create a new mardown file in the right categories directory.
74+
75+
76+
## License
77+
78+
[MIT](https://choosealicense.com/licenses/mit/)

0 commit comments

Comments
 (0)