mirror of
https://github.com/LiteyukiStudio/LiteyukiBot.git
synced 2025-07-27 14:30:54 +00:00
docs: vuepress构建文档
This commit is contained in:
9
docs/demo/README.md
Normal file
9
docs/demo/README.md
Normal file
@ -0,0 +1,9 @@
|
||||
---
|
||||
title: 主要功能与配置演示
|
||||
index: false
|
||||
icon: laptop-code
|
||||
category:
|
||||
- 使用指南
|
||||
---
|
||||
|
||||
<Catalog />
|
||||
42
docs/demo/disable.md
Normal file
42
docs/demo/disable.md
Normal file
@ -0,0 +1,42 @@
|
||||
---
|
||||
title: 布局与功能禁用
|
||||
icon: gears
|
||||
order: 4
|
||||
category:
|
||||
- 使用指南
|
||||
tag:
|
||||
- 禁用
|
||||
|
||||
navbar: false
|
||||
sidebar: false
|
||||
|
||||
breadcrumb: false
|
||||
pageInfo: false
|
||||
contributors: false
|
||||
editLink: false
|
||||
lastUpdated: false
|
||||
prev: false
|
||||
next: false
|
||||
comment: false
|
||||
footer: false
|
||||
|
||||
backtotop: false
|
||||
---
|
||||
|
||||
你可以通过设置页面的 Frontmatter，在页面禁用功能与布局。
|
||||
|
||||
<!-- more -->
|
||||
|
||||
本页面就是一个示例，禁用了如下功能:
|
||||
|
||||
- 导航栏
|
||||
- 侧边栏
|
||||
- 路径导航
|
||||
- 页面信息
|
||||
- 贡献者
|
||||
- 编辑此页链接
|
||||
- 更新时间
|
||||
- 上一篇/下一篇 链接
|
||||
- 评论
|
||||
- 页脚
|
||||
- 返回顶部按钮
|
||||
15
docs/demo/encrypt.md
Normal file
15
docs/demo/encrypt.md
Normal file
@ -0,0 +1,15 @@
|
||||
---
|
||||
icon: lock
|
||||
category:
|
||||
- 使用指南
|
||||
tag:
|
||||
- 加密
|
||||
---
|
||||
|
||||
# 密码加密的文章
|
||||
|
||||
实际的文章内容。
|
||||
|
||||
段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字段落 1 文字。
|
||||
|
||||
段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字段落 2 文字。
|
||||
31
docs/demo/layout.md
Normal file
31
docs/demo/layout.md
Normal file
@ -0,0 +1,31 @@
|
||||
---
|
||||
title: 布局
|
||||
icon: object-group
|
||||
order: 2
|
||||
category:
|
||||
- 指南
|
||||
tag:
|
||||
- 布局
|
||||
---
|
||||
|
||||
布局包括:
|
||||
|
||||
- [导航栏](https://theme-hope.vuejs.press/zh/guide/layout/navbar.html)
|
||||
- [侧边栏](https://theme-hope.vuejs.press/zh/guide/layout/sidebar.html)
|
||||
- [页脚](https://theme-hope.vuejs.press/zh/guide/layout/footer.html)
|
||||
|
||||
同时每个页面包含:
|
||||
|
||||
- [路径导航](https://theme-hope.vuejs.press/zh/guide/layout/breadcrumb.html)
|
||||
- [标题和页面信息](https://theme-hope.vuejs.press/zh/guide/feature/page-info.html)
|
||||
- [TOC (文章标题列表)](https://theme-hope.vuejs.press/zh/guide/layout/page.html#标题列表)
|
||||
- [贡献者、更新时间等页面元信息](https://theme-hope.vuejs.press/guide/feature/meta.html)
|
||||
- [评论](https://theme-hope.vuejs.press/zh/guide/feature/comment.html)
|
||||
|
||||
主题也带有以下元素:
|
||||
|
||||
- [夜间模式按钮](https://theme-hope.vuejs.press/zh/guide/interface/darkmode.html)
|
||||
- [返回顶部按钮](https://theme-hope.vuejs.press/guide/interface/others.html#返回顶部按钮)
|
||||
- [打印按钮](https://theme-hope.vuejs.press/guide/interface/others.html#打印按钮)
|
||||
|
||||
你可以在主题选项和页面的 frontmatter 中自定义它们。
|
||||
269
docs/demo/markdown.md
Normal file
269
docs/demo/markdown.md
Normal file
@ -0,0 +1,269 @@
|
||||
---
|
||||
title: Markdown 展示
|
||||
icon: fab fa-markdown
|
||||
order: 2
|
||||
category:
|
||||
- 使用指南
|
||||
tag:
|
||||
- Markdown
|
||||
---
|
||||
|
||||
VuePress 主要从 Markdown 文件生成页面。因此，你可以使用它轻松生成文档或博客站点。
|
||||
|
||||
你应该创建和编写 Markdown 文件，以便 VuePress 可以根据文件结构将它们转换为不同的页面。
|
||||
|
||||
<!-- more -->
|
||||
|
||||
## Markdown 介绍
|
||||
|
||||
如果你是一个新手，还不会编写 Markdown，请先阅读 [Markdown 介绍](https://theme-hope.vuejs.press/zh/cookbook/markdown/) 和 [Markdown 演示](https://theme-hope.vuejs.press/zh/cookbook/markdown/demo.html)。
|
||||
|
||||
## Markdown 配置
|
||||
|
||||
VuePress 通过 Frontmatter 为每个 Markdown 页面引入配置。
|
||||
|
||||
::: info
|
||||
|
||||
Frontmatter 是 VuePress 中很重要的一个概念，如果你不了解它，你需要阅读 [Frontmatter 介绍](https://theme-hope.vuejs.press/zh/cookbook/vuepress/page.html#front-matter)。
|
||||
|
||||
:::
|
||||
|
||||
## Markdown 扩展
|
||||
|
||||
VuePress 会使用 [markdown-it](https://github.com/markdown-it/markdown-it) 来解析 Markdown 内容，因此可以借助于 markdown-it 插件来实现 [语法扩展](https://github.com/markdown-it/markdown-it#syntax-extensions) 。
|
||||
|
||||
### VuePress 扩展
|
||||
|
||||
为了丰富文档写作，VuePress 对 Markdown 语法进行了扩展。
|
||||
|
||||
关于这些扩展，请阅读 [VuePress 中的 Markdown 扩展](https://theme-hope.vuejs.press/zh/cookbook/vuepress/markdown.html)。
|
||||
|
||||
### 主题扩展
|
||||
|
||||
通过 [`vuepress-plugin-md-enhance`][md-enhance]，主题扩展了更多 Markdown 语法，提供更加丰富的写作功能。
|
||||
|
||||
#### 提示容器
|
||||
|
||||
::: v-pre
|
||||
|
||||
安全的在 Markdown 中使用 {{ variable }}。
|
||||
|
||||
:::
|
||||
|
||||
::: info 自定义标题
|
||||
|
||||
信息容器，包含 `代码` 与 [链接](#提示容器)。
|
||||
|
||||
```js
|
||||
const a = 1;
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
::: tip 自定义标题
|
||||
|
||||
提示容器
|
||||
|
||||
:::
|
||||
|
||||
::: warning 自定义标题
|
||||
|
||||
警告容器
|
||||
|
||||
:::
|
||||
|
||||
::: caution 自定义标题
|
||||
|
||||
危险容器
|
||||
|
||||
:::
|
||||
|
||||
::: details 自定义标题
|
||||
|
||||
详情容器
|
||||
|
||||
:::
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/hint.html)
|
||||
|
||||
#### 代码块
|
||||
|
||||
::: code-tabs
|
||||
|
||||
@tab pnpm
|
||||
|
||||
```bash
|
||||
pnpm add -D vuepress-theme-hope
|
||||
```
|
||||
|
||||
@tab yarn
|
||||
|
||||
```bash
|
||||
yarn add -D vuepress-theme-hope
|
||||
```
|
||||
|
||||
@tab:active npm
|
||||
|
||||
```bash
|
||||
npm i -D vuepress-theme-hope
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/code-tabs.html)
|
||||
|
||||
#### 上下角标
|
||||
|
||||
19^th^ H~2~O
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/sup-sub.html)
|
||||
|
||||
#### 自定义对齐
|
||||
|
||||
::: center
|
||||
|
||||
我是居中的
|
||||
|
||||
:::
|
||||
|
||||
::: right
|
||||
|
||||
我在右对齐
|
||||
|
||||
:::
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/align.html)
|
||||
|
||||
#### Attrs
|
||||
|
||||
一个拥有 ID 的 **单词**{#word}。
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/attrs.html)
|
||||
|
||||
#### 脚注
|
||||
|
||||
此文字有脚注[^first].
|
||||
|
||||
[^first]: 这是脚注内容
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/footnote.html)
|
||||
|
||||
#### 标记
|
||||
|
||||
你可以标记 ==重要的内容== 。
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/mark.html)
|
||||
|
||||
#### 任务列表
|
||||
|
||||
- [x] 计划 1
|
||||
- [ ] 计划 2
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/tasklist.html)
|
||||
|
||||
### 图片增强
|
||||
|
||||
支持为图片设置颜色模式和大小
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/image.html)
|
||||
|
||||
#### 组件
|
||||
|
||||
```component VPCard
|
||||
title: Mr.Hope
|
||||
desc: Where there is light, there is hope
|
||||
logo: https://mister-hope.com/logo.svg
|
||||
link: https://mister-hope.com
|
||||
background: rgba(253, 230, 138, 0.15)
|
||||
```
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/component.html)
|
||||
|
||||
#### 导入文件
|
||||
|
||||
<!-- @include: ./README.md{11-17} -->
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/include.html)
|
||||
|
||||
#### 样式化
|
||||
|
||||
向 Mr.Hope 捐赠一杯咖啡。 _Recommended_
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/stylize.html)
|
||||
|
||||
#### Tex 语法
|
||||
|
||||
$$
|
||||
\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right)
|
||||
= \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^i r \cdots (r-i+1) (\log y)^{r-i}} {\omega^i} \right\}
|
||||
$$
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/tex.html)
|
||||
|
||||
#### 图表
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/chartjs.html" width="100%" height="450"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/chartjs.html)
|
||||
|
||||
#### Echarts
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/echarts.html" width="100%" height="800"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/echarts.html)
|
||||
|
||||
#### 流程图
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/flowchart.html" width="100%" height="450"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/flowchart.html)
|
||||
|
||||
#### MarkMap
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/markmap.html" width="100%" height="380"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/markmap.html)
|
||||
|
||||
#### Mermaid
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/mermaid.html" width="100%" height="620"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/mermaid.html)
|
||||
|
||||
#### 代码演示
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/code-demo.html" width="100%" height="450"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/demo.html)
|
||||
|
||||
#### 交互演示
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/playground.html" width="100%" height="480"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/playground.html)
|
||||
|
||||
#### Kotlin 交互演示
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/kotlin-playground.html" width="100%" height="220"/>
|
||||
|
||||
- [View Detail](https://theme-hope.vuejs.press/zh/guide/markdown/kotlin-playground.html)
|
||||
|
||||
#### Vue 交互演示
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/vue-playground.html" width="100%" height="380"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/vue-playground.html)
|
||||
|
||||
#### Sandpack 交互演示
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/sandpack.html" width="100%" height="380"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/sandpack.html)
|
||||
|
||||
#### 幻灯片
|
||||
|
||||
<iframe src="https://plugin-md-enhance-demo.vuejs.press/snippet/revealjs.html" width="100%" height="400"/>
|
||||
|
||||
- [查看详情](https://theme-hope.vuejs.press/zh/guide/markdown/revealjs.html)
|
||||
|
||||
[md-enhance]: https://plugin-md-enhance.vuejs.press/zh/
|
||||
125
docs/demo/page.md
Normal file
125
docs/demo/page.md
Normal file
@ -0,0 +1,125 @@
|
||||
---
|
||||
# 这是文章的标题
|
||||
title: 页面配置
|
||||
# 你可以自定义封面图片
|
||||
cover: /assets/images/cover1.jpg
|
||||
# 这是页面的图标
|
||||
icon: file
|
||||
# 这是侧边栏的顺序
|
||||
order: 3
|
||||
# 设置作者
|
||||
author: Ms.Hope
|
||||
# 设置写作时间
|
||||
date: 2020-01-01
|
||||
# 一个页面可以有多个分类
|
||||
category:
|
||||
- 使用指南
|
||||
# 一个页面可以有多个标签
|
||||
tag:
|
||||
- 页面配置
|
||||
- 使用指南
|
||||
# 此页面会在文章列表置顶
|
||||
sticky: true
|
||||
# 此页面会出现在星标文章中
|
||||
star: true
|
||||
# 你可以自定义页脚
|
||||
footer: 这是测试显示的页脚
|
||||
# 你可以自定义版权信息
|
||||
copyright: 无版权
|
||||
---
|
||||
|
||||
`more` 注释之前的内容被视为文章摘要。
|
||||
|
||||
<!-- more -->
|
||||
|
||||
## 页面标题
|
||||
|
||||
The first H1 title in Markdown will be regarded as page title.
|
||||
|
||||
Markdown 中的第一个 H1 标题会被视为页面标题。
|
||||
|
||||
你可以在 Markdown 的 Frontmatter 中设置页面标题。
|
||||
|
||||
```md
|
||||
---
|
||||
title: 页面标题
|
||||
---
|
||||
```
|
||||
|
||||
## 页面信息
|
||||
|
||||
你可以在 Markdown 的 Frontmatter 中设置页面信息。
|
||||
|
||||
- 作者设置为 Ms.Hope。
|
||||
- 写作日期为 2020 年 1 月 1 日
|
||||
- 分类为 “使用指南”
|
||||
- 标签为 “页面配置” 和 “使用指南”
|
||||
|
||||
## 页面内容
|
||||
|
||||
你可以自由在这里书写你的 Markdown。
|
||||
|
||||
::: tip 图片引入
|
||||
|
||||
- 你可以将图片和 Markdown 文件放置在一起使用相对路径进行引用。
|
||||
- 对于 `.vuepress/public` 文件夹的图片，请使用绝对链接 `/` 进行引用。
|
||||
|
||||
:::
|
||||
|
||||
## 组件
|
||||
|
||||
每个 Markdown 页面都会被转换为一个 Vue 组件，这意味着你可以在 Markdown 中使用 Vue 语法：
|
||||
|
||||
{{ 1 + 1 }}
|
||||
|
||||
<!-- markdownlint-disable MD033 -->
|
||||
|
||||
<ul>
|
||||
<li v-for="i in 3">{{ i }}</li>
|
||||
</ul>
|
||||
|
||||
<!-- markdownlint-enable MD033 -->
|
||||
|
||||
你也可以创建并引入你自己的组件。
|
||||
|
||||
<MyComponent />
|
||||
|
||||
<script setup>
|
||||
import { defineComponent, h, ref } from 'vue';
|
||||
|
||||
const MyComponent = defineComponent({
|
||||
setup() {
|
||||
const input = ref('Hello world!');
|
||||
const onInput = (e) => {
|
||||
input.value = e.target.value;
|
||||
};
|
||||
|
||||
return () => [
|
||||
h('p', [
|
||||
h('span','输入: '),
|
||||
h('input', {
|
||||
value: input.value,
|
||||
onInput,
|
||||
}),
|
||||
]),
|
||||
h('p', [h('span','输出: '), input.value]),
|
||||
];
|
||||
},
|
||||
});
|
||||
</script>
|
||||
|
||||
---
|
||||
|
||||
主题包含一些有用的组件。这里是一些例子:
|
||||
|
||||
- 文字结尾应该有深蓝色的 徽章文字 徽章。 <Badge text="徽章文字" color="#242378" />
|
||||
|
||||
- 一个卡片:
|
||||
|
||||
```component VPCard
|
||||
title: Mr.Hope
|
||||
desc: Where there is light, there is hope
|
||||
logo: https://mister-hope.com/logo.svg
|
||||
link: https://mister-hope.com
|
||||
background: rgba(253, 230, 138, 0.15)
|
||||
```
|
||||
Reference in New Issue
Block a user