山东第二医科大学指南 Web 版

本项目是山东第二医科大学指南的 Web 版本。

本项目旨在将 PDF 版本的指南线上化，让指南在不同设备上轻松浏览。

因本项目已正式上线，上述项目已全部进入 Archive 状态，不再维护。

本指南的内容部分遵循 CC BY SA 4.0 LICENSE，代码部分遵循 MIT LICENSE。

The code of this project is licensed under MIT LICENSE, and the content is licensed under CC BY SA 4.0 LICENSE.

Thanks



GitHub
GitHub Copilot & ClaudeCode
DeepSeek Models & Claude Models& Google Models & OpenAI Models

Markdown 文件简要编辑说明

入门

请参考以下链接学习 Markdown 文件的编辑

示例

看到此处则默认你已经看完了上面的markdown入门基本知识

图片插入
1. 插入不缩放的大图片请参考 map_full.md 中的做法，注意图片 svg 与 webp 的问题（仅地图需要两个）
  
  <FigureImage src="图片路径" title="自己起的自定义标题" downloadLink="图片路径（通常和上面的一致，仅地图有svg与webp之分）"></FigureImage>
2. 行内图片（自动缩放）请参考 life.md 浴室预约与使用-浮烟山校区的文本
  
  前面的文字 <InlineImage src="图片路径"></InlineImage> 后面的文字
提示块
```
::: 此处需根据具体情况从以下几项中选择
文字
:::
```
- tip 因格式原因不便在正文处给出的注释
- warning 警告
- info 相关信息
- note 提示
- important 重要提示，少用
强调请参考 thank_lists.md 的最后

严禁在标题中使用加粗等自定义格式，将导致无法搜索！
1. 加粗代码为 font-size:2em;
2. 字体颜色通用代码为 color:rgb(0,0,0);，特殊颜色可以直接写英文
3. 背景色通用代码为 background:rgb(0,0,0);，特殊颜色可以直接写英文
4. 字体加粗为 font-weight:bold;
综合示例如下：
```
<span style="font-size:2em; color:red; font-weight:bold; background:yellow">需要加粗的文本，效果为大字、红色、背景黄色</span>
```
双下划线请参考 dormitory_fuyanshan.md
文字标红参考 study.md
手动书签跳转参考 life.md 的脚注 1 与 school_readiness.md 的脚注 8
行内二维码参考 common_public_accounts.md，行间二维码参考 thank_lists.md

写作风格说明

除版权声明以外，正文句子结尾无句号
使用 → 作为操作步骤的连接符号
穿插使用 raw HTML 以实现更复杂的排版需求，在可能的情况下尽量优先使用 Markdown 语法，若同时有加粗、标红等 Markdown 和 HTML 语法混杂的情况时，仅使用 HTML 语法
部分行间脚注、特殊书签通过 <span id="XXX"></span> 的实现
未显著区分 important、warning与note
表格排版未调整
大量使用了 AI 协助排版，内容无任何 AI
禁止使用UTF-8单位符号，例如 ％、℃、cm等，否则无法搜索
写作时禁止在正文中随意加入空格，否则将导致难以搜索
致谢部分除非长篇累牍地引用，或始终在为项目贡献，否则不应写入 md_files/doc_related/thank_lists.md，仅在引用旁使用 ::: important 致谢 做感谢即可

本地构建与运行

双击 WORKPLACE.code-workspace 以打开 VSCode 工作区
开始编辑
本地运行
1. 打开终端，首次运行输入 npm install 安装依赖（移动目录后需先移除 md_files/.vuepress/.cache 文件夹，再执行 npm install，否则会报错）
2. 本地预览：npm run docs:dev
3. 本地构建：npm run docs:build
上传修改后的文件到 GitHub 仓库
1. 上传前先运行 git pull 同步远程仓库的修改
2. 通过 lazygit 或 VSCode 侧栏提交修改，或 git add . && git commit -m "提交说明"
3. 通过 lazygit 或 git push 推送修改
部署构建产物到服务器
1. 运行 npm run docs:build 构建文件
2. 将 md_files/.vuepress/dist 目录中的所有内容上传到服务器对应目录，主页指向 index.html

注意：移动项目目录后需先删除 md_files/.vuepress/.cache，再执行 npm install，否则会报错

项目结构

tree -I node_modules -o 1.txt ./

