Skip to content

Commit cc20314

Browse files
committed
feat: origin
0 parents  commit cc20314

File tree

104 files changed

+13012
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

104 files changed

+13012
-0
lines changed

.github/workflows/deploy.yml

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
name: Deploy to GitHub Pages
2+
3+
on:
4+
workflow_dispatch:
5+
push:
6+
branches:
7+
- main
8+
9+
jobs:
10+
build:
11+
name: Build Docusaurus
12+
runs-on: ubuntu-latest
13+
steps:
14+
- uses: actions/checkout@v4
15+
with:
16+
fetch-depth: 0
17+
- uses: actions/setup-node@v4
18+
with:
19+
node-version: 18
20+
cache: yarn
21+
22+
- name: Install dependencies
23+
run: yarn install --frozen-lockfile
24+
- name: Build website
25+
run: yarn build
26+
27+
- name: Upload Build Artifact
28+
uses: actions/upload-pages-artifact@v3
29+
with:
30+
path: build
31+
32+
deploy:
33+
name: Deploy to GitHub Pages
34+
needs: build
35+
36+
# Grant GITHUB_TOKEN the permissions required to make a Pages deployment
37+
permissions:
38+
pages: write # to deploy to Pages
39+
id-token: write # to verify the deployment originates from an appropriate source
40+
41+
# Deploy to the github-pages environment
42+
environment:
43+
name: github-pages
44+
url: ${{ steps.deployment.outputs.page_url }}
45+
46+
runs-on: ubuntu-latest
47+
steps:
48+
- name: Deploy to GitHub Pages
49+
id: deployment
50+
uses: actions/deploy-pages@v4

.gitignore

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Dependencies
2+
/node_modules
3+
4+
# Production
5+
/build
6+
7+
# Generated files
8+
.docusaurus
9+
.cache-loader
10+
11+
# Misc
12+
.DS_Store
13+
.env.local
14+
.env.development.local
15+
.env.test.local
16+
.env.production.local
17+
18+
npm-debug.log*
19+
yarn-debug.log*
20+
yarn-error.log*

