Appearance
练习
1. 获取当前 Git 库
- 访问 https://gitlab.devops.alacps.com/wangbocheng/teambook
- 如果没有账号,则提供注册邮箱给 gitlab 管理员,并要求成为 teambook 项目的成员
- 打开 teambook 项目首页,点击【克隆】按钮,复制【使用 Https 克隆】对应的版本库地址
- 在本地打开终端,执行
bash
git clone https://gitlab.devops.alacps.com/wangbocheng/teambook.gitgit clone https://gitlab.devops.alacps.com/wangbocheng/teambook.git2. 添加一篇文章,练习基本 markdown 语法
- 用 vscode 打开刚才 clone 下来的文件夹
- 在 docs/blogs 目录下创建一个 {你的名字拼音}.md 文件
Cmd + Shift + P, 输入 markdown 选择打开 vscode 的 Markdown 侧边预览栏- 参考其他 md 文件,编辑内容
- markdown 基本语法参考
3. 添加菜单导航,本地预览
- 打开 docs/.vitepress 下的 config.mts
- 找到
sidebar下的text:'Blogs',在其下方的items:项目中,追加一个{text:'',link:''}结构的导航项目,其中 text 是菜单名称,link 为指向的页面地址,可以参考其他已有的配置写法,结合当前目录结构 - 本地预览(可选):如果本地安装了 nodejs 环境,可以在项目根目录执行
npm i && npm run docs:dev进行本地预览,以便及时检查内容和排版等问题。
4. 推送代码并发布
- 在 vscode 源代码管理 界面上,输入提交日志,点击【提交】
- 继续点击【同步更改】,推送到 gitlab 服务器