From 550496c9a5ab5375eda23548f45419895646f182 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B8=85=E7=A7=8B?= <1044514593@qq.com>
Date: Sat, 15 May 2021 05:51:46 +0800
Subject: [PATCH 1/3] docs(cn): guide/index.md translation
---
guide/index.md | 90 +++++++++++++++++++++++++-------------------------
1 file changed, 45 insertions(+), 45 deletions(-)
diff --git a/guide/index.md b/guide/index.md
index 0826c14c..40e7bdc6 100644
--- a/guide/index.md
+++ b/guide/index.md
@@ -1,63 +1,63 @@
-# Getting Started
+# 开始 {#getting-started}
-## Overview
+## 总览 {#overview}
-Slidev (slide + dev, `/slʌɪdɪv/`) is a web-based slides maker and presenter. It's designed for developers to focus on writing content in Markdown while also having the power of HTML and Vue components to deliver pixel-perfect layouts and designs with embedded interactive demos in your presentations.
+Slidev (slide + dev, `/slʌɪdɪv/`) 是基于 Web 的幻灯片制作和演示工具。它旨在让开发者专注在 Markdown 中编写内容，同时拥有支持 HTML 和 Vue 组件的能力，并且能够呈现像素级完美的布局，还在你的演讲稿中内置了互动的演示样例。
-It uses a feature-rich markdown file to generate beautiful slides with an instant reloading experience, along with many built-in integrations such as live coding, PDF exporting, presentation recording, and so on. Since it's powered by the web, you can do anything with Slidev - the possibilities are endless.
+它使用了功能丰富的 markdown 文件来生成精美的幻灯片，具有即时重载的体验。它还拥有很多内置的集成功能，如实时编码、导出 PDF、演讲录制等。由于 Slidev 是由 web 驱动的，因此你可以使用它进行任何操作 —— 具有无限的可能性。
-You can learn more about the rationale behind the project in the [Why Slidev](/guide/why) section.
+你可以在 [为什么选 Slidev](/guide/why) 部分了解更多关于本项目的设计初衷。
-### Features
+### 功能 {#features}
-- 📝 [**Markdown-based**](/guide/syntax.html) - use your favorite editors and workflow
-- 🧑💻 [**Developer Friendly**](/guide/syntax.html#code-blocks) - built-in syntax highlighting, live coding, etc.
-- 🎨 [**Themable**](/themes/gallery.html) - theme can be shared and used with npm packages
-- 🌈 [**Stylish**](/guide/syntax.html#embedded-styles) - [Windi CSS](https://windicss.org/) on-demand utilities, easy-to-use embedded stylesheets
-- 🤹 [**Interactive**](/custom/directory-structure.html#components) - embedding Vue components seamlessly
-- 🎙 [**Presenter Mode**](/guide/presenter-mode.html) - use another window, or even your phone to control your slides
-- 🧮 [**LaTeX**](/guide/syntax.html#latex) - Built-in LaTeX math equations support
-- 📰 [**Diagrams**](/guide/syntax.html#diagrams) - Creates diagrams with textual descriptions
-- 🌟 [**Icons**](/guide/syntax.html#icons) - Access to icons from any iconset directly
-- 💻 [**Editors**](/guide/editors.html) - Integrated editor, or [extension for VS Code](https://github.com/slidevjs/slidev-vscode)
-- 🎥 [**Recording**](/guide/recording.html) - built-in recording and camera view
-- 📤 [**Portable**](/guide/exporting.html) - export into PDF, PNGs, or even a hostable SPA
-- ⚡️ [**Fast**](https://vitejs.dev) - instant reloading powered by [Vite](https://vitejs.dev)
-- 🛠 [**Hackable**](/custom/config-vite.html) - using Vite plugins, Vue components, or any npm packages
+- 📝 [**Markdown 支持**](/guide/syntax.html) —— 使用你最喜欢的编辑器和工作流编写 Markdown 文件
+- 🧑💻 [**对开发者友好**](/guide/syntax.html#code-blocks) —— 内置代码高亮、实时编码等功能
+- 🎨 [**可定制主题**](/themes/gallery.html) —— 以 npm 包的形式共享、使用主题
+- 🌈 [**灵活样式**](/guide/syntax.html#embedded-styles) —— 使用 [Windi CSS](https://windicss.org/) 按需使用的实用类和易用的内嵌样式表
+- 🤹 [**交互**](/custom/directory-structure.html#components) —— 无缝嵌入 Vue 组件
+- 🎙 [**演示者模式**](/guide/presenter-mode.html) —— 可以使用另一个窗口，甚至是你的手机来控制幻灯片
+- 🧮 [**LaTeX 支持**](/guide/syntax.html#latex) —— 内置了对 LaTeX 数学公示的支持
+- 📰 [**图表支持**](/guide/syntax.html#diagrams) —— 使用文本描述语言创建图表
+- 🌟 [**图标**](/guide/syntax.html#icons) —— 能够直接从任意图标库中获取图标
+- 💻 [**编辑器**](/guide/editors.html) —— 集成的编辑器，或者使用 [VS Code 扩展](https://github.com/slidevjs/slidev-vscode)
+- 🎥 [**录制**](/guide/recording.html) —— 内置录制功能和摄像头视图
+- 📤 [**跨平台**](/guide/exporting.html) —— 能够导出 PDF、PNG 文件，甚至是一个可以托管的单页应用
+- ⚡️ [**快速**](https://vitejs.dev) —— 基于 [Vite](https://vitejs.dev) 的即时重载
+- 🛠 [**可配置**](/custom/config-vite.html) —— 支持使用 Vite 插件、Vue 组件以及任何的 npm 包
-### Tech Stack
+### 技术栈 {#tech-stack}
-Slidev is made possible by combining these tools and technologies.
+Slidev 使用了如下的工具和技术：
-- [Vite](https://vitejs.dev) - An extremely fast frontend tooling
-- [Vue 3](https://v3.vuejs.org/) powered [Markdown](https://daringfireball.net/projects/markdown/syntax) - Focus on the content while having the power of HTML and Vue components whenever needed
-- [Windi CSS](https://github.com/windicss/windicss) - On-demand utility-first CSS framework, style your slides at ease
-- [Prism](https://github.com/PrismJS/prism), [Shiki](https://github.com/shikijs/shiki), [Monaco Editor](https://github.com/Microsoft/monaco-editor) - First-class code snippets support with live coding capability
-- [RecordRTC](https://recordrtc.org) - Built-in recording and camera view
-- [VueUse](https://vueuse.org) family - [`@vueuse/core`](https://github.com/vueuse/vueuse), [`@vueuse/head`](https://github.com/vueuse/head), [`@vueuse/motion`](https://github.com/vueuse/motion), etc.
-- [Iconify](https://iconify.design/) - Iconsets collection.
-- [KaTeX](https://katex.org/) - LaTeX math rendering.
-- [Mermaid](https://mermaid-js.github.io/mermaid) - Textual Diagrams.
+- [Vite](https://vitejs.dev) —— 一款极速的前端工具
+- 基于 [Vue 3](https://v3.vuejs.org/) 的 [Markdown](https://daringfireball.net/projects/markdown/syntax) —— 专注内容的同时，具备 HTML 和 Vue 组件的能力
+- [Windi CSS](https://github.com/windicss/windicss) —— 按需、实用类优先的 CSS 框架，轻松定制你的幻灯片样式
+- [Prism](https://github.com/PrismJS/prism), [Shiki](https://github.com/shikijs/shiki), [Monaco Editor](https://github.com/Microsoft/monaco-editor) —— 具有实时编码能力的一流代码片段支持
+- [RecordRTC](https://recordrtc.org) —— 内置录制功能和摄像头视图
+- [VueUse](https://vueuse.org) 家族 —— [`@vueuse/core`](https://github.com/vueuse/vueuse)、[`@vueuse/head`](https://github.com/vueuse/head)、[`@vueuse/motion`](https://github.com/vueuse/motion) 等
+- [Iconify](https://iconify.design/) —— 图标库集合
+- [KaTeX](https://katex.org/) —— LaTeX 数学渲染
+- [Mermaid](https://mermaid-js.github.io/mermaid) —— 文本描述语言创建图表
-### Scaffolding Your First Presentation
+### 搭建你的第一个演讲稿 {#scaffolding-your-first-presentation}
-With NPM:
+使用 NPM：
```bash
$ npm init slidev
```
-With Yarn:
+使用 Yarn：
```bash
$ yarn create slidev
```
-Follow the prompts and start making your slides now! For more details about the markdown syntax, read through the [syntax guide](/guide/syntax).
+根据提示开始创建你的幻灯片吧！想要了解更多关于 markdown 的语法，请阅读 [语法指南](/guide/syntax)。
-### Command Line Interface
+### 命令行界面 {#command-line-interface}
-In a project where Slidev is installed, you can use the `slidev` binary in your npm scripts.
+在安装了 Slidev 的项目里，你可以在你的 npm script 里使用 `slidev` 命令。
```json
{
@@ -69,17 +69,17 @@ In a project where Slidev is installed, you can use the `slidev` binary in your
}
```
-Otherwise, you can use it with [`npx`](https://www.npmjs.com/package/npx)
+或者，你也可以使用 [`npx`](https://www.npmjs.com/package/npx)
```bash
$ npx slidev
```
-Run `slidev --help` for more options available.
+执行 `slidev --help` 命令获取更多选项的详细信息。
-### Markdown Syntax
+### Markdown 语法 {#markdown-syntax}
-Slidev reads your `slides.md` file under your project root and converts them into slides. Whenever you made changes to it, the content of the slides will be updated immediately. For example:
+Slidev 会读取位于项目根目录的 `slides.md` 文件，并将其转换为幻灯片。每当你修改 markdown 文件，幻灯片的内容都会立刻随之更新。例如：
~~~md
# Slidev
@@ -88,9 +88,9 @@ Hello World
---
-# Page 2
+# 页面 2
-Directly use code blocks for highlighting
+直接使用代码块，能够实现代码高亮
//```ts
console.log('Hello, World!')
@@ -98,7 +98,7 @@ console.log('Hello, World!')
---
-# Page 3
+# 页面 3
~~~
-Read more about the Slidev Markdown syntax in the [syntax guide](/guide/syntax).
+请阅读 [语法指南](/guide/syntax) 获取更多关于 Slidev Markdown 语法的内容。
From b0076fd29dcf3791a87c3255126932dc6ba89c33 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B8=85=E7=A7=8B?= <1044514593@qq.com>
Date: Sat, 15 May 2021 05:56:11 +0800
Subject: [PATCH 2/3] docs(cn): translation complement
---
guide/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/guide/index.md b/guide/index.md
index 40e7bdc6..ecc4ce6e 100644
--- a/guide/index.md
+++ b/guide/index.md
@@ -62,9 +62,9 @@ $ yarn create slidev
```json
{
"scripts": {
- "dev": "slidev", // start dev server
- "build": "slidev build", // build for production SPA
- "export": "slidev export" // export slides to pdf
+ "dev": "slidev", // 启动 dev server
+ "build": "slidev build", // 构建生产环境的单页面应用
+ "export": "slidev export" // 将幻灯片导出为 pdf 格式
}
}
```
From b848099cd8d0baed76acae4b468836be39551aba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B8=85=E7=A7=8B?= <1044514593@qq.com>
Date: Sat, 15 May 2021 06:26:28 +0800
Subject: [PATCH 3/3] =?UTF-8?q?fix:=20=E8=B0=83=E6=95=B4=20Page=20X=20?=
=?UTF-8?q?=E7=9A=84=E8=AF=91=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
guide/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/guide/index.md b/guide/index.md
index ecc4ce6e..c9fa97b9 100644
--- a/guide/index.md
+++ b/guide/index.md
@@ -88,7 +88,7 @@ Hello World
---
-# 页面 2
+# 第 2 页
直接使用代码块，能够实现代码高亮
@@ -98,7 +98,7 @@ console.log('Hello, World!')
---
-# 页面 3
+# 第 3 页
~~~
请阅读 [语法指南](/guide/syntax) 获取更多关于 Slidev Markdown 语法的内容。