./
├── AGENTS.md                        # AGENTS 说明
├── CODE_OF_CONDUCT.md               # 贡献者行为准则
├── LICENSE-CC                       # CC BY-SA 4.0（内容许可）
├── LICENSE-MIT                      # MIT（代码许可）
├── README.md                        # 项目说明（本文件）
├── WORKPLACE.code-workspace         # VS Code 工作区文件
├── deploy.ps1                       # 已禁用的 GitHub Pages 部署脚本，仅保留迁移提示
├── env.d.ts                         # Vue SFC 类型声明
├── favicon.afdesign                 # 网站图标源文件
├── netlify.toml                     # Netlify 部署配置
├── package.json                     # 项目依赖与脚本
├── package-lock.json                # 依赖版本锁定
├── tsconfig.json                    # TypeScript 配置
│
├── md_files/                        # VuePress 源文件根目录
│   ├── index.md                     # 首页（home 布局）
│   ├── CHANGELOG.md                 # 更新日志（Web 版）
│   ├── CHANGELOG_old.md             # 更新日志（旧 LaTeX 版）
│   ├── LICENSE                      # 内容许可（CC BY-SA 4.0）
│   │
│   ├── .vuepress/                   # VuePress 配置与组件
│   │   ├── config.ts                # 主配置：主题、插件、侧边栏
│   │   ├── client.ts                # 客户端入口：注册全局组件、加载样式
│   │   ├── style.css                # 全局样式（暗色模式、CJK 排版、响应式）
│   │   ├── custom-dict.txt          # jieba 分词自定义词典
│   │   ├── components/              # 自定义 Vue 3 组件
│   │   │   ├── FigureImage.vue      #   全宽图片（带标题与下载）
│   │   │   ├── InlineImage.vue      #   行内小图标
│   │   │   ├── FileDownload.vue     #   文件下载按钮
│   │   │   ├── Donate.vue           #   打赏二维码
│   │   │   ├── QrCodeLink.vue       #   行内文字 + 二维码浮窗
│   │   │   ├── QrCodeBlock.vue      #   块级文字 + 二维码浮窗
│   │   │   └── MinxingFloorSearch.vue # 敏行楼 SVG 楼层图搜索
│   │   └── public/                  # 静态资源（部署到站点根路径 /）
│   │       ├── favicon.svg          #   网站图标
│   │       ├── _redirects           #   Netlify 重定向规则
│   │       ├── fonts/               #   字体文件（Noto Sans SC、Cascadia Code）
│   │       └── resources/           #   图片、地图、二维码等资源
│   │
│   ├── before_school/               # 新生入学（6 篇）
│   │   ├── school_readiness.md      #   入学准备
│   │   ├── school_register.md       #   报到流程
│   │   ├── goto_school.md           #   交通指引
│   │   ├── military_training.md     #   军训概况
│   │   ├── cost.md                  #   费用与银行卡
│   │   └── common_questions.md      #   常见问题
│   │
│   ├── doc_related/                 # 文档相关
│   │   ├── thank_lists.md           #   致谢
│   │   ├── copyright_statements.md  #   版权声明
│   │   ├── document_introduction.md #   指南简介
│   │   ├── calender.md              #   校历
│   │   └── epilogue.md              #   后记
│   │
│   └── in_school/                   # 在校期间内容
│       ├── campus_fuyanshan/        #   浮烟山校区
│       │   ├── summary_fuyanshan.md #     校区概况
│       │   ├── maps/                #     地图
│       │   ├── dormitory_fuyanshan.md #   宿舍
│       │   └── school_life_fuyanshan.md # 校园生活
│       ├── campus_yuhe/             #   虞河校区
│       │   ├── summary_yuhe.md      #     校区概况
│       │   ├── maps/                #     地图
│       │   ├── dormitory_yuhe.md    #     宿舍
│       │   └── school_life_yuhe.md  #     校园生活
│       ├── life/                    #   校园安全与学习
│       ├── further/                 #   就业与兼职
│       ├── summary/                 #   组织信息汇总
│       └── tutorial/               #   教程
│
└── 12 directories, 55 files

依赖升级

安装 ncu
- npm install -g npm-check-updates
查看可升级的 package
- ncu
升级 packages
- ncu -u
- vuepress、@vuepress/client、@vuepress/bundler-vite 的版本号必须一致
- @vuepress/plugin-markdown-container、@vuepress/plugin-markdown-ext、@vuepress/plugin-markdown-hint、@vuepress/plugin-markdown-math、@vuepress/plugin-markdown-stylize、@vuepress/plugin-slimsearch、@vuepress/theme-default 的版本号必须一致
- 仅当同组所有 package 都存在同一目标版本，且两组的 peer dependencies 兼容时才允许升级；任一 package 缺少目标版本时，整组均不升级，禁止混用不同版本号

Navigation Menu

Repository files navigation

山东第二医科大学指南 Web 版

Thanks

Markdown 文件简要编辑说明

入门

示例

写作风格说明

本地构建与运行

项目结构

依赖升级

About

Contributors

Languages

Name		Name	Last commit message	Last commit date
.devcontainer		.devcontainer
.github/workflows		.github/workflows
.vscode		.vscode
md_files		md_files
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE-CC		LICENSE-CC
LICENSE-MIT		LICENSE-MIT
README.md		README.md
WORKPLACE.code-workspace		WORKPLACE.code-workspace
deploy.ps1		deploy.ps1
env.d.ts		env.d.ts
favicon.afdesign		favicon.afdesign
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

山东第二医科大学指南 Web 版

Thanks

Markdown 文件简要编辑说明

入门

示例

写作风格说明

本地构建与运行

项目结构

依赖升级

About

Topics

Resources

Code of conduct

Stars

Watchers

Forks

Contributors

Languages