Skip to content

练习

1. 获取当前 Git 库

  • 访问 https://gitlab.devops.alacps.com/wangbocheng/teambook
  • 如果没有账号,则提供注册邮箱给 gitlab 管理员,并要求成为 teambook 项目的成员
  • 打开 teambook 项目首页,点击【克隆】按钮,复制【使用 Https 克隆】对应的版本库地址
  • 在本地打开终端,执行
bash
git clone https://gitlab.devops.alacps.com/wangbocheng/teambook.git
git clone https://gitlab.devops.alacps.com/wangbocheng/teambook.git

2. 添加一篇文章,练习基本 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 服务器