|
| 1 | +# 华南理工大学 OSC 学生指南 |
| 2 | +# [](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