2024-12-22 23:25:14 +08:00
|
|
|
|
以下是将你的内容改为中文并添加 Git 教程的版本:
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
---
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
# 快速开始
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
这是一个普通页面,包含 VuePress 的基础知识。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
## 页面
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
你可以在 VuePress 项目目录中添加 Markdown 文件,每个 Markdown 文件都会被转换为站点中的一个页面。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
更多详细信息请参考[路由][routing]。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
## 内容
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
每个 Markdown 文件[将会被渲染为 HTML,然后转换为一个 Vue 单文件组件][content]。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
VuePress 支持基础的 Markdown 语法和[一些扩展语法][syntax-extensions],你还可以在其中[使用 Vue 的功能][vue-feature]。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
## 配置
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
VuePress 使用 `.vuepress/config.js`(或 `.ts`)文件作为[站点配置][config],可以用它来配置你的站点。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
对于[客户端配置][client-config],你可以创建 `.vuepress/client.js`(或 `.ts`)文件。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
同时,你还可以通过 [frontmatter][frontmatter] 在每个页面上添加页面级别的配置。
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
## 布局与自定义
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
以下是 `@vuepress/theme-default` 主题中常用的布局配置:
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
- [导航栏][navbar]
|
|
|
|
|
- [侧边栏][sidebar]
|
2024-12-22 15:36:03 +08:00
|
|
|
|
|
2024-12-22 23:25:14 +08:00
|
|
|
|
有关完整的主题配置参考,请查阅[默认主题文档][default-theme]。
|
|
|
|
|
|
|
|
|
|
你还可以通过 `.vuepress/styles/index.scss` 文件[添加额外的样式][style]。
|
|
|
|
|
|
|
|
|
|
## Git 教程
|
|
|
|
|
|
|
|
|
|
以下是一个简单的 Git 教程,帮助你快速上手 Git 版本管理工具。
|
|
|
|
|
|
|
|
|
|
### 安装 Git
|
|
|
|
|
|
|
|
|
|
1. 从 [Git 官网](https://git-scm.com/) 下载并安装 Git。
|
|
|
|
|
2. 安装完成后,打开终端并运行以下命令以验证安装:
|
|
|
|
|
```bash
|
|
|
|
|
git --version
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 初始化仓库
|
|
|
|
|
|
|
|
|
|
1. 创建一个新的项目文件夹:
|
|
|
|
|
```bash
|
|
|
|
|
mkdir my-project
|
|
|
|
|
cd my-project
|
|
|
|
|
```
|
|
|
|
|
2. 初始化 Git 仓库:
|
|
|
|
|
```bash
|
|
|
|
|
git init
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 添加和提交文件
|
|
|
|
|
|
|
|
|
|
1. 创建一个文件:
|
|
|
|
|
```bash
|
|
|
|
|
echo "Hello Git" > README.md
|
|
|
|
|
```
|
|
|
|
|
2. 添加文件到暂存区:
|
|
|
|
|
```bash
|
|
|
|
|
git add README.md
|
|
|
|
|
```
|
|
|
|
|
3. 提交文件到仓库:
|
|
|
|
|
```bash
|
|
|
|
|
git commit -m "首次提交"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 关联远程仓库
|
|
|
|
|
|
|
|
|
|
1. 访问 [GitHub](https://github.com/) 或其他代码托管平台,创建一个新的仓库。
|
|
|
|
|
2. 将本地仓库与远程仓库关联:
|
|
|
|
|
```bash
|
|
|
|
|
git remote add origin https://github.com/your-username/your-repository.git
|
|
|
|
|
```
|
|
|
|
|
3. 推送代码到远程仓库:
|
|
|
|
|
```bash
|
|
|
|
|
git push -u origin main
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 克隆仓库
|
|
|
|
|
|
|
|
|
|
从远程仓库克隆代码到本地:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
git clone https://github.com/your-username/your-repository.git
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 常用命令
|
|
|
|
|
|
|
|
|
|
- 查看当前状态:
|
|
|
|
|
```bash
|
|
|
|
|
git status
|
|
|
|
|
```
|
|
|
|
|
- 查看提交记录:
|
|
|
|
|
```bash
|
|
|
|
|
git log
|
|
|
|
|
```
|
|
|
|
|
- 创建新分支:
|
|
|
|
|
```bash
|
|
|
|
|
git branch new-branch
|
|
|
|
|
git checkout new-branch
|
|
|
|
|
```
|
|
|
|
|
- 合并分支:
|
|
|
|
|
```bash
|
|
|
|
|
git checkout main
|
|
|
|
|
git merge new-branch
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
更多详细信息,请参考 [Git 官方文档](https://git-scm.com/doc)。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 参考链接
|
|
|
|
|
|
|
|
|
|
- [路由][routing]
|
|
|
|
|
- [内容渲染][content]
|
|
|
|
|
- [语法扩展][syntax-extensions]
|
|
|
|
|
- [使用 Vue 功能][vue-feature]
|
|
|
|
|
- [站点配置][config]
|
|
|
|
|
- [客户端配置][client-config]
|
|
|
|
|
- [Frontmatter][frontmatter]
|
|
|
|
|
- [导航栏配置][navbar]
|
|
|
|
|
- [侧边栏配置][sidebar]
|
|
|
|
|
- [默认主题文档][default-theme]
|
|
|
|
|
- [样式自定义][style]
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 链接说明
|
|
|
|
|
|
|
|
|
|
- [routing]: https://vuejs.press/guide/page.html#routing
|
|
|
|
|
- [content]: https://vuejs.press/guide/page.html#content
|
|
|
|
|
- [syntax-extensions]: https://vuejs.press/guide/markdown.html#syntax-extensions
|
|
|
|
|
- [vue-feature]: https://vuejs.press/guide/markdown.html#using-vue-in-markdown
|
|
|
|
|
- [config]: https://vuejs.press/guide/configuration.html#client-config-file
|
|
|
|
|
- [client-config]: https://vuejs.press/guide/configuration.html#client-config-file
|
|
|
|
|
- [frontmatter]: https://vuejs.press/guide/page.html#frontmatter
|
|
|
|
|
- [navbar]: https://vuejs.press/reference/default-theme/config.html#navbar
|
|
|
|
|
- [sidebar]: https://vuejs.press/reference/default-theme/config.html#sidebar
|
|
|
|
|
- [default-theme]: https://vuejs.press/reference/default-theme/
|
|
|
|
|
- [style]: https://vuejs.press/reference/default-theme/styles.html#style-file
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 修改说明
|
|
|
|
|
|
|
|
|
|
1. 将内容翻译为中文。
|
|
|
|
|
2. 添加了一个简单的 Git 教程,包含安装、基本使用和常用命令。
|
|
|
|
|
3. 保留了原始参考链接,方便用户查阅详细文档。
|
|
|
|
|
|
|
|
|
|
你可以直接将此内容粘贴到 VuePress 项目的 Markdown 文件中使用。
|