logo
0
0
WeChat Login

Windows 下 Git 和 VSCode 安装及 CNB 仓库配置指南(Windows 示例)

注意:本文档以 Windows 系统为例进行说明,macOS 系统操作类似(注意快捷键不同),Linux 系统用户请自行调整(都用 Linux 肯定动手能力比较强啦 😄)。如有疑问,欢迎在群内咨询。

目录


1. 安装 VSCode

1.1 下载 VSCode

访问 VSCode 官网:https://code.visualstudio.com/

VSCode 下载页面

1.2 安装 VSCode

运行下载的安装程序

按照默认设置进行安装(安装路径可选其他位置)


2. 安装 Git

2.1 下载 Git

访问 Git 官网:https://git-scm.com/download/

Git 下载页面

2.2 安装 Git

运行下载的安装程序

重要:在安装过程中选择 VSCode 作为默认编辑器

选择 VSCode 作为编辑器

按照默认设置进行安装(安装路径可选其他位置)

装完 git 开始菜单搜 git bash,看有没有,没有就重启一下。嫌麻烦直接重启


3. CNB

3.1 创建 CNB 账号

3.2 新建仓库

登录 CNB,点击右上角"+" → "创建仓库"

新建仓库 1

填写仓库信息

新建仓库 2

  • 仓库归属需要新建组织,自己随意取一个就好
  • 仓库名称:test(以 test 为例)
  • 简介:可选

选择添加 README 初始化仓库

选择初始化 README

README 内容 (随意)

初始化仓库

初始化仓库后提交

3.3 创建访问令牌

登录 CNB 后,点击右上角头像 → 个人设置

个人设置

左侧菜单选择访问令牌→添加访问令牌

选择新 Token

勾选以下场景(按照图片中的选择),其他默认

选择权限

滚动到页面底部,点击创建

滚动到底部创建

重要:复制生成的 Token 并妥善保存(只显示一次)

存储认证 Token


4. 克隆仓库到本地

4.1 VSCode 打开文件夹

打开 VSCode

点击"file" → "open folder",可以选一个空的新建的目录

弹出 trust,选择 trust 即可

4.2 安装扩展

Ctrl+Shift+X或按照图片展示打开扩展面板

安装扩展并配置

搜索需要的扩展,如

  • Tinymist(Typst 插件)
  • vscode-pdf(PDF 预览)

4.3 配置 VSCode

Ctrl+Shift+P搜索 Open User Settings(JSON),点击打开

修改用户设置

复制以下内容,替换原有的文件内容,Ctrl+S保存。这里设置了自动保存,typst 文件在Ctrl+S后自动格式化

{ "files.autoSave": "afterDelay", "files.autoSaveDelay": 1000, // 单位是毫秒,默认 1000ms = 1 秒 "[typst]": { "editor.formatOnSave": true }, "tinymist.exportPdf": "onSave" }

4.4 打开终端

点击"Terminal" → "New Terminal"

在 VSCode 中新建终端

在 CNB 仓库页面,复制图中的所示前面的 URL

克隆仓库 URL

在终端执行

git clone 复制的 URL

Git 克隆 CNB 仓库

重新打开文件夹,选择刚才克隆的仓库文件夹

在 VSCode 中打开文件夹

4.5 创建新文件

将鼠标移到图中所示位置,可选新建文件,输入文件名(如:test.typ

创建新的 Typst 文件

随便写点东西,点 Preview

#set text(size: 11pt, lang: "zh") == 摘要 中文摘要,摘要是论文

创建新的 Typst 文件

Ctrl+S后发现文件格式化了 set 变成一行了

4.6 git 操作

git 入门

# 添加单个文件 git add 文件名 # 添加所有文件 git add .

如图,在仓库文件夹下,注意,是仓库文件夹下,clone完了要重新打开,或者在终端 cd test,这里 test 是文件夹名,举例

Git 添加文件和状态说明

git commit -m "提交说明"

Git 提交和说明

失败,忘记添加 git 信息,在终端执行下列指令,用户名不用真名

git config --global user.name "你的用户名" git config --global user.email "你的邮箱"

再次执行 commit 命令,按↑可跳到上一条命令,连续按同理

git commit -m "提交说明"

push 到 CNB 仓库

git push

第一次 push 的时候填写信息,Username 是 cnb,密码是 Token

Git 认证

推送完成后,可以在 CNB 上检查仓库状态

推送后检查 CNB 仓库


5. 获取帮助

如有疑问,欢迎在群内咨询!

  • Windows 用户:按照本文档操作,遇到问题截图询问
  • macOS 用户:操作类似,细节差异可群内讨论
  • Linux 用户:动手能力强,可自行调整,也可群内交流经验

About

衣生万象小队维护的技能表

Language
HTML99.6%
Typst0.4%
TeX0%
Rust0%