由一群普通本科生发起的开源项目,致力于分享一套从自我认知开始的成长方法论。
我们始于南昌大学,但这份指南属于每一位渴望主动把握大学生涯的你。
我们曾仰望过《上海交通大学生存手册》那样的精英灯塔,但很快发现,他们的航线固然璀璨,其起点、风速、洋流都与我们不同。我们需要一份更具普适性的海图,一套更基础、更关注内在的航行方法。
我们为这份初心,取名为"寻路之南" 。它是一份"寻路者的指南",也是一场始于南昌大学的探索。它承载着我们的起点,也指向我们共同的目标:在迷雾中,为自己找到南方——那个温暖、清晰、充满生命力的方向。
这个位置,让我们得以摆脱纯粹的精英视角或自怨自艾的受害者心态。它让我们相信,我们的故事——一个关于在还不错的平台上,如何通过自我认知与系统构建,来超越平台局限的故事——对最广大的学生群体,具有最真实的参考意义。
这就是我们的立足点:不仰望神坛,也不俯视深渊,只是脚踏实地,与每一个努力向上的你同行。
我们强烈建议您在线阅读,以获得最佳体验。
本指南主要由以下几个核心部分构成,我们建议您从"寻路指南"开始。
| 模块 | 核心内容 |
|---|---|
| 开始之前 | 建议从这里开始。 这里有写给新读者的第一封信 (第负一课),以及一份网站的完整地图 (全站导览)。 |
| 核心课程 | 本项目的主体。包括了作为基石的 本科生通识第零课 和作为拓展的 第零点五课堂。 |
| 昌大专属 | 沉淀了独属于南昌大学的实用信息与经验,例如转专业、保研考研等。 |
| 关于我们 | 你可以在这里找到我们的完整初心、项目共建指南和内容索引。 |
如果你希望在本地运行、修改网站,或参与项目共建,欢迎继续阅读。
-
环境准备
-
克隆并进入项目
git clone https://github.com/NCUSCC/cs4ncu.git cd cs4ncu -
同步环境
uv sync
-
启动!
uv run mkdocs serve
在浏览器中打开
http://127.0.0.1:8000即可。
无需安装本地 Python/uv,直接用 Docker 预览站点:
# 方式一:docker compose(推荐,热更新) docker compose up --build # 方式二:纯 docker docker build -t cs4ncu-docs . docker run --rm -it -p 8000:8000 -v $(pwd):/app \ -e ENABLE_COMMITTERS=${ENABLE_COMMITTERS:-false} \ -e GITHUB_TOKEN=${GITHUB_TOKEN:-} \ cs4ncu-docs
打开 http://127.0.0.1:8000 访问。若需启用 git-committers 插件,请设置环境变量:
export ENABLE_COMMITTERS=true export GITHUB_TOKEN=你的GitHubToken
寻路之南 的成长离不开每一位社区成员的贡献。我们欢迎任何形式的帮助!
| 贡献方式 | 如何开始 |
|---|---|
| 内容创作 | 修正错别字、完善现有章节、撰写全新内容。 |
| 提出建议 | 发现内容问题或有新的想法?请大胆地 提出 Issue! |
| 代码贡献 | 帮助我们优化网站功能、修复 Bug、改进自动化流程。 |
不确定从哪里开始?我们为你准备了适合新手的任务 👉 good first issue
每一次微小的贡献,都在点亮更多人前行的道路。
我们由衷感谢每一位为本项目注入心血的贡献者。
Contributors(由 contrib.rocks 自动生成)
本项目基于 MIT License 授权。
Crafted with ❤️ and ☕ by the community.