Skip to content

Commit

Permalink
init
Browse files Browse the repository at this point in the history
  • Loading branch information
XasYer committed Feb 28, 2024
0 parents commit ca5b938
Show file tree
Hide file tree
Showing 8 changed files with 233 additions and 0 deletions.
68 changes: 68 additions & 0 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# 构建 VitePress 站点并将其部署到 GitHub Pages 的示例工作流程
#
name: Deploy VitePress site to Pages

on:
# 在针对 `main` 分支的推送上运行。如果你
# 使用 `master` 分支作为默认分支,请将其更改为 `master`
push:
branches: [docs]

# 允许你从 Actions 选项卡手动运行此工作流程
workflow_dispatch:

# 设置 GITHUB_TOKEN 的权限,以允许部署到 GitHub Pages
permissions:
contents: read
pages: write
id-token: write

# 只允许同时进行一次部署,跳过正在运行和最新队列之间的运行队列
# 但是,不要取消正在进行的运行,因为我们希望允许这些生产部署完成
concurrency:
group: pages
cancel-in-progress: false

jobs:
# 构建工作
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0 # 如果未启用 lastUpdated,则不需要
- uses: pnpm/action-setup@v2 # 如果使用 pnpm,请取消注释
with:
version: 8.15.1
# - uses: oven-sh/setup-bun@v1 # 如果使用 Bun,请取消注释
- name: Setup Node
uses: actions/setup-node@v4
with:
node-version: 20
cache: pnpm # 或 pnpm / yarn
- name: Setup Pages
uses: actions/configure-pages@v4
- name: Install dependencies
run: pnpm install # 或 pnpm install / yarn install / bun install
- name: Build with VitePress
run: |
pnpm run docs:build
touch .vitepress/dist/.nojekyll
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: .vitepress/dist

# 部署工作
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
needs: build
runs-on: ubuntu-latest
name: Deploy
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
22 changes: 22 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# build output
dist/

# dependencies
node_modules/

# logs
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*

# environment variables
.env
.env.production

# macOS-specific files
.DS_Store

# vitepress
docs/.vitepress/dist
docs/.vitepress/cache
36 changes: 36 additions & 0 deletions .vitepress/config.mts
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
import { defineConfig } from 'vitepress'

// https://vitepress.dev/reference/site-config
export default defineConfig({
title: "Shiranai-Plugin",
description: "希腊奶文档",
themeConfig: {
// https://vitepress.dev/reference/default-theme-config
editLink: {
pattern: 'https://github.com/XasYer/ws-plugin-docs/tree/docs/:path',
text: '编辑此页面'
},
nav: [
{ text: 'Home', link: '/' },
{ text: 'Examples', link: '/markdown-examples' }
],
search: {
provider: 'local'
},
sidebar: [
{
text: 'Examples',
items: [
{ text: '快速开始', link: '/start' },
{ text: 'Runtime API Examples', link: '/api-examples' }
]
}
],

socialLinks: [
{ icon: 'github', link: 'https://github.com/XasYer/Shiranai-Plugin' }
],
},
cleanUrls: true,
base: '/Shiranai-Plugin/'
})
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Shiranai-Plugin docs
Shiranai-Plugin for TRSS-Yunzai & QQBot-Plugin
49 changes: 49 additions & 0 deletions api-examples.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
outline: deep
---

# Runtime API Examples

This page demonstrates usage of some of the runtime APIs provided by VitePress.

The main `useData()` API can be used to access site, theme, and page data for the current page. It works in both `.md` and `.vue` files:

```md
<script setup>
import { useData } from 'vitepress'

const { theme, page, frontmatter } = useData()
</script>

## Results

### Theme Data
<pre>{{ theme }}</pre>

### Page Data
<pre>{{ page }}</pre>

### Page Frontmatter
<pre>{{ frontmatter }}</pre>
```

<script setup>
import { useData } from 'vitepress'

const { site, theme, page, frontmatter } = useData()
</script>

## Results

### Theme Data
<pre>{{ theme }}</pre>

### Page Data
<pre>{{ page }}</pre>

### Page Frontmatter
<pre>{{ frontmatter }}</pre>

## More

Check out the documentation for the [full list of runtime APIs](https://vitepress.dev/reference/runtime-api#usedata).
25 changes: 25 additions & 0 deletions index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
# https://vitepress.dev/reference/default-theme-home-page
layout: home

hero:
name: "Shiranai-Plugin"
# text: "希腊奶文档"
tagline: 专注于QQBot的游戏插件
actions:
- theme: brand
text: 快速开始
link: /start
- theme: alt
text: 游戏文档
link: /api-examples

features:
- title: 游戏
details: 致力于大部分经典游戏
- title: 按钮
details: 使用按钮进行交互
- title: Feature C
details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
---

18 changes: 18 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"name": "Shiranai-Plugin",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"docs:dev": "vitepress dev",
"docs:build": "vitepress build",
"docs:preview": "vitepress preview"
},
"keywords": [],
"author": "",
"license": "MIT",
"devDependencies": {
"vitepress": "1.0.0-rc.44"
}
}
13 changes: 13 additions & 0 deletions start.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# 快速开始

阅读本文档立刻开始使用

## 安装插件

打开 `TRSS-Yunzai` 根目录执行以下命令

```sh
git clone --depth=1 https://github.com/XasYer/Shiranai-Plugin.git ./plugins/Shiranai-Plugin/
pnpm install --filter=Shiranai-Plugin
```

0 comments on commit ca5b938

Please sign in to comment.