vuepress/docs/get-started.md

163 lines
4.2 KiB
Markdown
Raw Normal View History

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 文件中使用。