# igeekfan-docs

**Repository Path**: igeekfan/igeekfan-docs

## Basic Information

- **Project Name**: igeekfan-docs
- **Description**: 为开发者提供CMS、dotNET、FreeKit 相关文档
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://igeekfan.cn
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2020-02-28
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Freekit Docs

项目使用 vuepress，其可专注于文档构建

## install

```bash
npm install -g pnpm@next-7
```

```bash
pnpm install
```

## run

```bash
pnpm dev:vite
```

## build

```bash
pnpm build:vite
```

## upgrade package

```bash
pnpm i -D vuepress@next
```

## vuepress

该采用`vuepress-next`搭建，内置`md`，可以采用`vue`语法，vue 作者出品,UI 主题是 vuepress-theme-hope

- [https://vuepress-theme-hope.github.io/v2/](https://vuepress-theme-hope.github.io/v2/)

## 文档源码

- [https://github.com/luoyunchong/igeekfan-docs](https://github.com/luoyunchong/igeekfan-docs)
- [https://gitee.com/igeekfan/igeekfan-docs](https://gitee.com/igeekfan/igeekfan-docs)

## 部署地址

- [https://luoyunchong.github.io/igeekfan-docs/](https://luoyunchong.github.io/igeekfan-docs)
- [https://igeekfan.gitee.io/igeekfan-docs/](https://igeekfan.gitee.io/igeekfan-docs)
- [https://igeekfan.cn](https://igeekfan.cn)

## package.json 介绍

package.json 有这些命令

```bash
  "scripts": {
    "build:vite": "vuepress-vite build docs",
    "dev:vite": "vuepress-vite dev docs",
  },
```

所以我们可以 pnpm dev:vite 或 pnpm build:vite

## 自动发布 至 github pages

### 在 git bash 中执行

```bash
pnpm deploy
```

或

### powershell 中执行如下内容

```bash
.\deploy.ps1
```

## nginx 配置 

nginx 相关配置，/etc/nginx/conf.d/新建一个以.conf 为后缀的文件即可。

```bash
cd /etc/nginx/conf.d/
touch igeekfan-docs.conf
```

```conf
server {
    listen 80;
    server_name www.igeekfan.cn;
    root /var/www/html/igeekfan-docs;
    charset utf-8;
    location /  {
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   Host      $http_host;
    }
}
```

```bash
# 判断配置是否有效
nginx -t
# 加载配置项
nginx -s reload
```