README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
<div align="center">
2+
3+
<img src="https://arceos-hypervisor.github.io/images/site/logo.svg" alt="axvisor-logo" width="64">
4+
5+
</div>
6+
7+
<h2 align="center">AxVisor</h1>
8+
9+
<p align="center">A unified modular hypervisor based on ArceOS</p>
10+
11+
<!-- <div align="center">
12+
13+
[![GitHub stars](https://img.shields.io/github/stars/arceos-hypervisor/AxVisor?logo=github)](https://github.com/arceos-hypervisor/AxVisor/stargazers)
14+
[![GitHub forks](https://img.shields.io/github/forks/arceos-hypervisor/AxVisor?logo=github)](https://github.com/arceos-hypervisor/AxVisor/network)
15+
[![license](https://img.shields.io/github/license/arceos-hypervisor/AxVisor)](https://github.com/ZCShou/GoGoGo/blob/master/LICENSE)
16+
17+
</div> -->
18+
19+
English | [中文版](README_CN.md)
20+
21+
# Introduction
22+
23+
This repository is the source repository for the AxVisor documentation built using [Docusaurus](https://docusaurus.io/). Docusaurus is an open-source website generator tool developed by Meta, based on React, for creating, maintaining, and deploying static websites.
24+
25+
## Development
26+
27+
Docusaurus is actually a set of Node.js packages, so this documentation is essentially a Node.js application. Therefore, the first step is to ensure that the Node.js environment is correctly installed.
28+
29+
1. Yarn is used as the package manager. By default, yarn is not installed in Node.js, so first, use the command `npm install -g yarn` to install it globally.
30+
2. To start development for the first time, you need to run the command `yarn install` to install the required dependencies.
31+
3. Use any editor (VS Code is recommended) to modify the source code and edit new documents (all in Markdown format)
32+
4. Running the command `yarn start` will start a local development server and automatically open a browser window to preview the entire website.
33+
34+
## Deploy
35+
36+
Currently, the AxVisor documentation website is hosted on GitHub Pages. The repository is configured by default to deploy via GitHub Actions. When the source code is committed to the repository, it will automatically trigger GitHub Actions to deploy the website.
37+
38+
> It also supports yarn deploy for deploying to a separate branch (after modifying the repository configuration).
39+
> - Linux:
40+
> - Use SSH:
41+
> ```
42+
> $ USE_SSH=true yarn deploy
43+
> ```
44+
>
45+
> - Not use SSH:
46+
>
47+
> ```
48+
> $ GIT_USER=<Your GitHub username> yarn deploy
49+
> ```
50+
> - Windows PowerShell:
51+
> - Use SSH:
52+
>
53+
> ```
54+
> $ cmd /C 'set "USE_SSH=true" && yarn deploy'
55+
> ```
56+
>
57+
> - Not use SSH:
58+
>
59+
> ```
60+
> $ cmd /C 'set "GIT_USER=<Your GitHub username>" && yarn deploy'
61+
> ```

README_CN.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
<div align="center">
2+
3+
<img src="https://arceos-hypervisor.github.io/images/site/logo.svg" alt="axvisor-logo" width="64">
4+
5+
</div>
6+
7+
<h2 align="center">AxVisor</h1>
8+
9+
<p align="center">一个基于 ArceOS 的统一模块化虚拟机管理程序</p>
10+
11+
<!-- <div align="center">
12+
13+
[![GitHub stars](https://img.shields.io/github/stars/arceos-hypervisor/AxVisor?logo=github)](https://github.com/arceos-hypervisor/AxVisor/stargazers)
14+
[![GitHub forks](https://img.shields.io/github/forks/arceos-hypervisor/AxVisor?logo=github)](https://github.com/arceos-hypervisor/AxVisor/network)
15+
[![license](https://img.shields.io/github/license/arceos-hypervisor/AxVisor)](https://github.com/ZCShou/GoGoGo/blob/master/LICENSE)
16+
17+
</div> -->
18+
19+
[English](README.md) | 中文版
20+
21+
# 简介
22+
23+
本仓库是使用 [Docusaurus](https://docusaurus.io/) 构建 AxVisor 的文档的源码仓库。Docusaurus 是有 Meta 开源的基于 React 开发的一个用于创建、维护和部署静态网站的网站生成工具。
24+
25+
## 开发
26+
27+
Docusaurus 实际上是一组 Node.js 包,因此,本文档实际上是一个 Node.js 应用。所以,首先需要确保正确安装了 Node.js 环境。
28+
29+
1. 使用 `yarn` 作为维护工具,默认的 Node.js 中并没有安装 `yarn`,因此,首先使用命令 `npm install -g yarn` 进行全局安装
30+
2. 首次进行开发需要先试用命令 `yarn install` 安装所需的依赖包
31+
3. 使用任意编辑器(推荐 VS Code)进行修改源码,编辑新文档(全部采用 Markdown 格式)
32+
4. 通过命令 `yarn start` 将会在本地启动的开发服务器,并自动打开浏览器窗口预览整个网站
33+
34+
## 部署
35+
36+
目前,AxVisor 的文档网站托管在了 GitHub Pages 上,仓库默认配置为通过 GitHub Action 进行部署,当把源码提交到仓库之后将自动触发 GitHub Action 进行部署。
37+
38+
> 也支持 `yarn deploy` 进行独立分支部署(需修改仓库配置后)
39+
> - Linux:
40+
> - 使用 SSH 方式:
41+
> ```
42+
> $ USE_SSH=true yarn deploy
43+
> ```
44+
>
45+
> - 不使用 SSH 方式:
46+
>
47+
> ```
48+
> $ GIT_USER=<Your GitHub username> yarn deploy
49+
> ```
50+
> - Windows PowerShell:
51+
> - 使用 SSH 方式:
52+
>
53+
> ```
54+
> $ cmd /C 'set "USE_SSH=true" && yarn deploy'
55+
> ```
56+
>
57+
> - 不使用 SSH 方式:
58+
>
59+
> ```
60+
> $ cmd /C 'set "GIT_USER=<Your GitHub username>" && yarn deploy'
61+
> ```
31.6 KB
Loading
202 KB
Loading
428 KB
Loading
38.7 KB
Loading
119 KB
Loading
153 KB
Loading

0 commit comments

Comments
 (0)