vuepress/docs/get-started.md
曙光 e85e8b1ac7
Some checks are pending
部署文档 / deploy-gh-pages (push) Waiting to run
fix: 修改vuepress为中文
2024-12-22 23:25:14 +08:00

163 lines
4.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

以下是将你的内容改为中文并添加 Git 教程的版本:
---
# 快速开始
这是一个普通页面,包含 VuePress 的基础知识。
## 页面
你可以在 VuePress 项目目录中添加 Markdown 文件,每个 Markdown 文件都会被转换为站点中的一个页面。
更多详细信息请参考[路由][routing]。
## 内容
每个 Markdown 文件[将会被渲染为 HTML然后转换为一个 Vue 单文件组件][content]。
VuePress 支持基础的 Markdown 语法和[一些扩展语法][syntax-extensions],你还可以在其中[使用 Vue 的功能][vue-feature]。
## 配置
VuePress 使用 `.vuepress/config.js`(或 `.ts`)文件作为[站点配置][config],可以用它来配置你的站点。
对于[客户端配置][client-config],你可以创建 `.vuepress/client.js`(或 `.ts`)文件。
同时,你还可以通过 [frontmatter][frontmatter] 在每个页面上添加页面级别的配置。
## 布局与自定义
以下是 `@vuepress/theme-default` 主题中常用的布局配置:
- [导航栏][navbar]
- [侧边栏][sidebar]
有关完整的主题配置参考,请查阅[默认主题文档][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 文件中使用。