diff --git a/.gitignore b/.gitignore
index 836852ea..6b4fd25c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -36,6 +36,8 @@ public/react/yarn.lock
/.idea/*
# Ignore react node_modules
+public/system/*
+public/react/*
/public/react/.cache
/public/react/node_modules/
/public/react/config/stats.json
@@ -81,4 +83,5 @@ docker/
educoder.sql
redis_data/
Dockerfile
-dump.rdb
\ No newline at end of file
+dump.rdb
+.tags*
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..42422e3b
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,53 @@
+# Changelog
+
+## [v3.0.2](https://forgeplus.trustie.net/projects/jasder/forgeplus/releases) - 2021-04-23
+
+* BUGFIXES
+ * Fix 解决部分用户头像不显示问题
+ * Fix 解决代码库模块中最左侧目录中的文件定位加载不准确的问题
+ * FIX 解决团队管理页面中项目链接错误问题
+ * Fix 解决markdown格式文件显示问题
+ * Fix 解决组织名下创建项目报错的问题
+ * Fix 解决组织名下的项目,创建issue报错的问题
+ * Fix 解决组织名下创建团队提示信息信息显示错误问题
+ * Fix 解决点击组织图片时,链接加载错误问题
+ * Fix 修复查询版本库信息安全漏洞
+ * Fix 解决修复团队成员操作访问组织仓库报403错误的问题
+ * Fix 解决owners团队成员对仓库添加成功失败的问题
+
+* ENHANCEMENTS
+ * ADD 自动生产用户头像功能
+ * ADD 创建组织支持中文名称
+ * ADD 创建团建支持中文名称
+ * ADD 组织名称统一显示中文名
+ * ADD 团队名称统一显示中文名
+ * ADD 用户头像悬浮时展示相关信息
+ * ADD 项目详情页添加实践课程链接入口
+ * ADD README文件页面添加添加目录导航功能
+ * UPDATE 升级改版底部footer信息
+ * UPDATE 升级用户操作版本库权限
+
+## [v3.0.1](https://forgeplus.trustie.net/projects/jasder/forgeplus/releases) - 2021-03-19
+
+* BUGFIXES
+ * Fix pull reqeust模块中用户头像显示问题
+ * Fix 解决issue模块中,指派用户的问题
+ * Fix 解决合并请求失败的后显示message信息不正确
+ * Fix 代码目录页面,readme文件提供单独的api
+
+* ENHANCEMENTS
+ * 重构项目详情页面
+
+## [v3.0.0](https://forgeplus.trustie.net/projects/jasder/forgeplus/releases) - 2020-12-29
+
+* BUGFIXES
+ * Fix pull reqeust的访问权限问题 (#14156) (#14171)
+ * Fix 部分页面访问403的问题
+ * Fix 合并请求失败的问题
+ * Fix 代码目录页面,文件夹和文件图片不显示的问题
+ * Fix Issue列表中按‘负责人’过滤筛选时,部分项目成员不在搜索范围没的问题
+ * Fix 项目更新时间不同步的问题, 添加了定时任务
+* ENHANCEMENTS
+ * 提升获取版本库目录代码查询速度 (#43296)
+ * tag 列表慢查询速度问题 (#43332)
+ * API builder 模版中 render partial builder的性能问题
diff --git a/Gemfile b/Gemfile
index abd202e9..713eb860 100644
--- a/Gemfile
+++ b/Gemfile
@@ -100,6 +100,7 @@ gem 'rails-i18n', '~> 5.1'
# job
gem 'sidekiq'
gem 'sinatra'
+gem "sidekiq-cron", "~> 1.1"
# batch insert
gem 'bulk_insert'
@@ -126,4 +127,4 @@ gem 'harmonious_dictionary', '~> 0.0.1'
gem 'parallel', '~> 1.19', '>= 1.19.1'
-gem 'alipay', '~> 0.15.1'
+gem 'letter_avatar'
diff --git a/Gemfile.lock b/Gemfile.lock
index 36896d5a..70b931fc 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -119,12 +119,17 @@ GEM
enumerize (2.3.1)
activesupport (>= 3.2)
erubi (1.9.0)
+ et-orbi (1.2.4)
+ tzinfo
execjs (2.7.0)
faraday (0.15.4)
multipart-post (>= 1.2, < 3)
ffi (1.12.2)
font-awesome-sass (4.7.0)
sass (>= 3.2)
+ fugit (1.4.1)
+ et-orbi (~> 1.1, >= 1.1.8)
+ raabro (~> 1.4)
globalid (0.4.2)
activesupport (>= 4.2.0)
grape-entity (0.7.1)
@@ -158,6 +163,7 @@ GEM
activerecord
kaminari-core (= 1.2.0)
kaminari-core (1.2.0)
+ letter_avatar (0.3.8)
listen (3.1.5)
rb-fsevent (~> 0.9, >= 0.9.4)
rb-inotify (~> 0.9, >= 0.9.7)
@@ -212,6 +218,7 @@ GEM
prettier (0.18.2)
public_suffix (4.0.3)
puma (3.12.2)
+ raabro (1.4.0)
rack (2.0.9)
rack-cors (1.1.1)
rack (>= 2.0.0)
@@ -354,6 +361,9 @@ GEM
rack (< 2.1.0)
rack-protection (>= 1.5.0)
redis (>= 3.3.5, < 5)
+ sidekiq-cron (1.2.0)
+ fugit (~> 1.1)
+ sidekiq (>= 4.2.1)
simple_form (5.0.2)
actionpack (>= 5.0)
activemodel (>= 5.0)
@@ -449,6 +459,7 @@ DEPENDENCIES
jbuilder (~> 2.5)
jquery-rails
kaminari (~> 1.1, >= 1.1.1)
+ letter_avatar
listen (>= 3.0.5, < 3.2)
mysql2 (>= 0.4.4, < 0.6.0)
oauth2
@@ -479,6 +490,7 @@ DEPENDENCIES
searchkick
selenium-webdriver
sidekiq
+ sidekiq-cron (~> 1.1)
simple_form
simple_xlsx_reader
sinatra
diff --git a/README.md b/README.md
index 8f5a897e..1bcd05cc 100644
--- a/README.md
+++ b/README.md
@@ -11,13 +11,32 @@ Trustie (确实)是一个以大众化协同开发、开放式资源共享、
## 部署
-### 1. 安装依赖包
+### Depends Versions
-```bash
-bundle install
+* Ruby 2.4.5
+
+* Rails ~> 5.2
+
+* MySql ~> 5.6
+
+* Redis 5+
+
+* imagemagick
+
+### Steps
+
+#### 1. 克隆稳定版本
+```
+git clone -b standalone https://git.trustie.net/jasder/forgeplus.git
```
-### 2. 配置初始化文件
+#### 2. 安装依赖包
+
+```bash
+cd forgeplus && bundle install
+```
+
+#### 3. 配置初始化文件
进入项目根目录执行一下命令:
```bash
@@ -27,12 +46,26 @@ touch config/redis.yml
touch config/elasticsearch.yml
```
-### 3. 配置gitea服务(可选)
+#### 4. 配置数据库
+数据库配置信息请查看/config/database.yml文件,
+项目默认采用mysql数据库, 如需更改,请自行修改配置信息,
+默认配置如下:
+
+```bash
+default: &default
+ adapter: mysql2
+ host: 127.0.0.1
+ encoding: utf8
+ username: root
+ password: 123456
+```
+
+#### 5. 配置gitea服务(可选)
**如需要部署自己的gitea平台,请参考gitea官方平台:https://docs.gitea.io/zh-cn/install-from-binary/**
-**因目前gitea平台api受限,暂时推荐从forge平台获取gitea部署文件进行部署:https://forgeplus.trustie.net/projects/jasder/gitea-binary
+**因目前gitea平台api受限,暂时推荐从forge平台获取gitea部署文件进行部署:https://forgeplus.trustie.net/projects/Trustie/gitea-binary**
-#### 配置gitea服务步骤
+**配置gitea服务步骤**
1. 部署gitea服务,并注册root账户
2. 修改forge平台的 config/configuration.yml中的gitea服务指向地址,如:
@@ -44,75 +77,95 @@ gitea:
base_url: '/api/v1'
```
-### 4. 安装redis环境
+#### 6. 安装redis环境
**请自行搜索各平台如何安装部署redis环境**
-
-### 5. 创建数据库
-
+#### 7. 安装imagemagick插件
+- Mac OS X
```bash
-rails db:create
+ brew install imagemagick ghostscript
```
-### 6. 导入数据表结构
+- Linux
+```bash
+sudo apt-get install -y imagemagick
+```
+
+#### 8. 创建数据库
+**开发环境为development, 生成环境为production**
+```bash
+rails db:create RAILS_ENV=development
+```
+
+#### 9. 导入数据表结构
```bash
bundle exec rake sync_table_structure:import_csv
```
-### 7. 执行migrate迁移文件
+#### 10. 执行migrate迁移文件
**开发环境为development, 生成环境为production**
```bash
rails db:migrate RAILS_ENV=development
```
-### 8. 启动redis(此处已mac系统为例)
+#### 11. clone前端代码
+**将前端代码克隆到public/react目录下,目录结构应该是: public/react/build**
+```bash
+git clone -b standalone https://git.trustie.net/jasder/build.git
+```
+
+#### 12. 启动redis(此处已mac系统为例)
```bash
redis-server&
```
-### 9. 启动sidekiq
+#### 13. 启动sidekiq
**开发环境为development, 生成环境为production**
```bash
bundle exec sidekiq -C config/sidekiq.yml -e production -d
```
-### 10. 启动rails服务
+#### 14. 启动rails服务
```bash
rails s
```
-### 11. 浏览器访问
+#### 15. 浏览器访问
在浏览器中输入如下地址访问:
```bash
http://localhost:3000/
```
+#### 16. 其他说明
+通过页面注册都第一个用户为平台管理员用户
## 页面展示
- 代码库
-
+
- 任务管理
-
+
- 任务查看
-
+
- 任务指派
-
+
- 里程碑
-
+
### API
-- [API](api_document.md)
+- [API文档](https://forgeplus.trustie.net/docs/api)
+- [API](showdoc.com.cn)
+ 账号:forgeplus@admin.com 密码:forge123
## 贡献代码
diff --git a/api_document.md b/api_document.md
index 50a45573..7620c42a 100644
--- a/api_document.md
+++ b/api_document.md
@@ -1,4 +1,3 @@
----
# API文档
@@ -19,7 +18,6 @@
### API接口
----
#### 用户注册(通过其他平台)
```
@@ -450,7 +448,7 @@ curl -X POST http://localhost:3000/api/repositories/1244/sync_mirror | jq
#### 项目详情
```
-GET /api/:namespace_id/:id
+GET /api/:owner/:repo
```
*示例*
```bash
@@ -460,8 +458,8 @@ curl -X GET http://localhost:3000/api/jasder/jasder_test | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|namespace_id |是|string |用户登录名 |
-|id |是|string |项目标识identifier |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
*返回参数说明:*
@@ -492,7 +490,7 @@ curl -X GET http://localhost:3000/api/jasder/jasder_test | jq
#### 项目详情(简版)
```
-GET /api/:namespace_id/:id/simple
+GET /api/:owner/:repo/simple
```
*示例*
```bash
@@ -502,7 +500,8 @@ curl -X GET http://localhost:3000/api/jasder/jasder_test/simple | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|id |是|int |项目id |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
*返回参数说明:*
@@ -862,7 +861,7 @@ curl -X POST http://localhost:3000/api/projects/3297/forks | jq
#### 获取代码目录列表
```
-POST /api/:namespace_id/:project_id/repository/entries
+POST /api/:owner/:repo/repository/entries
```
*示例*
```bash
@@ -874,7 +873,8 @@ http://localhost:3000//api/jasder/jasder_test/repository/entries | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|id |是|int |项目id |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
|ref |否|string |分支名称、tag名称或是提交记录id,默认为master分支 |
@@ -1344,7 +1344,7 @@ http://localhost:3000/api/projects/recommend | jq
#### 项目主页
```
-GET api/:namespace_id/:id/about
+GET api/:owner/:repo/about
```
*示例*
@@ -1357,8 +1357,8 @@ http://localhost:3000/api/:jason/forgeplus/about | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|namespace_id |是|string |用户登录名 |
-|id |是|string |项目标识identifier |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
*返回参数说明:*
@@ -1385,7 +1385,7 @@ http://localhost:3000/api/:jason/forgeplus/about | jq
#### 修改项目主页内容
```
-POST api/:namespace_id/:id/about
+POST api/:owner/:repo/about
```
*示例*
@@ -1393,15 +1393,15 @@ POST api/:namespace_id/:id/about
curl -X POST \
-d "content=内容" \
-d "attachment_ids=[1, 2, 2]" \
-http://localhost:3000/api/:jasder/forgeplus/about | jq
+http://localhost:3000/api/jasder/forgeplus/about | jq
```
*请求参数说明:*
|参数名|必选|类型|说明|
|-|-|-|-|
-|namespace_id |是|string |用户登录名 |
-|id |是|string |项目标识identifier |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
|content |是|string |内容信息 |
|attachment_ids |是|array |附件id |
@@ -1429,7 +1429,7 @@ http://localhost:3000/api/:jasder/forgeplus/about | jq
### 获取分支列表
```
-GET /api/:namespace_id/:id/branches
+GET /api/:owner/:repo/branches
```
*示例*
```bash
@@ -1439,7 +1439,8 @@ curl -X GET http://localhost:3000/api/jasder/jasder_test/branches | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|id |是|id |项目id |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
*返回参数说明:*
@@ -1596,7 +1597,7 @@ http://localhost:3000/api/repositories/5836/tags.json | jq
## 仓库详情
```
-GET /api/:namespace_id/:project_id/repository
+GET /api/:owner/:repo/repository
```
*示例*
```bash
@@ -1607,8 +1608,8 @@ http://192.168.2.230:3000/api/jasder/forgeplus/repository | jq
|参数名|必选|类型|说明|
|-|-|-|-|
-|namespace_id |是|string |用户登录名 |
-|project_id |是|string |项目标识identifier |
+|owner |是|string |用户登录名 |
+|repo |是|string |项目标识identifier |
*返回参数说明:*
@@ -3062,6 +3063,78 @@ http://localhost:3000/api/trustie/truesite/protected_branches/master.json | jq
```
---
+#### 获取仓库README文件
+```
+GET api/:owner/:repo/readme
+```
+*示例*
+```bash
+curl -X GET http://localhost:3000/api/trusite/trusite/readme | jq
+```
+
+*请求参数说明:*
+
+|参数名|类型|说明|
+|-|-|-|
+|owner |是|string |项目拥有者登录名 |
+|repo |否|boolean |仓库名称 |
+|ref |否|string |分支、tag或commit。默认: 仓库的默认分支(通常是master)|
+
+
+*返回参数说明:*
+
+|参数名|类型|说明|
+|-|-|-|
+|name |string|文件名称|
+|path |string|文件相对路径|
+|type |string|文件类型, file:文件|
+|size |int|文件大小 单位KB|
+|content |string|文件内容,base64加密|
+
+返回值
+```json
+{
+ "type": "file",
+ "encoding": "base64",
+ "size": 13544,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "Q2hpbmVzZSAmbmJzcDsgfCAmbmJzcDsgW0VuZ7i9yZWFkbWUvaW5kZXgucG5"
+}
+```
+---
+
+#### 获库仓库的语言百分占比
+```
+GET api/:owner/:repo/languages
+```
+*示例*
+```bash
+curl -X GET http://localhost:3000/api/jasder/trusite/languages | jq
+```
+
+*请求参数说明:*
+
+|参数名|类型|说明|
+|-|-|-|
+|owner |是|string |项目拥有者登录名 |
+|repo |否|boolean |仓库名称 |
+
+
+返回值
+```json
+{
+ "JavaScript": "90.2%",
+ "CSS": "6.1%",
+ "Java": "2.9%",
+ "HTML": "0.8%"
+}
+```
+---
+
+
+
+
### DevOps相关api
---
@@ -3286,9 +3359,10 @@ http://localhost:3000/api/jasder/forge/get_trustie_pipeline.json | jq
PUT /api/:owner/:repo/update_trustie_pipeline
```
*示例*
+
```bash
curl -X GET \
-http://localhost:3000/api/jasder/forge/update_trustie_pipeline.json | jq
+http://localhost:3000/api/jasder/forge/update_trustie_pipeline.json?pipeline_id=1 | jq
```
*请求参数说明:*
@@ -3426,13 +3500,13 @@ curl -X GET http://localhost:3000/api/ci/languages/114.json | jq
#### 获取构建列表
```
-GET /api/:owner/:repo/builds
+GET /api/:owner/:repo/builds??branch={branch}
```
*示例*
```bash
curl -X GET \
-http://localhost:3000/api/Jason/forge/builds | jq
+http://localhost:3000/api/Jason/forge/builds?branch=develop | jq
```
*请求参数说明:*
@@ -3444,6 +3518,7 @@ http://localhost:3000/api/Jason/forge/builds | jq
|page |否|string |页数,第几页 |
|limit |否|string |每页多少条数据,默认20条 |
|search |是|string |构建状态条件过滤; 值说明:pending: 准备中,failure: 构建失败,running: 运行中,error:构建失败(.trustie-pipeline.yml文件错误),success: 构建成功,killed: 撤销构建 |
+|branch |是|string |分支 |
*返回参数说明:*
@@ -3865,6 +3940,48 @@ http://localhost:3000/api/users/ci/cloud_account | jq
}
}
```
+------
+
+#### 绑定CI服务器-Trustie提供服务器
+
+```
+POST /api/users/ci/cloud_account/trustie_bind
+```
+
+*示例*
+
+```bash
+curl -X POST \
+-d "account=xx" \
+https://localhost:3000/api/users/ci/cloud_account/trustie_bind.json | jq
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------- | ---- | ------ | ---------- |
+| account | 是 | string | 登录用户名 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------------ | ------ | --------------------------------------- |
+| step | int | 0: 未绑定;1: 未认证(已绑定),2: 已认证 |
+| ip | string | ci服务器ip |
+| redirect_url | string | 认证地址 |
+
+返回值
+
+```json
+{
+ "step": 0,
+ "cloud_account": {
+ "ip": "xxx.xxx.xxx.x",
+ "redirect_url": "http://localhost:3000/login"
+ }
+}
+```
+
---
#### 绑定CI服务器
@@ -3907,10 +4024,939 @@ https://localhost:3000/api/users/ci/cloud_account/bind.json | jq
}
}
```
+------
+
+#### 流水线查询
+
+```
+GET /api/ci/pipelines/list?identifier={identifier}
+```
+
+*示例*
+
+```bash
+curl -X GET \
+http://localhost:3000/api/ci/pipelines/list.json?identifier="xxx" | jq
+```
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ----------------- | ------ | ------------ |
+| id | int | 流水线id |
+| pipeline_name | string | 流水线名称 |
+| file_name | string | 流水线文件名 |
+| branch | string | 触发分支 |
+| event | string | 触发事件 |
+| last_build_time | string | 上次构建时间 |
+| last_build_status | string | 上次构建状态 |
+
+返回值
+
+```json
+{
+ "pipelines": [
+ {
+ "id": 65,
+ "pipeline_name": "流水线 2021-01-25",
+ "file_name": ".drone.yml",
+ "branch": "develop",
+ "event": "push",
+ "sha": "19fb5eb28603a4a1ec799ad44c1a3ef69d5c2cd0",
+ "identifier": "trustieTest",
+ "last_build_status": "success",
+ "last_build_time": "2021-01-25 15:54:22"
+ }
+ ]
+}
+```
+
---
+#### 流水线新增
-### 解除CI服务器绑定
+```
+POST /api/ci/pipelines
+```
+
+*示例*
+
+```bash
+curl --location --request POST 'http://localhost:3000/api/ci/pipelines' \
+--header 'Content-Type: application/json' \
+--data-raw ' {
+ "pipeline_name": "流水线 2021-01-12",
+ "file_name": ".trustie.pipeline.yaml",
+ "repo": "xxx",
+ "owner": "xxx",
+ "branch": "master",
+ "event": "push"
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------------- | ---- | ------ | ---------------------------------------------- |
+| pipeline_name | 是 | string | 流水线名称 |
+| file_name | 是 | string | 文件名称(默认初始值:.trustie.pipeline.yaml) |
+| repo | 是 | string | 项目identifier |
+| owner | 是 | string | 项目的owner |
+| branch | 是 | string | 分支名称, branch必须存在一个 |
+| event | 是 | string | 触发事件,可多选,多个逗号隔开 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | -------------- |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+| id | int | 新增流水线的id |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success",
+ "id": 18
+}
+```
+
+------
+
+#### 流水线更新
+
+修改流水线名称时调用。
+
+```
+PUT /api/ci/pipelines/{id}
+```
+
+*示例*
+
+```bash
+curl --location --request PUT 'http://localhost:3000/api/ci/pipelines/3' \
+--header 'Content-Type: application/json' \
+--data-raw ' {
+ "pipeline_name": "2020-01-11 流水线"
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------------- | ---- | ------ | ---------- |
+| id | 是 | id | 流水线id |
+| pipeline_name | 是 | string | 流水线名称 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线删除
+
+```
+DELETE /api/ci/pipelines/{id}
+```
+
+*示例*
+
+```bash
+curl -X DELETE \
+https://localhost:3000/api/ci/pipelines/1 | jq
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ---- | -------- |
+| id | 是 | int | 流水线id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线的阶段查询
+
+```
+GET /api/ci/pipelines/{id}/stages
+```
+
+*示例*
+
+```bash
+curl --location --request GET 'http://localhost:3000/api/ci/pipelines/19/stages.json'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ---- | -------- |
+| id | 是 | int | 流水线id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | -------- |
+| stages | arr | 阶段数组 |
+| stage_name | string | 阶段名称 |
+| stage_type | string | 阶段类型 |
+| pipeline_id | int | 流水线id |
+| show_index | int | 排序 |
+
+返回值
+
+```json
+{
+ "stages": [
+ {
+ "id": 37,
+ "stage_name": "初始化",
+ "stage_type": "init",
+ "pipeline_id": 19,
+ "show_index": 1,
+ "created_at": "2021-01-12T15:18:00.000+08:00",
+ "updated_at": "2021-01-12T15:18:00.000+08:00"
+ },
+ {
+ "id": 38,
+ "stage_name": "编译构建",
+ "stage_type": "build",
+ "pipeline_id": 19,
+ "show_index": 2,
+ "created_at": "2021-01-12T15:18:00.000+08:00",
+ "updated_at": "2021-01-12T15:18:00.000+08:00"
+ }
+ ]
+}
+```
+
+------
+
+#### 确认阶段流水线完整内容查询
+
+```
+GET /api/ci/pipelines/{id}/content?owner={owner}&repo={repo}
+```
+
+*示例*
+
+```bash
+curl -X GET \
+http://localhost:3000/api/ci/pipelines/1/content.json?owner=xx&repo=xx | jq
+```
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ---------------- |
+| content | String | 流水线内容 |
+| sync | int | 同步状态 |
+| owner | string | 用户登录名 |
+| repo | string | 项目的identifier |
+
+返回值
+
+```json
+{
+ "content": "#pipeline \nkind: pipeline\r\nname: maven项目-镜像仓库\r\n\r\nplatform:\r\n os: linux\r\n arch: arm64\nsteps:\n- name: Maven编译\r\n image: arm64v8/maven\r\n commands:\r\n - mvn install\n- name: 编译镜像-推送到仓库\r\n image: plugins/docker\r\n settings:\r\n username: moshenglv\r\n password: RL9UB5P7Jtzukka\r\n repo: docker.io/moshenglv/demo\r\n tags: latest\n",
+ "sync": 1,
+ "sha":"xxxxx"
+}
+```
+
+------
+
+#### 流水线阶段新增
+
+```
+POST /api/ci/pipelines/{id}/create_stage
+```
+
+*示例*
+
+```bash
+curl --location --request POST 'http://localhost:3000/api/ci/pipelines/19/create_stage.json' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+ "stage_name": "新阶段2",
+ "show_index": 2
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------- | ---- | ------ | -------- |
+| id | 是 | int | 流水线id |
+| show_index | 是 | int | 阶段排序 |
+| stage_name | 是 | string | 阶段名称 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线阶段更新
+
+```
+PUT /api/ci/pipelines/{id}/{stage_id}/update_stage
+```
+
+*示例*
+
+```bash
+curl --location --request PUT 'http://localhost:3000/api/ci/pipelines/1/5/update_stage.json' \
+--header 'Content-Type: application/json' \
+--data-raw ' {
+ "stage_name": "新阶段-更新"
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------- | ---- | ------ | -------------------------------- |
+| id | 是 | int | 流水线id |
+| stage_name | 是 | string | 阶段名称(默认为 阶段名-模板名) |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线阶段删除
+
+```
+DELETE /api/ci/pipelines/{id}/{stage_id}/delete_stage?show_index={index}
+```
+
+*示例*
+
+```bash
+curl --location --request DELETE 'http://localhost:3000/api/ci/pipelines/19/42/delete_stage.json?show_index=2' \
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------- | ---- | ---- | ---------------------- |
+| id | 是 | int | 流水线id |
+| stage_id | 是 | int | 阶段id |
+| show_index | 是 | int | 被删除阶段的show_index |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线阶段步骤查询
+
+```
+GET /api/ci/pipelines/{id}/{stage_id}/steps.json
+```
+
+*示例*
+
+```bash
+curl -X GET \
+http://localhost:3000/api/ci/pipelines/1/2/steps.json | jq
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| -------- | ---- | ---- | -------- |
+| id | 是 | int | 流水线id |
+| stage_id | 是 | int | 阶段id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ---------- | ------ | ------------------ |
+| id | int | 步骤id |
+| step_name | string | 步骤名称 |
+| stage_id | int | 所属阶段id |
+| show_index | int | 显示顺序 |
+| content | String | 步骤内容 |
+| template | Object | 步骤对应的模板对象 |
+
+返回值
+
+```json
+{
+ "steps": [
+ {
+ "id": 1,
+ "step_name": "编译构建-maven",
+ "stage_id": 2,
+ "show_index": 0,
+ "content": "- name: Maven编译\r\n image: arm64v8/maven\r\n",
+ "created_at": "2021-01-11T09:57:17.000+08:00",
+ "updated_at": "2021-01-11T09:57:17.000+08:00",
+ "template": {
+ "id": 3,
+ "template_name": "maven",
+ "stage_type": "build",
+ "category": "java",
+ "content": "- name: maven\r\n image: maven:3-jdk-10\r\n",
+ "created_at": "2021-01-11T17:28:34.000+08:00",
+ "updated_at": "2021-01-11T17:28:36.000+08:00"
+ }
+ }
+ ]
+}
+```
+
+------
+
+#### 流水线阶段步骤新增/更新
+
+```
+POST /api/ci/pipelines/{id}/{stage_id}/stage_step
+```
+
+*示例*
+
+```bash
+curl --location --request POST 'http://localhost:3000/api/ci/pipelines/1/2/stage_step.json' \
+--header 'Content-Type: application/json' \
+--data-raw ' {"steps":[{
+ "id":7,
+ "step_name": "编译构建11-gradle",
+ "show_index": 1,
+ "content": "xxxxxxxxxxx",
+ "template_id":2
+}
+]
+ }'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------------- | ---- | ------ | -------------------------------- |
+| steps | 是 | arr | 需要更新step数组 |
+| id | 是 | int | 流水线id |
+| stage_id | 是 | int | 阶段id |
+| id(数组中的id) | 否 | int | 步骤id(存在则更新,不存在新增) |
+| step_name | 是 | string | 阶段名称(阶段名-模板名) |
+| content | 是 | string | 步骤内容 |
+| template_id | 是 | int | 模板id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 流水线阶段步骤删除
+
+```
+DELETE /api/ci/pipelines/{id}/{stage_id}/{step_id}/delete_step
+```
+
+*示例*
+
+```bash
+curl -X DELETE \
+https://localhost:3000/api/ci/pipelines/1/6/2/delete_stage.json | jq
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| -------- | ---- | ---- | -------- |
+| id | 是 | int | 流水线id |
+| stage_id | 是 | int | 阶段id |
+| step_id | 是 | int | 步骤id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 阶段模板查询
+
+```
+GET /api/ci/templates/templates_by_stage?stage_type={stage_type}
+```
+
+*示例*
+
+```bash
+curl -X GET \
+http://localhost:3000/api/ci/templates/templates_by_stage.json?stage_type=build | jq
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------- | ---- | ------ | ------------------------------------- |
+| stage_type | 是 | string | 阶段类型:init/build/deploy/customize |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------------- | ------ | ---------------- |
+| category | string | 分类名称 |
+| templates | arr | 分类下的模板列表 |
+| id | int | 模板id |
+| template_name | string | 模板名称 |
+| content | String | 模板内容 |
+
+返回值
+
+```json
+[
+ {
+ "category": "java",
+ "templates": [
+ {
+ "id": 3,
+ "template_name": "maven",
+ "stage_type": "build",
+ "category": "java",
+ "content": "#maven",
+ "created_at": "2021-01-11T17:28:34.000+08:00",
+ "updated_at": "2021-01-11T17:28:36.000+08:00"
+ },
+ {
+ "id": 4,
+ "template_name": "gradle",
+ "stage_type": "build",
+ "category": "java",
+ "content": "#gradle",
+ "created_at": "2021-01-11T17:28:34.000+08:00",
+ "updated_at": "2021-01-11T17:28:36.000+08:00"
+ }
+ ]
+ },
+ {
+ "category": "c++",
+ "templates": [
+ {
+ "id": 5,
+ "template_name": "make",
+ "stage_type": "build",
+ "category": "c++",
+ "content": "#make",
+ "created_at": "2021-01-11T17:29:17.000+08:00",
+ "updated_at": "2021-01-11T17:29:18.000+08:00"
+ }
+ ]
+ }
+]
+```
+
+------
+
+#### 模板列表查询
+
+```
+GET /api/ci/templates/list.json?limit=10&page=1&name=&stage_type=customize
+```
+
+*示例*
+
+```bash
+curl --location --request GET 'http://localhost:3000/api/ci/templates/list.json?limit=10&page=1&name=&stage_type=customize'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ---------- | ---- | ------ | ----------------------------------------- |
+| stage_type | 是 | string | 阶段类型:init/build/deploy/customize/all |
+| limit | 是 | int | 每页条数 |
+| page | 是 | int | 页码 |
+| name | 否 | string | 模糊查询参数 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------------- | ------ | ---------------- |
+| category | string | 分类名称 |
+| templates | arr | 分类下的模板列表 |
+| id | int | 模板id |
+| template_name | string | 模板名称 |
+| content | String | 模板内容 |
+
+返回值
+
+```json
+{
+ "total_count": 1,
+ "templates": [
+ {
+ "id": 19,
+ "template_name": "工具1",
+ "stage_type": "customize",
+ "category": "其他",
+ "content": "xxxxxxxxxxxxxxxxxxxxxx",
+ "login": "victor",
+ "created_at": "2021-01-26T15:51:30.000+08:00",
+ "updated_at": "2021-01-26T15:51:30.000+08:00"
+ }
+ ]
+}
+```
+
+
+
+------
+
+#### 模板详情查询
+
+```
+GET /api/ci/templates/id
+```
+
+*示例*
+
+```bash
+curl --location --request GET 'http://localhost:3000/api/ci/templates/17.json'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ---- | ------ |
+| id | 是 | int | 模板id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------------- | ------ | -------- |
+| category | string | 分类名称 |
+| id | int | 模板id |
+| template_name | string | 模板名称 |
+| content | String | 模板内容 |
+
+返回值
+
+```json
+{
+ "id": 17,
+ "template_name": "win/x86_64",
+ "stage_type": "init",
+ "category": "初始化",
+ "content": "kind: pipeline\r\ntype: docker\r\nname: default\r\nplatform:\r\n os: linux\r\n arch: amd64",
+ "login": "victor",
+ "created_at": "2021-01-26T15:29:27.000+08:00",
+ "updated_at": "2021-01-26T15:29:27.000+08:00"
+}
+```
+
+
+
+------
+
+#### 模板新增/更新
+
+```
+POST /api/ci/templates
+```
+
+*示例*
+
+```bash
+curl --location --request POST 'http://localhost:3000/api/ci/templates' \
+--data-raw ' {
+ "template_name": "java++",
+ "stage_type": "build",
+ "category": "java",
+ "content": "xxxxxxxxxxxxxxxxxxxxxx",
+ "id": 21
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------------- | ---- | ------ | ---------------- |
+| template_name | 是 | string | 模板名称 |
+| stage_type | 是 | string | 阶段类型 |
+| category | 是 | string | 分类 |
+| content | 是 | string | 模板内容 |
+| id | 否 | int | 模板id,更新时传 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 模板删除
+
+```
+DELETE /api/ci/templates/{id}
+```
+
+*示例*
+
+```bash
+curl --location --request DELETE 'http://localhost:3000/api/ci/templates/10'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ---- | -------- |
+| id | 是 | int | 流水线id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 参数列表查询
+
+```
+GET /api/ci/secrets/secrets?owner={owner}&repo={repo}
+```
+
+*示例*
+
+```bash
+curl --location --request GET 'http://localhost:3000/api/ci/secrets?owner=test&repo=test'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ------ | ---------- |
+| owner | 是 | string | 仓库所有人 |
+| repo | 是 | string | 仓库名 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------ | ------ | ------ |
+| name | string | 参数名 |
+| data | string | 参数值 |
+| repo | string | 仓库 |
+
+返回值
+
+```json
+ [
+ {
+ "id": 1,
+ "name": "test",
+ "data": "test",
+ "repo": "test"
+ }
+]
+
+```
+
+------
+
+#### 参数新增/更新
+
+```
+POST /api/ci/secrets?owner={owner}&repo={repo}
+```
+
+*示例*
+
+```bash
+curl --location --request POST 'http://localhost:3000/api/ci/secrets?owner=test&repo=test' \
+--data-raw ' {
+ "name": "ip",
+ "data": "1.1.1.1",
+ "id": 21
+}'
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ------ | ------------ |
+| owner | 是 | string | 仓库拥有者 |
+| repo | 是 | string | 仓库名 |
+| name | 是 | string | 参数名 |
+| data | 是 | string | 参数值 |
+| id | 否 | int | id,更新时传 |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+#### 参数删除
+
+```
+DELETE /api/ci/secrets/{id}?name={name}&owner={owner}&repo={repo}
+```
+
+*示例*
+
+```bash
+curl --location --request DELETE 'http://localhost:3000/api/ci/secrets/1?name=p1&owner=victor&repo=trustieTest' \
+```
+
+*请求参数说明:*
+
+| 参数名 | 必选 | 类型 | 说明 |
+| ------ | ---- | ------ | ------ |
+| name | 是 | string | 参数名 |
+| id | 是 | int | 参数id |
+
+*返回参数说明:*
+
+| 参数名 | 类型 | 说明 |
+| ------- | ------ | ------------ |
+| status | int | 状态码 0成功 |
+| message | string | 返回消息 |
+
+返回值
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+------
+
+
+
+
+#### 解除CI服务器绑定
```
DELETE /api/users/ci/cloud_account/unbind
```
diff --git a/app/controllers/accounts_controller.rb b/app/controllers/accounts_controller.rb
index f9f7f76c..8e82a814 100644
--- a/app/controllers/accounts_controller.rb
+++ b/app/controllers/accounts_controller.rb
@@ -151,18 +151,8 @@ class AccountsController < ApplicationController
if interactor.success?
gitea_user = interactor.result
result = Gitea::User::GenerateTokenService.new(login, params[:password]).call
- if !result['sha1'].nil?''
- @user.gitea_token = result['sha1']
- else
- @user.gitea_token = JSON.parse(result.body)['sha1'] # 出现了返回结果为body字段json格式的情况
- end
-
- if !gitea_user['id'].nil?
- @user.gitea_uid = gitea_user['id']
- else
- @user.gitea_uid = JSON.parse(gitea_user.body)['id']
- end
-
+ @user.gitea_token = result['sha1']
+ @user.gitea_uid = gitea_user[:body]['id']
if @user.save!
UserExtension.create!(user_id: @user.id)
successful_authentication(@user)
diff --git a/app/controllers/application_controller.rb b/app/controllers/application_controller.rb
index 97c5f0eb..b8172b24 100644
--- a/app/controllers/application_controller.rb
+++ b/app/controllers/application_controller.rb
@@ -28,7 +28,7 @@ class ApplicationController < ActionController::Base
DCODES = %W(2 3 4 5 6 7 8 9 a b c f e f g h i j k l m n o p q r s t u v w x y z)
OPENKEY = "79e33abd4b6588941ab7622aed1e67e8"
- helper_method :current_user
+ helper_method :current_user, :base_url
# 所有请求必须合法签名
def check_sign
@@ -329,7 +329,6 @@ class ApplicationController < ActionController::Base
User.current = user
end
end
-
# if !User.current.logged? && Rails.env.development?
# User.current = User.find 1
# end
@@ -680,6 +679,14 @@ class ApplicationController < ActionController::Base
relation.page(page).per(limit)
end
+ def kaminari_array_paginate(relation)
+ limit = params[:limit] || params[:per_page]
+ limit = (limit.to_i.zero? || limit.to_i > 15) ? 15 : limit.to_i
+ page = params[:page].to_i.zero? ? 1 : params[:page].to_i
+
+ Kaminari.paginate_array(relation).page(page).per(limit)
+ end
+
def strf_time(time)
time.blank? ? '' : time.strftime("%Y-%m-%d %H:%M:%S")
end
@@ -762,6 +769,11 @@ class ApplicationController < ActionController::Base
@repository ||= load_project&.repository
end
+ def base_url
+ request.base_url
+ end
+
+
private
def object_not_found
uid_logger("Missing template or cant't find record, responding with 404")
diff --git a/app/controllers/attachments_controller.rb b/app/controllers/attachments_controller.rb
index 16842fb5..14e53b3e 100644
--- a/app/controllers/attachments_controller.rb
+++ b/app/controllers/attachments_controller.rb
@@ -28,8 +28,8 @@ class AttachmentsController < ApplicationController
update_downloads(@file)
end
-
- def get_file
+
+ def get_file
normal_status(-1, "参数缺失") if params[:download_url].blank?
url = URI.encode(params[:download_url].to_s.gsub("http:", "https:"))
response = Faraday.get(url)
@@ -45,7 +45,7 @@ class AttachmentsController < ApplicationController
uid_logger("#########################file_params####{params["#{params[:file_param_name]}"]}")
raise "未上传文件" unless upload_file
- folder = edu_setting('attachment_folder')
+ folder = file_storage_directory
raise "存储目录未定义" unless folder.present?
month_folder = current_month_folder
@@ -108,7 +108,7 @@ class AttachmentsController < ApplicationController
end
# 附件为视频时,点击播放
- def preview_attachment
+ def preview_attachment
attachment = Attachment.find_by(id: params[:id])
dir_path = "#{Rails.root}/public/preview"
Dir.mkdir(dir_path) unless Dir.exist?(dir_path)
@@ -118,10 +118,10 @@ class AttachmentsController < ApplicationController
else
normal_status(-1, "出现错误,请稍后重试")
end
- else
+ else
if system("rm -rf #{dir_path}/#{attachment.disk_filename}")
normal_status(1, "操作成功")
- else
+ else
normal_status(-1, "出现错误,请稍后重试")
end
end
diff --git a/app/controllers/ci/base_controller.rb b/app/controllers/ci/base_controller.rb
index 6f18db04..1649721c 100644
--- a/app/controllers/ci/base_controller.rb
+++ b/app/controllers/ci/base_controller.rb
@@ -2,8 +2,7 @@ class Ci::BaseController < ApplicationController
include Ci::DbConnectable
before_action :require_login
- before_action :connect_to_ci_database, if: -> { current_user && !current_user.is_a?(AnonymousUser) && !current_user.devops_uninit? }
- before_action :connect_to_ci_database, only: :load_repo
+ before_action :connect_to_ci_db
def load_repo
namespace = params[:owner]
@@ -12,6 +11,15 @@ class Ci::BaseController < ApplicationController
@ci_user, @repo = Ci::Repo.find_with_namespace(namespace, id)
end
+ def load_all_repo
+ namespace = current_user.login
+ @repos = Ci::Repo.find_all_with_namespace(namespace)
+ end
+
+ def load_repo_by_repo_slug(slug)
+ @repo_slug = Ci::Repo.load_repo_by_repo_slug(slug)
+ end
+
private
def authorize_access_project!
unless @project.manager?(current_user)
@@ -45,4 +53,24 @@ class Ci::BaseController < ApplicationController
@ci_user.blank? ? raise("未找到相关的记录") : @ci_user
end
+ def connect_to_ci_db(options={})
+ current = current_user
+ owner = params[:owner]
+ if owner
+ current = User.find_by(login: owner)
+ end
+
+ if !(current && !current.is_a?(AnonymousUser) && !current.devops_uninit?)
+ return
+ end
+
+ if current.ci_cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_TRUSTIE
+ connect_to_trustie_ci_database(options)
+ else
+ options = options.merge(db_name: current.login)
+ connect_to_ci_database(options)
+ end
+
+ end
+
end
diff --git a/app/controllers/ci/builds_controller.rb b/app/controllers/ci/builds_controller.rb
index 4900a890..e6caf893 100644
--- a/app/controllers/ci/builds_controller.rb
+++ b/app/controllers/ci/builds_controller.rb
@@ -8,7 +8,6 @@ class Ci::BuildsController < Ci::BaseController
def index
@user = current_user
- scope = @repo.builds
scope = Ci::Builds::ListQuery.call(@repo, params)
diff --git a/app/controllers/ci/cloud_accounts_controller.rb b/app/controllers/ci/cloud_accounts_controller.rb
index a1429078..7d829dbd 100644
--- a/app/controllers/ci/cloud_accounts_controller.rb
+++ b/app/controllers/ci/cloud_accounts_controller.rb
@@ -1,10 +1,11 @@
class Ci::CloudAccountsController < Ci::BaseController
include Ci::CloudAccountManageable
- skip_before_action :connect_to_ci_database, only: %i[create bind]
+ skip_before_action :connect_to_ci_db, only: %i[create bind trustie_bind]
before_action :load_project, only: %i[create activate]
before_action :authorize_owner!, only: %i[create activate]
before_action :load_repo, only: %i[activate]
+ before_action :load_all_repo, only: %i[unbind]
before_action :find_cloud_account, only: %i[show oauth_grant]
before_action :validate_params!, only: %i[create bind]
before_action only: %i[create bind] do
@@ -37,7 +38,7 @@ class Ci::CloudAccountsController < Ci::BaseController
ActiveRecord::Base.transaction do
if @repo
return render_error('该项目已经激活') if @repo.repo_active?
- @repo.activate!(@ci_user.user_id)
+ @repo.activate!(@project)
else
@repo = Ci::Repo.auto_create!(@ci_user, @project)
@user.update_column(:user_syncing, false)
@@ -73,8 +74,35 @@ class Ci::CloudAccountsController < Ci::BaseController
render_error(ex.message)
end
+ def trustie_bind
+ account = params[:account].to_s
+ return render_error("account不能为空.") if account.blank?
+
+ flag, msg = check_trustie_bind_cloud_account!
+ return render_error(msg) if flag === true
+
+ ActiveRecord::Base.transaction do
+ @cloud_account = trustie_bind_account!
+ if @cloud_account.blank?
+ render_error('激活失败, 请检查你的云服务器信息是否正确.')
+ raise ActiveRecord::Rollback
+ else
+ current_user.set_drone_step!(User::DEVOPS_UNVERIFIED)
+ end
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
def unbind
ActiveRecord::Base.transaction do
+ if current_user.ci_cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_TRUSTIE
+ if @repos
+ @repos.each do |repo|
+ repo.deactivate!
+ end
+ end
+ end
unbind_account!
render_ok
end
diff --git a/app/controllers/ci/pipelines_controller.rb b/app/controllers/ci/pipelines_controller.rb
new file mode 100644
index 00000000..ea8b25f7
--- /dev/null
+++ b/app/controllers/ci/pipelines_controller.rb
@@ -0,0 +1,294 @@
+class Ci::PipelinesController < Ci::BaseController
+
+ before_action :require_login, only: %i[list create content]
+ skip_before_action :connect_to_ci_db, except: %i[list create destroy content]
+ before_action :load_project, only: %i[create content]
+ before_action :load_repo, only: %i[create content]
+
+ # ======流水线相关接口========== #
+ def list
+ @result = Array.new
+ list = Ci::Pipeline.where('identifier=? and owner=?', params[:identifier], params[:owner])
+ # 查询build状态
+ list.collect do |pipeline|
+ pipeline.last_build_time = nil
+ repo = load_repo_by_repo_slug("#{pipeline.owner}/#{pipeline.identifier}")
+ if repo
+ build = repo.builds.order("build_created desc").find_by(build_target: pipeline.branch)
+ if build
+ pipeline.pipeline_status = build.build_status
+ pipeline.last_build_time = Time.at(build.build_created)
+ end
+ end
+ @result.push(pipeline)
+ end
+ @total_count = @result.size
+ @pipelines = paginate @result
+ end
+
+ def create
+ ActiveRecord::Base.transaction do
+ size = Ci::Pipeline.where('branch=? and identifier=? and owner=?', params[:branch], params[:repo], params[:owner]).size
+ if size > 0
+ render_error("#{params[:branch]}分支已经存在流水线!")
+ return
+ end
+ pipeline = Ci::Pipeline.new(pipeline_name: params[:pipeline_name], file_name: params[:file_name],owner: params[:owner],
+ login: current_user.login, identifier: params[:repo], branch: params[:branch], event: params[:event])
+ pipeline.save!
+
+ # 默认创建四个初始阶段
+ init_stages = Ci::PipelineStage::INIT_STAGES
+ index = 1
+ init_stages.each do |type, name|
+ pipeline.pipeline_stages.build(
+ stage_name: name,
+ stage_type: type,
+ show_index: index
+ ).save!
+ index += 1
+ end
+ create_pipeline_file(pipeline)
+ create_ci_repo(pipeline)
+ render_ok({id: pipeline.id})
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ # 在代码库创建文件
+ def create_pipeline_file(pipeline)
+ sha = get_pipeline_file_sha(pipeline.file_name, pipeline.branch)
+ if sha
+ logger.info "#{pipeline.file_name}已存在"
+ else
+ interactor = Gitea::CreateFileInteractor.call(current_user.gitea_token, @owner.login, content_params)
+ if interactor.success?
+ logger.info "#{pipeline.file_name}创建成功"
+ end
+ end
+ end
+
+ # 在drone数据库repo表新增一条repo记录
+ def create_ci_repo(pipeline)
+ if pipeline.branch != 'master'
+ create_params = {
+ repo_user_id: @ci_user.user_id,
+ repo_namespace: @project.owner.login,
+ repo_name: @project.identifier,
+ repo_slug: "#{@project.owner.login}/#{@project.identifier}-" + pipeline.id.to_s,
+ repo_clone_url: @project.repository.url,
+ repo_branch: pipeline.branch,
+ repo_config: pipeline.file_name
+ }
+ repo = Ci::Repo.create_repo(create_params)
+ repo
+ end
+ nil
+ end
+
+ def get_pipeline_file_sha(file_name, branch)
+ file_path_uri = URI.parse(file_name)
+ interactor = Repositories::EntriesInteractor.call(@project.owner, @project.identifier, file_path_uri, ref: branch || 'master')
+ if interactor.success?
+ file = interactor.result
+ file['sha']
+ end
+ end
+
+ def content_params
+ {
+ filepath: params[:file_name],
+ branch: params[:branch],
+ new_branch: params[:new_branch],
+ content: "#pipeline \n",
+ message: 'create pipeline',
+ committer: {
+ email: current_user.mail,
+ name: current_user.login
+ },
+ identifier: params[:repo]
+ }
+ end
+
+ def update
+ pipeline = Ci::Pipeline.find(params[:id])
+ if pipeline
+ pipeline.update!(pipeline_name: params[:pipeline_name],branch: params[:branch], event: params[:event])
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def destroy
+ pipeline = Ci::Pipeline.find(params[:id])
+ if pipeline
+ repo = load_repo_by_repo_slug("#{pipeline.login}/#{pipeline.identifier}-" + pipeline.id.to_s)
+ if repo
+ repo.destroy!
+ end
+ pipeline.destroy!
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def content
+ @yaml = "\n"
+ pipeline = Ci::Pipeline.find(params[:id])
+ stages = pipeline.pipeline_stages
+ if stages && !stages.empty?
+ init_step = stages.first.pipeline_stage_steps.first
+ @yaml += init_step.content + "\n" + "steps:\n"
+ stages = stages.slice(1, stages.size - 1)
+ unless stages.empty?
+ stages.each do |stage|
+ steps = stage.pipeline_stage_steps
+ next unless steps && !steps.empty?
+ steps.each do |step|
+ @yaml += step.content + "\n"
+ end
+ end
+ end
+ end
+ @sha = get_pipeline_file_sha(pipeline.file_name, pipeline.branch)
+ trigger = ''
+ trigger += " branch:\r\n - #{pipeline.branch}\r\n" unless pipeline.branch.blank?
+ unless pipeline.event.blank?
+ trigger += " event:\r\n"
+ pipeline.event.split(',').each { |event| trigger += " - #{event}\r\n"}
+ end
+ @yaml += "trigger:\r\n" + trigger unless trigger.blank?
+ @branch = pipeline.branch
+ end
+
+ # =========阶段相关接口========= #
+ def stages
+ pipeline_id = params[:id]
+ @pipeline_name = Ci::Pipeline.find(pipeline_id).pipeline_name
+ @pipeline_stages = Ci::PipelineStage.where('pipeline_id=?', pipeline_id).order('show_index asc')
+ end
+
+ def create_stage
+ ActiveRecord::Base.transaction do
+ # 修改stage排序
+ update_stage_index(params[:id], params[:show_index], 1)
+ pipeline_stage = Ci::PipelineStage.new(stage_name: params[:stage_name],
+ stage_type: params[:stage_type].blank? ? 'customize' : params[:stage_type],
+ pipeline_id: params[:id], show_index: params[:show_index])
+ pipeline_stage.save!
+ render_ok
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def update_stage
+ pipeline_stage = Ci::PipelineStage.find(params[:stage_id])
+ if pipeline_stage
+ pipeline_stage.update!(stage_name: params[:stage_name])
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def delete_stage
+ ActiveRecord::Base.transaction do
+ update_stage_index(params[:id], params[:show_index].to_i, -1)
+ pipeline_stage = Ci::PipelineStage.find(params[:stage_id])
+ if pipeline_stage
+ pipeline_stage.destroy!
+ end
+ render_ok
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def update_stage_index(pipeline_id, show_index, diff)
+ stages = Ci::Pipeline.find(pipeline_id).pipeline_stages
+ stages.each do |stage|
+ if stage.show_index >= show_index
+ stage.update!(show_index: stage.show_index + diff)
+ end
+ end
+ end
+
+ # ========步骤相关接口========= #
+ def steps
+ @stage_type = Ci::PipelineStage.find(params[:stage_id]).stage_type
+ @pipeline_stage_steps = Ci::PipelineStageStep.where('stage_id=?', params[:stage_id]).order('show_index asc')
+ end
+
+ def stage_step
+ ActiveRecord::Base.transaction do
+ steps = params[:steps]
+ unless steps.empty?
+ steps.each do |step|
+ unless step[:template_id]
+ render_error('请选择模板!')
+ return
+ end
+ if !step[:id]
+ step = Ci::PipelineStageStep.new(step_name: step[:step_name], stage_id: params[:stage_id],
+ template_id: step[:template_id], content: step[:content], show_index: step[:show_index])
+ step.save!
+ else
+ pipeline_stage_step = Ci::PipelineStageStep.find(step[:id])
+ pipeline_stage_step.update(step_name: step[:step_name], content: step[:content],
+ show_index: step[:show_index], template_id: step[:template_id])
+ end
+ end
+ end
+ render_ok
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def create_stage_step
+ ActiveRecord::Base.transaction do
+ steps = params[:steps]
+ unless steps.empty?
+ steps.each do |step|
+ step = Ci::PipelineStageStep.new(step_name: step[:step_name], stage_id: params[:stage_id],
+ template_id: step[:template_id], content: step[:content], show_index: step[:show_index])
+ step.save!
+ end
+ end
+ render_ok
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def update_stage_step
+ ActiveRecord::Base.transaction do
+ steps = params[:steps]
+ unless steps.empty?
+ steps.each do |step|
+ pipeline_stage_step = Ci::PipelineStageStep.find(step[:id])
+ if pipeline_stage_step
+ pipeline_stage_step.update(step_name: step[:step_name], content: step[:content], template_id: step[:template_id])
+ end
+ end
+ end
+ render_ok
+ end
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def delete_stage_step
+ pipeline_stage_step = Ci::PipelineStageStep.find(params[:step_id])
+ if pipeline_stage_step
+ pipeline_stage_step.destroy!
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+end
diff --git a/app/controllers/ci/projects_controller.rb b/app/controllers/ci/projects_controller.rb
index c7b7338f..69644e7a 100644
--- a/app/controllers/ci/projects_controller.rb
+++ b/app/controllers/ci/projects_controller.rb
@@ -41,11 +41,8 @@ class Ci::ProjectsController < Ci::BaseController
ActiveRecord::Base.transaction do
if @repo
return render_error('该项目已经激活') if @repo.repo_active?
- if @project.ci_reactivate?
- @project.ci_reactivate!(@repo)
- return render_ok
- end
- @repo.activate!(@ci_user.user_id)
+ @repo.activate!(@project)
+ return render_ok
else
@repo = Ci::Repo.auto_create!(@ci_user, @project)
@ci_user.update_column(:user_syncing, false)
@@ -66,7 +63,7 @@ class Ci::ProjectsController < Ci::BaseController
return render_error('该项目已经取消激活') if !@repo.repo_active?
@project.update_column(:open_devops, false)
- @repo.deactivate!
+ @repo.deactivate_repos!
render_ok
end
diff --git a/app/controllers/ci/secrets_controller.rb b/app/controllers/ci/secrets_controller.rb
new file mode 100644
index 00000000..698e7bbe
--- /dev/null
+++ b/app/controllers/ci/secrets_controller.rb
@@ -0,0 +1,53 @@
+class Ci::SecretsController < Ci::BaseController
+
+ before_action :load_repo
+
+ # 参数列表
+ def index
+ result = Ci::Drone::API.new(@ci_user.user_hash, ci_drone_url, params[:owner], params[:repo], nil).secrets
+ @secrets = result
+ end
+
+ #新增、更新参数
+ def create
+ options = {
+ name: params[:name],
+ data: params[:data]
+ }
+ id = params[:id]
+ if id
+ result = Ci::Drone::API.new(@ci_user.user_hash, ci_drone_url, params[:owner], params[:repo], options).update_secret
+ if result["id"]
+ render_ok
+ else
+ render_error(result["message"])
+ end
+ else
+ result = Ci::Drone::API.new(@ci_user.user_hash, ci_drone_url, params[:owner], params[:repo], options).create_secret
+ if result["id"]
+ render_ok
+ else
+ render_error(result["message"])
+ end
+ end
+ end
+
+ #删除参数
+ def destroy
+ name = params[:name]
+ if !name.blank?
+ Ci::Drone::API.new(@ci_user.user_hash, ci_drone_url, params[:owner], params[:repo], {name: name}).delete_secret
+ render_ok
+ else
+ render_error("参数名不能为空")
+ end
+ rescue Exception => ex
+ render_ok
+ end
+
+ def ci_drone_url
+ user = User.find_by(login: params[:owner])
+ user&.ci_cloud_account.drone_url
+ end
+
+end
\ No newline at end of file
diff --git a/app/controllers/ci/templates_controller.rb b/app/controllers/ci/templates_controller.rb
new file mode 100644
index 00000000..cb49590d
--- /dev/null
+++ b/app/controllers/ci/templates_controller.rb
@@ -0,0 +1,104 @@
+class Ci::TemplatesController < Ci::BaseController
+
+ before_action :require_login, only: %i[list create]
+ skip_before_action :connect_to_ci_db
+
+ #======模板管理======#
+ def list
+ stage_type = params[:stage_type]
+ template_name = params[:name]
+ templates = template_name.blank? ? Ci::Template.all : Ci::Template.where("template_name like ?", "%#{template_name}%")
+ templates = templates.select{ |template| template.login == current_user.login} unless current_user.admin?
+ if !stage_type.blank? && stage_type != 'all'
+ templates = templates.select{ |template| template.stage_type == stage_type}
+ end
+ @total_count = templates.map(&:id).count
+ @templates = paginate templates
+ end
+
+ def show
+ @template = Ci::Template.find(params[:id])
+ end
+
+ def create
+ stage_type = params[:stage_type]
+ category = params[:category]
+ if category.blank?
+ category = Ci::Template::STAGE_TYPES[:"#{stage_type}"]
+ end
+
+ if params[:id]
+ template = Ci::Template.find(params[:id])
+ if template
+ template.update!(template_name: params[:template_name],
+ stage_type: stage_type,
+ category: category,
+ parent_category: Ci::Template::STAGE_TYPES[:"#{stage_type}"],
+ content: params[:content],
+ login: current_user.admin? ? 'admin' : current_user.login
+ )
+ end
+ else
+ template = Ci::Template.new(template_name: params[:template_name],
+ stage_type: stage_type,
+ category: category,
+ parent_category: Ci::Template::STAGE_TYPES[:"#{stage_type}"],
+ content: params[:content],
+ login: current_user.admin? ? 'admin' : current_user.login
+ )
+ template.save!
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def update
+ template = Ci::Template.find(params[:id])
+ template.update!(template_name: params[:template_name],
+ stage_type: params[:stage_type],
+ category: params[:category],
+ parent_category: params[:parent_category],
+ content: params[:content]
+ )
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ def destroy
+ template = Ci::Template.find(params[:id])
+ if template
+ template.destroy!
+ end
+ render_ok
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+
+ #======流水线模板查询=====#
+ def templates_by_stage
+ stage_type = params[:stage_type]
+ if stage_type != Ci::PipelineStage::CUSTOMIZE_STAGE_TYPE
+ @templates = Ci::Template.where("stage_type = ?", stage_type)
+ @templates = @templates.select{ |template| template.login == current_user.login || template.login == 'admin'} unless current_user.admin?
+ if stage_type == Ci::PipelineStage::INIT_STAGE_TYPE && !@templates.nil?
+ @templates.each do |template|
+ content = template.content
+ unless content.blank?
+ pipeline = Ci::Pipeline.find(params[:id])
+ template.content = content.gsub(/{name}/, pipeline.pipeline_name) unless pipeline.nil?
+ end
+ end
+ end
+ # 根据模板类别分组
+ @category_templates = @templates.group_by{ |template| template.category }
+ else
+ # 自定义阶段,按阶段分类分类返回模板列表
+ @templates = Ci::Template.where("stage_type != ?", Ci::PipelineStage::INIT_STAGE_TYPE)
+ @templates = @templates.select{ |template| template.login == current_user.login || template.login == 'admin'} unless current_user.admin?
+ @category_templates = @templates.group_by{ |template| template.parent_category }
+ end
+ end
+
+end
diff --git a/app/controllers/compare_controller.rb b/app/controllers/compare_controller.rb
index e5e61598..63ca58aa 100644
--- a/app/controllers/compare_controller.rb
+++ b/app/controllers/compare_controller.rb
@@ -6,10 +6,26 @@ class CompareController < ApplicationController
end
def show
- base_ref = Addressable::URI.unescape(params[:base])
- @ref = head_ref = Addressable::URI.unescape(params[:head]&.split('.json')[0])
- @compare_result = Gitea::Repository::Commits::CompareService.call(@owner.login, @project.identifier, base_ref, head_ref)
+ compare
+ end
- # render json: @compare_result
+ private
+ def compare
+ base, head = compare_params
+
+ # TODO: 处理fork的项目向源项目发送PR的base、head参数问题
+ @compare_result ||=
+ head.include?(":") ? gitea_compare(base, head) : gitea_compare(head, base)
+ end
+
+ def compare_params
+ base = Addressable::URI.unescape(params[:base])
+ head = params[:head].include?('json') ? params[:head]&.split('.json')[0] : params[:head]
+
+ [base, head]
+ end
+
+ def gitea_compare(base, head)
+ Gitea::Repository::Commits::CompareService.call(@owner.login, @project.identifier, base, head)
end
end
diff --git a/app/controllers/concerns/ci/cloud_account_manageable.rb b/app/controllers/concerns/ci/cloud_account_manageable.rb
index 5931b31c..13edb09c 100644
--- a/app/controllers/concerns/ci/cloud_account_manageable.rb
+++ b/app/controllers/concerns/ci/cloud_account_manageable.rb
@@ -4,9 +4,10 @@ module Ci::CloudAccountManageable
included do
end
+ # 自有服务器绑定流程
def bind_account!
# 1. 保存华为云服务器帐号
- create_params = devops_params.merge(ip_num: IPAddr.new(devops_params[:ip_num].strip).to_i, secret: Ci::CloudAccount.encrypted_secret(devops_params[:secret]))
+ create_params = devops_params.merge(ip_num: IPAddr.new(devops_params[:ip_num].strip).to_i, secret: Ci::CloudAccount.encrypted_secret(devops_params[:secret]), server_type: Ci::CloudAccount::SERVER_TYPE_SELF)
cloud_account = Ci::CloudAccount.new(create_params)
cloud_account.user = current_user
@@ -15,6 +16,9 @@ module Ci::CloudAccountManageable
# 2. 生成oauth2应用程序的client_id和client_secrete
gitea_oauth = Gitea::Oauth2::CreateService.call(current_user.gitea_token, {name: "pipeline-#{SecureRandom.hex(8)}", redirect_uris: ["#{cloud_account.drone_url}/login"]})
logger.info "######### gitea_oauth: #{gitea_oauth}"
+
+ raise 'Gitea接口异常' if gitea_oauth['client_id'].blank?
+
oauth = Oauth.new(client_id: gitea_oauth['client_id'],
client_secret: gitea_oauth['client_secret'],
redirect_uri: gitea_oauth['redirect_uris'],
@@ -53,13 +57,53 @@ module Ci::CloudAccountManageable
result && !result.blank? ? cloud_account : nil
end
+ def trustie_drone_server_config
+ # 读取drone配置信息
+ config = Rails.application.config_for(:configuration).symbolize_keys!
+ trustie_drone_config = config[:trustie_drone].symbolize_keys!
+ return trustie_drone_config
+ end
+
+ # trustie提供服务器,绑定流程
+ def trustie_bind_account!
+ trustie_drone_config = trustie_drone_server_config
+ raise 'trustie_drone config missing' if trustie_drone_config.blank?
+
+ # 创建云账号
+ create_params = devops_params.merge(ip_num: IPAddr.new(trustie_drone_config[:ip_num].strip).to_i, secret: Ci::CloudAccount.encrypted_secret(trustie_drone_config[:secret]), server_type: Ci::CloudAccount::SERVER_TYPE_TRUSTIE)
+ cloud_account = Ci::CloudAccount.new(create_params)
+ cloud_account.user = current_user
+ cloud_account.save!
+
+ #生成oauth2应用程序的client_id和client_secrete
+ gitea_oauth = Gitea::Oauth2::CreateService.call(current_user.gitea_token, {name: "pipeline-#{SecureRandom.hex(8)}", redirect_uris: ["#{cloud_account.drone_url}/login"]})
+ logger.info "######### gitea_oauth: #{gitea_oauth}"
+
+ raise 'Gitea接口异常' if gitea_oauth['client_id'].blank?
+
+ oauth = Oauth.new(client_id: gitea_oauth['client_id'],
+ client_secret: gitea_oauth['client_secret'],
+ redirect_uri: gitea_oauth['redirect_uris'],
+ gitea_oauth_id: gitea_oauth['id'],
+ user_id: current_user.id)
+ result = oauth.save!
+
+ redirect_url = "#{cloud_account.drone_url}/login"
+ logger.info "######### redirect_url: #{redirect_url}"
+
+ return nil unless result.present?
+ result ? cloud_account : nil
+ end
+
def unbind_account!
cloud_account = current_user.ci_cloud_account
return render_error('你未绑定CI服务器') if current_user.devops_step == User::DEVOPS_UNINIT || cloud_account.blank?
- cloud_account.destroy! unless cloud_account.blank?
- @connection.execute("DROP DATABASE IF EXISTS #{current_user.login}_drone") # TOTO drop drone database
+ if cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_SELF
+ @connection.execute("DROP DATABASE IF EXISTS #{current_user.login}_drone") # TOTO drop drone database
+ end
+ cloud_account.destroy! unless cloud_account.blank?
current_user.unbind_account!
end
@@ -81,7 +125,16 @@ module Ci::CloudAccountManageable
return [true, "你已经绑定了云帐号."] unless current_user.ci_cloud_account.blank?
ip_num = IPAddr.new(devops_params[:ip_num]).to_i
- Ci::CloudAccount.exists?(ip_num: ip_num) ? [true, "#{devops_params[:ip_num]}服务器已被使用."] : [false, nil]
+
+ #自有服务器进行判断
+ cloud_account = current_user.ci_cloud_account
+ if cloud_account && cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_SELF
+ Ci::CloudAccount.exists?(ip_num: ip_num) ? [true, "#{devops_params[:ip_num]}服务器已被使用."] : [false, nil]
+ end
+ end
+
+ def check_trustie_bind_cloud_account!
+ return [true, "你已经绑定了云帐号."] unless current_user.ci_cloud_account.blank?
end
def gitea_auto_create_auth_grant!(gitea_oauth_id)
@@ -89,19 +142,27 @@ module Ci::CloudAccountManageable
unix_time = Time.now.to_i
# 目前直接操作db,可以建立对应的model进行操作
- sql = "INSERT INTO oauth2_grant ( user_id, application_id, counter, created_unix, updated_unix ) VALUES ( #{current_user.gitea_uid}, #{gitea_oauth_id}, 0, #{unix_time}, #{unix_time} );"
+ sql = "REPLACE INTO oauth2_grant ( user_id, application_id, counter, created_unix, updated_unix ) VALUES ( #{current_user.gitea_uid}, #{gitea_oauth_id}, 0, #{unix_time}, #{unix_time} );"
connection.execute(sql)
+
+ #如果使用trustie提供的服务器,需要多增加一条授权信息
+ if current_user.ci_cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_TRUSTIE
+ trustie_drone_config = trustie_drone_server_config
+ admin_application_id = trustie_drone_config[:admin_application_id]
+ sql = "REPLACE INTO oauth2_grant ( user_id, application_id, counter, created_unix, updated_unix ) VALUES ( #{current_user.gitea_uid}, #{admin_application_id}, 0, #{unix_time}, #{unix_time} );"
+ connection.execute(sql)
+ end
end
def gitea_oauth_grant!(password, oauth)
gitea_auto_create_auth_grant!(oauth&.gitea_oauth_id)
state = SecureRandom.hex(8)
-
# redirect_uri eg:
# https://localhost:3000/login/oauth/authorize?client_id=94976481-ad0e-4ed4-9247-7eef106007a2&redirect_uri=http%3A%2F%2F121.69.81.11%3A80%2Flogin&response_type=code&state=9cab990b9cfb1805
redirect_uri = CGI.escape("#{@cloud_account.drone_url}/login")
- grant_url = "#{Gitea.gitea_config[:domain]}/login/oauth/authorize?client_id=#{oauth&.client_id}&redirect_uri=#{redirect_uri}&response_type=code&state=#{state}"
+ clientId = client_id(oauth)
+ grant_url = "#{Gitea.gitea_config[:domain]}/login/oauth/authorize?client_id=#{clientId}&redirect_uri=#{redirect_uri}&response_type=code&state=#{state}"
logger.info "[gitea] grant_url: #{grant_url}"
conn = Faraday.new(url: grant_url) do |req|
@@ -135,4 +196,14 @@ module Ci::CloudAccountManageable
params.permit(:account, :secret, :ip_num)
end
+ def client_id(oauth)
+ #如果是使用trustie服务器使用管理员用户的clientId
+ if current_user.ci_cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_TRUSTIE
+ trustie_drone_config = trustie_drone_server_config
+ return trustie_drone_config[:client_id]
+ else
+ return oauth&.client_id
+ end
+ end
+
end
diff --git a/app/controllers/concerns/ci/db_connectable.rb b/app/controllers/concerns/ci/db_connectable.rb
index 2aaff87b..e2c8ffef 100644
--- a/app/controllers/concerns/ci/db_connectable.rb
+++ b/app/controllers/concerns/ci/db_connectable.rb
@@ -17,12 +17,31 @@ module Ci::DbConnectable
password: db_config[:password],
port: db_config[:port]
}
- req_params = req_params.merge(database: "#{current_user.login}_#{db_config[:database]}") unless master_db === true
+ db_name = options[:db_name].blank? ? current_user.login : options[:db_name]
+ req_params = req_params.merge(database: "#{db_name}_#{db_config[:database]}") unless master_db === true
db_params = Ci::Database.get_connection_params(req_params)
@connection = Ci::Database.set_connection(db_params).connection
end
+ def connect_to_trustie_ci_database(options={})
+ master_db = options[:master_db] || false
+ config = Rails.application.config_for(:configuration).symbolize_keys!
+ db_config = config[:ci_db_server_trustie].symbolize_keys!
+ raise 'ci database config missing' if db_config.blank?
+
+ req_params = {
+ host: db_config[:host],
+ username: db_config[:username],
+ password: db_config[:password],
+ port: db_config[:port]
+ }
+
+ req_params = req_params.merge(database: "#{db_config[:database]}") unless master_db === true
+ db_params = Ci::Database.get_connection_params(req_params)
+ @trustie_db_connection = Ci::Database.set_connection(db_params).connection
+ end
+
def auto_create_database!(connection, database)
Rails.logger.info "[CI::DbConnectable] auto_create_database's connection: #{connection}"
connection.execute("CREATE DATABASE IF NOT EXISTS #{database}")
diff --git a/app/controllers/concerns/paginate_helper.rb b/app/controllers/concerns/paginate_helper.rb
index 7233adeb..638a3242 100644
--- a/app/controllers/concerns/paginate_helper.rb
+++ b/app/controllers/concerns/paginate_helper.rb
@@ -1,12 +1,14 @@
module PaginateHelper
- def paginate(objs, **opts)
- page = params[:page].to_i <= 0 ? 1 : params[:page].to_i
- per_page = params[:per_page].to_i > 0 && params[:per_page].to_i < 50 ? params[:per_page].to_i : opts[:per_page] || 20
- if objs.is_a?(Array)
- Kaminari.paginate_array(objs).page(page).per(per_page)
+ def paginate(relation)
+ limit = params[:limit] || params[:per_page]
+ limit = (limit.to_i.zero? || limit.to_i > 15) ? 15 : limit.to_i
+ page = params[:page].to_i.zero? ? 1 : params[:page].to_i
+
+ if relation.is_a?(Array)
+ Kaminari.paginate_array(relation).page(page).per(limit)
else
- objs.page(page).per(per_page)
+ relation.page(page).per(limit)
end
end
end
\ No newline at end of file
diff --git a/app/controllers/concerns/register_helper.rb b/app/controllers/concerns/register_helper.rb
index a229ef42..d77a3358 100644
--- a/app/controllers/concerns/register_helper.rb
+++ b/app/controllers/concerns/register_helper.rb
@@ -1,20 +1,26 @@
module RegisterHelper
extend ActiveSupport::Concern
- def autologin_register(username, email, password, platform= 'forge')
+ def autologin_register(username, email, password, platform= 'forge', need_edit_info = false)
result = {message: nil, user: nil}
user = User.new(admin: false, login: username, mail: email, type: "User")
user.password = password
user.platform = platform
- user.activate
+ if need_edit_info
+ user.need_edit_info
+ else
+ user.activate
+ end
+
+ return unless user.valid?
interactor = Gitea::RegisterInteractor.call({username: username, email: email, password: password})
if interactor.success?
gitea_user = interactor.result
- result = Gitea::User::GenerateTokenService.new(username, password).call
+ result = Gitea::User::GenerateTokenService.call(username, password)
user.gitea_token = result['sha1']
- user.gitea_uid = gitea_user['id']
+ user.gitea_uid = gitea_user[:body]['id']
if user.save!
UserExtension.create!(user_id: user.id)
result[:user] = {id: user.id, token: user.gitea_token}
@@ -25,4 +31,30 @@ module RegisterHelper
result
end
+ def autosync_register_trustie(username, password, email)
+ config = Rails.application.config_for(:configuration).symbolize_keys!
+
+ api_host = config[:sync_url]
+
+ return if api_host.blank?
+
+ url = "#{api_host}/api/v1/users/common"
+ sync_json = {
+ "mail": email,
+ "password": password,
+ "login": username
+ }
+ uri = URI.parse(url)
+
+ if api_host
+ http = Net::HTTP.new(uri.hostname, uri.port)
+
+ if api_host.include?("https://")
+ http.use_ssl = true
+ end
+
+ http.send_request('POST', uri.path, sync_json.to_json, {'Content-Type' => 'application/json'})
+ end
+ end
+
end
diff --git a/app/controllers/concerns/repository/languages_percentagable.rb b/app/controllers/concerns/repository/languages_percentagable.rb
new file mode 100644
index 00000000..dc6abcb9
--- /dev/null
+++ b/app/controllers/concerns/repository/languages_percentagable.rb
@@ -0,0 +1,19 @@
+module Repository::LanguagesPercentagable
+ extend ActiveSupport::Concern
+
+ def languages_precentagable
+ result = Gitea::Repository::Languages::ListService.call(@owner.login,
+ @repository.identifier, current_user&.gitea_token)
+
+ result[:status] === :success ? hash_transform_precentagable(result[:body]) : nil
+ end
+
+ # hash eq:{"JavaScript": 301681522,"Ruby": 1444004,"Roff": 578781}
+ def hash_transform_precentagable(hash)
+ total_byte_size = hash.values.sum
+ hash.transform_values { |v|
+ ActionController::Base.helpers
+ .number_to_percentage((v * 100.0 / total_byte_size), precision: 1)
+ }.select{|k,v| v != "0.0%"}
+ end
+end
diff --git a/app/controllers/issues_controller.rb b/app/controllers/issues_controller.rb
index 679a57ef..d6722e0e 100644
--- a/app/controllers/issues_controller.rb
+++ b/app/controllers/issues_controller.rb
@@ -12,6 +12,7 @@ class IssuesController < ApplicationController
include TagChosenHelper
def index
+ return render_not_found unless @project.has_menu_permission("issues")
@user_admin_or_member = current_user.present? && current_user.logged? && (current_user.admin || @project.member?(current_user))
issues = @project.issues.issue_issue.issue_index_includes
issues = issues.where(is_private: false) unless @user_admin_or_member
diff --git a/app/controllers/members_controller.rb b/app/controllers/members_controller.rb
index 2964eb1a..bea4a0d2 100644
--- a/app/controllers/members_controller.rb
+++ b/app/controllers/members_controller.rb
@@ -47,7 +47,7 @@ class MembersController < ApplicationController
end
def member_exists?
- @project.member?(params[:user_id])
+ @project.members.exists?(params[:user_id])
end
def operate!
@@ -59,6 +59,6 @@ class MembersController < ApplicationController
end
def check_member_not_exists!
- return render_result(1, "user_id为#{params[:user_id]}的用户还不是项目成员") unless member_exists?
+ return render_result(1, "user_id为#{params[:user_id]}的用户还不是项目成员") unless @project.member?(params[:user_id])
end
end
diff --git a/app/controllers/oauth/base_controller.rb b/app/controllers/oauth/base_controller.rb
index 3fe349bb..6956c9ce 100644
--- a/app/controllers/oauth/base_controller.rb
+++ b/app/controllers/oauth/base_controller.rb
@@ -2,6 +2,7 @@ class Oauth::BaseController < ActionController::Base
include RenderHelper
include LoginHelper
include ControllerRescueHandler
+ include LoggerHelper
# include LaboratoryHelper
skip_before_action :verify_authenticity_token
@@ -11,6 +12,18 @@ class Oauth::BaseController < ActionController::Base
end
private
+ def tip_exception(status = -1, message)
+ raise Educoder::TipException.new(status, message)
+ end
+
+ def tip_show_exception(status = -2, message)
+ raise Educoder::TipException.new(status, message)
+ end
+
+ def tip_show(exception)
+ uid_logger("Tip show status is #{exception.status}, message is #{exception.message}")
+ render json: exception.tip_json
+ end
def session_user_id
# session[:user_id]
@@ -48,4 +61,13 @@ class Oauth::BaseController < ActionController::Base
Rails.logger.info("[wechat] set session unionid: #{unionid}")
session[:unionid] = unionid
end
+
+ def session_edulogin
+ session[:edulogin]
+ end
+
+ def set_session_edulogin(login)
+ Rails.logger.info("[educoder] set sesstion edulogin: #{login}")
+ session[:edulogin] = login
+ end
end
diff --git a/app/controllers/oauth/educoder_controller.rb b/app/controllers/oauth/educoder_controller.rb
index 8ed537d6..9ca4ae49 100644
--- a/app/controllers/oauth/educoder_controller.rb
+++ b/app/controllers/oauth/educoder_controller.rb
@@ -1,4 +1,6 @@
class Oauth::EducoderController < Oauth::BaseController
+ include RegisterHelper
+
def bind
begin
login = params[:login]
@@ -32,4 +34,41 @@ class Oauth::EducoderController < Oauth::BaseController
render_error(ex.message)
end
end
+
+ # 需要educoder那边设置回调地址
+ def create
+ begin
+ code = params['code'].to_s.strip
+ tip_exception("code不能为空") if code.blank?
+
+ new_user = false
+ result = EducoderOauth::Service.access_token(code)
+ result = EducoderOauth::Service.user_info(result[:access_token])
+
+ # 存在该用户
+ open_user = OpenUsers::Educoder.find_by(uid: result['login'])
+ if open_user.present? && open_user.user.present?
+ successful_authentication(open_user.user)
+ else
+ if current_user.blank? || !current_user.logged?
+ new_user = true
+ login = User.generate_login('E')
+ reg_result = autologin_register(login,"#{login}@forge.com", "Ec#{login}2021#", 'educoder', true)
+ if reg_result[:message].blank?
+ open_user = OpenUsers::Educoder.create!(user_id: reg_result[:user][:id], uid: result['login'], extra: result)
+ autosync_register_trustie(login, "Ec#{login}2021#", "#{login}@forge.com")
+ successful_authentication(open_user.user)
+ else
+ render_error(reg_result[:message])
+ end
+ else
+ OpenUsers::Educoder.create!(user: current_user, uid: result['login'], extra: result)
+ end
+ end
+
+ redirect_to root_path(new_user: new_user)
+ rescue Exception => ex
+ render_error(ex.message)
+ end
+ end
end
diff --git a/app/controllers/organizations/base_controller.rb b/app/controllers/organizations/base_controller.rb
new file mode 100644
index 00000000..e6163bf8
--- /dev/null
+++ b/app/controllers/organizations/base_controller.rb
@@ -0,0 +1,34 @@
+class Organizations::BaseController < ApplicationController
+ include ApplicationHelper
+ include PaginateHelper
+
+ protected
+
+ def can_edit_org?
+ current_user.admin? || @organization.is_owner?(current_user.id)
+ end
+
+ def check_user_can_edit_org
+ tip_exception("您没有权限进行该操作") unless can_edit_org?
+ end
+
+ def org_limited_condition
+ @organization.organization_extension.limited? && !current_user.logged?
+ end
+
+ def org_privacy_condition
+ @organization.organization_extension.privacy? && @organization.organization_users.where(user_id: current_user.id).blank?
+ end
+
+ def team_not_found_condition
+ !current_user&.admin? && @team.team_users.where(user_id: current_user.id).blank? && !@organization.is_owner?(current_user.id)
+ end
+
+ def user_mark
+ params[:username] || params[:id]
+ end
+
+ def project_mark
+ params[:repo_name] || params[:id]
+ end
+end
diff --git a/app/controllers/organizations/organization_users_controller.rb b/app/controllers/organizations/organization_users_controller.rb
new file mode 100644
index 00000000..8a7755a1
--- /dev/null
+++ b/app/controllers/organizations/organization_users_controller.rb
@@ -0,0 +1,57 @@
+class Organizations::OrganizationUsersController < Organizations::BaseController
+ before_action :load_organization
+ before_action :load_operate_user, :load_organization_user, :check_user_can_edit_org, only: [:destroy]
+
+ def index
+ @organization_users = @organization.organization_users.includes(:user)
+ search = params[:search].to_s.downcase
+ @organization_users = @organization_users.joins(:user).where("LOWER(CONCAT_WS(users.lastname, users.firstname, users.login, users.mail)) LIKE ?", "%#{search.split(" ").join('|')}%") if search.present?
+
+ @organization_users = kaminari_paginate(@organization_users)
+ end
+
+ def destroy
+ tip_exception("您不能从所有者团队中删除最后一个用户") if @organization.is_owner_team_last_one?(@operate_user.id)
+ ActiveRecord::Base.transaction do
+ @organization_user.destroy!
+ TeamUser.where(organization_id: @organization.id, user_id: @operate_user.id).map{|u| u.destroy!}
+ Gitea::Organization::OrganizationUser::DeleteService.call(@organization.gitea_token, @organization.login, @operate_user.login)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def quit
+ @organization_user = @organization.organization_users.find_by(user_id: current_user.id)
+ tip_exception("您不在该组织中") if @organization_user.nil?
+ tip_exception("您不能从所有者团队中删除最后一个用户") if @organization.is_owner_team_last_one?(current_user.id)
+ ActiveRecord::Base.transaction do
+ @organization_user.destroy!
+ TeamUser.where(organization_id: @organization.id, user_id: current_user.id).map{|u| u.destroy!}
+ Gitea::Organization::OrganizationUser::DeleteService.call(@organization.gitea_token, @organization.login, current_user.login)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def load_organization
+ @organization = Organization.find_by(login: params[:organization_id]) || Organization.find_by(id: params[:organization_id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def load_operate_user
+ @operate_user = User.find_by(login: user_mark) if user_mark.present?
+ tip_exception("平台用户不存在") if @operate_user.nil?
+ end
+
+ def load_organization_user
+ @organization_user = OrganizationUser.find_by(organization_id: @organization.id, user_id: @operate_user.id)
+ tip_exception("组织成员不存在") if @organization_user.nil?
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/organizations/organizations_controller.rb b/app/controllers/organizations/organizations_controller.rb
new file mode 100644
index 00000000..09c12fd5
--- /dev/null
+++ b/app/controllers/organizations/organizations_controller.rb
@@ -0,0 +1,109 @@
+class Organizations::OrganizationsController < Organizations::BaseController
+ before_action :require_login, except: [:index, :show]
+ before_action :convert_image!, only: [:create, :update]
+ before_action :load_organization, only: [:show, :update, :destroy]
+ before_action :check_user_can_edit_org, only: [:update, :destroy]
+
+ def index
+ if current_user.logged?
+ logged_organizations_sql = Organization.with_visibility(%w(common limited)).to_sql
+ privacy_organizations_sql = Organization.with_visibility("privacy").joins(:organization_users).where(organization_users: {user_id: current_user.id}).to_sql
+ @organizations = Organization.from("( #{ logged_organizations_sql } UNION #{ privacy_organizations_sql } ) AS users")
+ else
+ @organizations = Organization.with_visibility("common")
+ end
+ @organizations = @organizations.ransack(login_cont: params[:search]).result if params[:search].present?
+ @organizations = @organizations.includes(:organization_extension).order("organization_extensions.#{sort_by} #{sort_direction}")
+ @organizations = kaminari_paginate(@organizations)
+ end
+
+ def show
+ @can_create_project = @organization.can_create_project?(current_user.id)
+ @is_admin = can_edit_org?
+ @is_member = @organization.is_member?(current_user.id)
+ end
+
+ def create
+ ActiveRecord::Base.transaction do
+ Organizations::CreateForm.new(organization_params).validate!
+ @organization = Organizations::CreateService.call(current_user, organization_params)
+ Util.write_file(@image, avatar_path(@organization)) if params[:image].present?
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def update
+ ActiveRecord::Base.transaction do
+ login = @organization.login
+ @organization.login = organization_params[:name] if organization_params[:name].present?
+ @organization.nickname = organization_params[:nickname] if organization_params[:nickname].present?
+ @organization.save!
+ @organization.organization_extension.update_attributes!(organization_params.except(:name, :nickname))
+ Gitea::Organization::UpdateService.call(@organization.gitea_token, login, @organization.reload)
+ Util.write_file(@image, avatar_path(@organization)) if params[:image].present?
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def destroy
+ tip_exception("密码不正确") unless current_user.check_password?(password)
+ ActiveRecord::Base.transaction do
+ Gitea::Organization::DeleteService.call(@organization.gitea_token, @organization.login)
+ @organization.destroy!
+ end
+ render_ok
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def convert_image!
+ return unless params[:image].present?
+ max_size = EduSetting.get('upload_avatar_max_size') || 2 * 1024 * 1024 # 2M
+ if params[:image].class == ActionDispatch::Http::UploadedFile
+ @image = params[:image]
+ render_error('请上传文件') if @image.size.zero?
+ render_error('文件大小超过限制') if @image.size > max_size.to_i
+ else
+ image = params[:image].to_s.strip
+ return render_error('请上传正确的图片') if image.blank?
+ @image = Util.convert_base64_image(image, max_size: max_size.to_i)
+ end
+ rescue Base64ImageConverter::Error => ex
+ render_error(ex.message)
+ end
+
+ def avatar_path(organization)
+ ApplicationController.helpers.disk_filename(organization.class, organization.id)
+ end
+
+ def organization_params
+ params.permit(:name, :description, :website, :location,
+ :repo_admin_change_team_access, :visibility,
+ :max_repo_creation, :nickname)
+ end
+
+ def password
+ params.fetch(:password, "")
+ end
+
+ def load_organization
+ @organization = Organization.find_by(login: params[:id]) || Organization.find_by(id: params[:id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def sort_by
+ params.fetch(:sort_by, "created_at")
+ end
+
+ def sort_direction
+ params.fetch(:sort_direction, "desc")
+ end
+
+end
\ No newline at end of file
diff --git a/app/controllers/organizations/projects_controller.rb b/app/controllers/organizations/projects_controller.rb
new file mode 100644
index 00000000..cc275b09
--- /dev/null
+++ b/app/controllers/organizations/projects_controller.rb
@@ -0,0 +1,45 @@
+class Organizations::ProjectsController < Organizations::BaseController
+ before_action :load_organization
+
+ def index
+ public_projects_sql = @organization.projects.where(is_public: true).to_sql
+ private_projects_sql = @organization.projects
+ .where(is_public: false)
+ .joins(team_projects: {team: :team_users})
+ .where(team_users: {user_id: current_user.id}).to_sql
+ @projects = Project.from("( #{ public_projects_sql} UNION #{ private_projects_sql } ) AS projects")
+
+ @projects = @projects.ransack(name_or_identifier_cont: params[:search]).result if params[:search].present?
+ @projects = @projects.includes(:owner).order("projects.#{sort} #{sort_direction}")
+ @projects = paginate(@projects)
+ end
+
+ def search
+ tip_exception("请输入搜索关键词") if params[:search].nil?
+ public_projects_sql = @organization.projects.where(is_public: true).to_sql
+ private_projects_sql = @organization.projects
+ .where(is_public: false)
+ .joins(team_projects: {team: :team_users})
+ .where(team_users: {user_id: current_user.id}).to_sql
+ @projects = Project.from("( #{ public_projects_sql} UNION #{ private_projects_sql } ) AS projects")
+
+ @projects = @projects.ransack(name_or_identifier_cont: params[:search]).result
+ @projects = @projects.includes(:owner).order("projects.#{sort} #{sort_direction}")
+ end
+
+ private
+
+ def load_organization
+ @organization = Organization.find_by(login: params[:organization_id]) || Organization.find_by(id: params[:organization_id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def sort
+ params.fetch(:sort_by, "updated_on")
+ end
+
+ def sort_direction
+ params.fetch(:sort_direction, "desc")
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/organizations/team_projects_controller.rb b/app/controllers/organizations/team_projects_controller.rb
new file mode 100644
index 00000000..2badca17
--- /dev/null
+++ b/app/controllers/organizations/team_projects_controller.rb
@@ -0,0 +1,58 @@
+class Organizations::TeamProjectsController < Organizations::BaseController
+ before_action :load_organization
+ before_action :load_team
+ before_action :load_operate_project, :check_user_can_edit_org, only: [:create, :destroy]
+ before_action :load_team_project, only: [:destroy]
+
+ def index
+ @team_projects = @team.team_projects
+
+ @team_projects = paginate(@team_projects)
+ end
+
+ def create
+ tip_exception("该组织团队项目包括组织所有项目,不允许更改") if @team.includes_all_project
+ ActiveRecord::Base.transaction do
+ @team_project = TeamProject.build(@organization.id, @team.id, @operate_project.id)
+ Gitea::Organization::TeamProject::CreateService.call(@organization.gitea_token, @team.gtid, @organization.login, @operate_project.identifier)
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def destroy
+ tip_exception("该组织团队项目包括组织所有项目,不允许更改") if @team.includes_all_project
+ ActiveRecord::Base.transaction do
+ @team_project.destroy!
+ Gitea::Organization::TeamProject::DeleteService.call(@organization.gitea_token, @team.gtid, @organization.login, @operate_project.identifier)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def load_organization
+ @organization = Organization.find_by(login: params[:organization_id]) || Organization.find_by(id: params[:organization_id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def load_team
+ @team = Team.find_by_id(params[:team_id])
+ return render_not_found("组织团队不存在") if @team.nil?
+ return render_forbidden("没有查看组织团队的权限") if team_not_found_condition
+ end
+
+ def load_operate_project
+ @operate_project = Project.find_by(id: project_mark) || Project.find_by(identifier: project_mark)
+ tip_exception("项目不存在") if @operate_project.nil?
+ end
+
+ def load_team_project
+ @team_project = TeamProject.find_by(organization_id: @organization.id, team_id: @team.id, project_id: @operate_project.id)
+ tip_exception("组织团队项目不存在") if @team_project.nil?
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/organizations/team_users_controller.rb b/app/controllers/organizations/team_users_controller.rb
new file mode 100644
index 00000000..d8694a6c
--- /dev/null
+++ b/app/controllers/organizations/team_users_controller.rb
@@ -0,0 +1,76 @@
+class Organizations::TeamUsersController < Organizations::BaseController
+ before_action :load_organization, :load_team
+ before_action :load_operate_user, only: [:create, :destroy]
+ before_action :load_team_user, only: [:destroy]
+ before_action :check_user_can_edit_org, only: [:create, :destroy]
+
+ def index
+ @team_users = @team.team_users.includes(:user)
+
+ search = params[:search].to_s.downcase
+ @team_users = @team_users.joins(:user).where("LOWER(CONCAT_WS(users.lastname, users.firstname, users.login, users.mail, users.nickname)) LIKE ?", "%#{search.split(" ").join('|')}%") if search.present?
+
+ @team_users = kaminari_paginate(@team_users)
+ end
+
+ def create
+ ActiveRecord::Base.transaction do
+ @team_user = TeamUser.build(@organization.id, @operate_user.id, @team.id)
+ @organization_user = OrganizationUser.build(@organization.id, @operate_user.id)
+ Gitea::Organization::TeamUser::CreateService.call(@organization.gitea_token, @team.gtid, @operate_user.login)
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def destroy
+ tip_exception("您不能从所有者团队中删除最后一个用户") if @team.owner? && @organization.is_owner_team_last_one?(@operate_user.id)
+ ActiveRecord::Base.transaction do
+ @team_user.destroy!
+ Gitea::Organization::TeamUser::DeleteService.call(@organization.gitea_token, @team.gtid, @operate_user.login)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def quit
+ @team_user = @team.team_users.find_by(user_id: current_user.id)
+ tip_exception("您不在该组织团队中") if @team_user.nil?
+ tip_exception("您不能从所有者团队中删除最后一个用户") if @team.owner? && @organization.is_owner_team_last_one?(current_user.id)
+ ActiveRecord::Base.transaction do
+ @team_user.destroy!
+ Gitea::Organization::TeamUser::DeleteService.call(@organization.gitea_token, @team.gtid, current_user.login)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def load_organization
+ @organization = Organization.find_by(login: params[:organization_id]) || Organization.find_by(id: params[:organization_id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def load_team
+ @team = Team.find_by_id(params[:team_id])
+ return render_not_found("组织团队不存在") if @team.nil?
+ return render_forbidden("没有查看组织团队的权限") if team_not_found_condition
+ end
+
+ def load_operate_user
+ @operate_user = User.find_by(login: user_mark) if user_mark.present?
+ tip_exception("平台用户不存在") if @operate_user.nil?
+ end
+
+ def load_team_user
+ @team_user = TeamUser.find_by(team_id: @team.id, user_id: @operate_user.id)
+ tip_exception("组织团队成员不存在") if @team_user.nil?
+ end
+
+end
\ No newline at end of file
diff --git a/app/controllers/organizations/teams_controller.rb b/app/controllers/organizations/teams_controller.rb
new file mode 100644
index 00000000..a8d06ce4
--- /dev/null
+++ b/app/controllers/organizations/teams_controller.rb
@@ -0,0 +1,80 @@
+class Organizations::TeamsController < Organizations::BaseController
+ before_action :load_organization
+ before_action :load_team, only: [:show, :update, :destroy]
+ before_action :check_user_can_edit_org, only: [:create, :update, :destroy]
+
+ def index
+ #if @organization.is_owner?(current_user) || current_user.admin?
+ @teams = @organization.teams
+ #else
+ # @teams = @organization.teams.joins(:team_users).where(team_users: {user_id: current_user.id})
+ #end
+ @is_admin = can_edit_org?
+ @teams = @teams.includes(:team_units, :team_users)
+
+ @teams = kaminari_paginate(@teams)
+ end
+
+ def search
+ tip_exception("请输入搜索关键词") if params[:search].nil?
+ if @organization.is_owner?(current_user) || current_user.admin?
+ @teams = @organization.teams
+ else
+ @teams = @organization.teams.joins(:team_users).where(team_users: {user_id: current_user.id})
+ end
+ @is_admin = can_edit_org?
+ @teams = @teams.ransack(name_cont: params[:search]).result if params[:search].present?
+ @teams = @teams.includes(:team_units, :team_users)
+ end
+
+ def show
+ @is_admin = can_edit_org?
+ @is_member = @team.is_member?(current_user.id)
+ end
+
+ def create
+ ActiveRecord::Base.transaction do
+ Organizations::CreateTeamForm.new(team_params).validate!
+ @team = Organizations::Teams::CreateService.call(current_user, @organization, team_params)
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def update
+ @team = Organizations::Teams::UpdateService.call(current_user, @team, team_params)
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def destroy
+ tip_exception("组织团队不允许被删除") if @team.owner?
+ ActiveRecord::Base.transaction do
+ Gitea::Organization::Team::DeleteService.call(@organization.gitea_token, @team.gtid)
+ @team.destroy!
+ end
+ render_ok
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def team_params
+ params.permit(:name, :nickname, :description, :authorize, :includes_all_project, :can_create_org_project, :unit_types => [])
+ end
+
+ def load_organization
+ @organization = Organization.find_by(login: params[:organization_id]) || Organization.find_by(id: params[:organization_id])
+ return render_not_found("组织不存在") if @organization.nil?
+ return render_forbidden("没有查看组织的权限") if org_limited_condition || org_privacy_condition
+ end
+
+ def load_team
+ @team = Team.find_by_id(params[:id])
+ return render_not_found("组织团队不存在") if @team.nil?
+ return render_forbidden("没有查看组织团队的权限") if team_not_found_condition
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/owners_controller.rb b/app/controllers/owners_controller.rb
new file mode 100644
index 00000000..97444f7a
--- /dev/null
+++ b/app/controllers/owners_controller.rb
@@ -0,0 +1,12 @@
+class OwnersController < ApplicationController
+ before_action :require_login
+
+ def index
+ @owners = []
+ @owners += [current_user]
+ @owners += Organization.joins(team_users: :team)
+ .where(team_users: {user_id: current_user.id},
+ teams: {can_create_org_project: true})
+ .distinct
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/projects/project_units_controller.rb b/app/controllers/projects/project_units_controller.rb
new file mode 100644
index 00000000..e21fa388
--- /dev/null
+++ b/app/controllers/projects/project_units_controller.rb
@@ -0,0 +1,24 @@
+class Projects::ProjectUnitsController < Projects::BaseController
+ def index
+ @project_units = @project.project_units
+ end
+
+ def create
+ if current_user.admin? || @project.manager?(current_user)
+ ActiveRecord::Base.transaction do
+ ProjectUnit.update_by_unit_types!(@project, unit_types)
+ render_ok
+ end
+ else
+ render_forbidden('你没有权限操作')
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def unit_types
+ params.fetch(:unit_types, [])
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/projects/teams_controller.rb b/app/controllers/projects/teams_controller.rb
new file mode 100644
index 00000000..b6ea3218
--- /dev/null
+++ b/app/controllers/projects/teams_controller.rb
@@ -0,0 +1,47 @@
+class Projects::TeamsController < Projects::BaseController
+ before_action :load_operate_team, only: [:create, :destroy]
+ before_action :load_team_project, only: :destroy
+
+ def index
+ if @project.owner.is_a?(Organization)
+ @teams = Team.joins(:team_projects).where(team_projects: {project_id: @project.id})
+ else
+ @teams = Team.none
+ end
+ @teams = paginate(@teams)
+ end
+
+ def create
+ ActiveRecord::Base.transaction do
+ @team_project = TeamProject.build(@owner.id, @operate_team.id, @project.id)
+ Gitea::Organization::TeamProject::CreateService.call(@owner.gitea_token, @operate_team.gtid, @owner.login, @project.identifier)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ def destroy
+ ActiveRecord::Base.transaction do
+ @team_project.destroy!
+ Gitea::Organization::TeamProject::DeleteService.call(@owner.gitea_token, @operate_team.gtid, @owner.login, @project.identifier)
+ render_ok
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
+ private
+ def load_operate_team
+ @operate_team = Team.find_by(id: params[:team_id]) || Team.find_by(id: params[:id])
+ tip_exception("项目不存在") if @operate_team.nil?
+ tip_exception("该组织团队拥有组织所有项目,无法进行操作") if @operate_team.includes_all_project
+ end
+
+ def load_team_project
+ @team_project = TeamProject.find_by(organization_id: @owner.id, team_id: @operate_team.id, project_id: @project.id)
+ tip_exception("组织团队项目不存在") if @team_project.nil?
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/projects_controller.rb b/app/controllers/projects_controller.rb
index 8c6b6c6f..004128f2 100644
--- a/app/controllers/projects_controller.rb
+++ b/app/controllers/projects_controller.rb
@@ -2,16 +2,32 @@ class ProjectsController < ApplicationController
include ApplicationHelper
include OperateProjectAbilityAble
include ProjectsHelper
- before_action :require_login, except: %i[index branches group_type_list simple show fork_users praise_users watch_users recommend about]
+ before_action :require_login, except: %i[index branches group_type_list simple show fork_users praise_users watch_users recommend about menu_list]
before_action :load_project, except: %i[index group_type_list migrate create recommend]
before_action :authorizate_user_can_edit_project!, only: %i[update]
before_action :project_public?, only: %i[fork_users praise_users watch_users]
+ def menu_list
+ menu = []
+
+ menu.append(menu_hash_by_name("home"))
+ menu.append(menu_hash_by_name("code")) if @project.has_menu_permission("code")
+ menu.append(menu_hash_by_name("issues")) if @project.has_menu_permission("issues")
+ menu.append(menu_hash_by_name("pulls")) if @project.has_menu_permission("pulls")
+ menu.append(menu_hash_by_name("devops")) if @project.has_menu_permission("devops")
+ menu.append(menu_hash_by_name("versions")) if @project.has_menu_permission("versions")
+ menu.append(menu_hash_by_name("resources")) if @project.has_menu_permission("resources")
+ menu.append(menu_hash_by_name("activity"))
+ menu.append(menu_hash_by_name("setting")) if current_user.admin? || @project.manager?(current_user)
+
+ render json: menu
+ end
+
def index
scope = Projects::ListQuery.call(params)
# @projects = kaminari_paginate(scope)
- @projects = paginate scope.includes(:project_category, :project_language, :repository, :project_educoder, owner: :user_extension)
+ @projects = paginate scope.includes(:project_category, :project_language, :repository, :project_educoder, :owner, :project_units)
category_id = params[:category_id]
@total_count =
@@ -44,7 +60,10 @@ class ProjectsController < ApplicationController
end
def branches
- @branches = @project.forge? ? Gitea::Repository::Branches::ListService.new(@owner, @project.identifier).call : []
+ return @branches = [] unless @project.forge?
+
+ result = Gitea::Repository::Branches::ListService.call(@owner, @project.identifier)
+ @branches = result.is_a?(Hash) && result.key?(:status) ? [] : result
end
def group_type_list
@@ -70,17 +89,19 @@ class ProjectsController < ApplicationController
def update
ActiveRecord::Base.transaction do
# Projects::CreateForm.new(project_params).validate!
- private = params[:private]
+ private = params[:private] || false
+
+ new_project_params = project_params.except(:private).merge(is_public: !private)
+ @project.update_attributes!(new_project_params)
gitea_params = {
private: private,
- default_branch: params[:default_branch]
+ default_branch: @project.default_branch,
+ website: @project.website
}
if [true, false].include? private
- new_project_params = project_params.merge(is_public: !private)
Gitea::Repository::UpdateService.call(@owner, @project.identifier, gitea_params)
@project.repository.update_column(:hidden, private)
end
- @project.update_attributes!(new_project_params)
end
rescue Exception => e
uid_logger_error(e.message)
@@ -91,7 +112,7 @@ class ProjectsController < ApplicationController
end
def destroy
- if current_user.admin? || @project.owner?(current_user)
+ if current_user.admin? || @project.manager?(current_user)
ActiveRecord::Base.transaction do
Gitea::Repository::DeleteService.new(@project.owner, @project.identifier).call
@project.destroy!
@@ -128,7 +149,7 @@ class ProjectsController < ApplicationController
end
def recommend
- @projects = Project.recommend.includes(:repository, :project_category, owner: :user_extension).limit(5)
+ @projects = Project.recommend.includes(:repository, :project_category, :owner).limit(5)
end
def about
@@ -162,8 +183,9 @@ class ProjectsController < ApplicationController
private
def project_params
- params.permit(:user_id, :name, :description, :repository_name,
- :project_category_id, :project_language_id, :license_id, :ignore_id, :private, :blockchain, :blockchain_token_all, :blockchain_init_token)
+ params.permit(:user_id, :name, :description, :repository_name, :website, :lesson_url,
+ :project_category_id, :project_language_id, :license_id, :ignore_id, :private,
+ :blockchain, :blockchain_token_all, :blockchain_init_token)
end
def mirror_params
diff --git a/app/controllers/pull_requests_controller.rb b/app/controllers/pull_requests_controller.rb
index 1bc12da4..4bd00532 100644
--- a/app/controllers/pull_requests_controller.rb
+++ b/app/controllers/pull_requests_controller.rb
@@ -8,6 +8,7 @@ class PullRequestsController < ApplicationController
def index
+ return render_not_found unless @project.has_menu_permission("pulls")
# @issues = Gitea::PullRequest::ListService.new(@user,@repository.try(:identifier)).call #通过gitea获取
issues = @project.issues.issue_pull_request.issue_index_includes.includes(pull_request: :user)
issues = issues.where(is_private: false) unless current_user.present? && (current_user.admin? || @project.member?(current_user))
@@ -98,8 +99,10 @@ class PullRequestsController < ApplicationController
if @issue.update_attributes(@issue_params)
if @pull_request.update_attributes(@local_params.compact)
- gitea_request = Gitea::PullRequest::UpdateService.new(@project.owner, @repository.try(:identifier), @requests_params, @pull_request.try(:gpid)).call
- if gitea_request
+ gitea_pull = Gitea::PullRequest::UpdateService.call(@owner.login, @repository.identifier,
+ @pull_request.gpid, @requests_params, current_user.gitea_token)
+
+ if gitea_pull[:status] === :success
if params[:issue_tag_ids].present?
params[:issue_tag_ids].each do |tag|
IssueTagsRelate.create(issue_id: @issue.id, issue_tag_id: tag)
@@ -128,19 +131,17 @@ class PullRequestsController < ApplicationController
def refuse_merge
ActiveRecord::Base.transaction do
begin
- @pull_request.update(status: 2)
- @pull_request.issue.update(status_id: 5)
-
+ colsed = PullRequests::CloseService.call(@owner, @repository, @pull_request, current_user)
+ colsed === true ? normal_status(1, "已拒绝") : normal_status(-1, '合并失败')
# author: zxh
# 调用上链API
- success_blockchain = push_activity_2_blockchain("pull_request_refuse", @pull_request)
- if success_blockchain == false
- normal_status(-1, "拒绝失败")
- raise ActiveRecord::Rollback
- else
- normal_status(1, "已拒绝")
- end
-
+ #success_blockchain = push_activity_2_blockchain("pull_request_refuse", @pull_request)
+ #if success_blockchain == false
+ # normal_status(-1, "拒绝失败")
+ # raise ActiveRecord::Rollback
+ #else
+ # normal_status(1, "已拒绝")
+ #end
rescue => e
normal_status(-1, e.message)
raise ActiveRecord::Rollback
@@ -159,22 +160,17 @@ class PullRequestsController < ApplicationController
end
def pr_merge
- return render_forbidden("你没有权限操作.") if @project.reporter?(current_user)
+ return render_forbidden("你没有权限操作.") unless current_user.project_manager?(@project)
if params[:do].blank?
normal_status(-1, "请选择合并方式")
else
ActiveRecord::Base.transaction do
begin
- requests_params = {
- Do: params[:do],
- MergeMessageField: params[:body],
- MergeTitleField: params[:title]
- }
- merge_pr = Gitea::PullRequest::MergeService.call(current_user.gitea_token, @project.owner.login,
- @repository.try(:identifier), @pull_request.try(:gpid), requests_params)
- if merge_pr.status.to_i == 200 && @pull_request.update_attribute(:status, 1)
- @pull_request&.project_trends&.update_all(action_type: "close")
+ result = PullRequests::MergeService.call(@owner, @repository, @pull_request, current_user, params)
+
+ if result && @pull_request.merge!
+ @pull_request.project_trend_status!
@issue&.custom_journal_detail("merge", "", "该合并请求已被合并", current_user&.id)
# author: zxh
@@ -254,12 +250,12 @@ class PullRequestsController < ApplicationController
def files
- @files_result = Gitea::PullRequest::FilesService.call(@owner.login, @project.identifier, @pull_request.gpid)
+ @files_result = Gitea::PullRequest::FilesService.call(@owner.login, @project.identifier, @pull_request.gpid, current_user&.gitea_token)
# render json: @files_result
end
def commits
- @commits_result = Gitea::PullRequest::CommitsService.call(@owner.login, @project.identifier, @pull_request.gpid)
+ @commits_result = Gitea::PullRequest::CommitsService.call(@owner.login, @project.identifier, @pull_request.gpid, current_user&.gitea_token)
# render json: @commits_result
end
@@ -295,7 +291,8 @@ class PullRequestsController < ApplicationController
}
@requests_params = @local_params.merge({
assignee: current_user.try(:login),
- assignees: ["#{params[:assigned_login].to_s}"],
+ # assignees: ["#{params[:assigned_login].to_s}"],
+ assignees: ["#{current_user.try(:login).to_s}"],
labels: params[:issue_tag_ids],
due_date: Time.now
})
diff --git a/app/controllers/repositories_controller.rb b/app/controllers/repositories_controller.rb
index b4d14228..10b352ae 100644
--- a/app/controllers/repositories_controller.rb
+++ b/app/controllers/repositories_controller.rb
@@ -1,15 +1,35 @@
class RepositoriesController < ApplicationController
include ApplicationHelper
include OperateProjectAbilityAble
+ include Repository::LanguagesPercentagable
before_action :require_login, only: %i[edit update create_file update_file delete_file sync_mirror]
before_action :load_repository
before_action :authorizate!, except: [:sync_mirror, :tags, :commit]
before_action :authorizate_user_can_edit_repo!, only: %i[sync_mirror]
- before_action :get_ref, only: %i[entries sub_entries top_counts]
+ before_action :get_ref, only: %i[entries sub_entries top_counts file]
before_action :get_latest_commit, only: %i[entries sub_entries top_counts]
before_action :get_statistics, only: %i[top_counts]
+ def files
+ result = @project.educoder? ? nil : Gitea::Repository::Files::GetService.call(@owner, @project.identifier, @ref, params[:search], @owner.gitea_token)
+ render json: result
+ end
+
+ # 新版项目详情
+ def detail
+ @user = current_user
+ @result = Repositories::DetailService.call(@owner, @repository, @user)
+ @project_fork_id = @project.try(:forked_from_project_id)
+ if @project_fork_id.present?
+ @fork_project = Project.find_by(id: @project_fork_id)
+ @fork_project_user = @fork_project.owner
+ end
+ rescue Exception => e
+ uid_logger_error(e.message)
+ tip_exception(e.message)
+ end
+
def show
@user = current_user
@repo = @project.repository
@@ -83,10 +103,17 @@ class RepositoriesController < ApplicationController
end
def tags
- @tags = Gitea::Repository::Tags::ListService.call(current_user&.gitea_token, @owner.login, @project.identifier, {page: params[:page], limit: params[:limit]})
+ result = Gitea::Repository::Tags::ListService.call(current_user&.gitea_token, @owner.login, @project.identifier, {page: params[:page], limit: params[:limit]})
+
+ @tags = result.is_a?(Hash) && result.key?(:status) ? [] : result
+ end
+
+ def contributors
+ @contributors = Gitea::Repository::Contributors::GetService.call(@owner, @repository.identifier)
end
def edit
+ return render_forbidden if !@project.manager?(current_user) && !current_user.admin?
end
def create_file
@@ -94,11 +121,22 @@ class RepositoriesController < ApplicationController
if interactor.success?
@file = interactor.result
# create_new_pr(params)
+ #如果是更新流水线文件
+ if params[:pipeline_id]
+ update_pipeline(params[:pipeline_id])
+ end
else
render_error(interactor.error)
end
end
+ def update_pipeline(pipeline_id)
+ pipeline = Ci::Pipeline.find(pipeline_id)
+ if pipeline
+ pipeline.update!(sync: 1)
+ end
+ end
+
def update_file
interactor = Gitea::UpdateFileInteractor.call(current_user.gitea_token, @owner.login, params.merge(identifier: @project.identifier))
if interactor.success?
@@ -133,6 +171,17 @@ class RepositoriesController < ApplicationController
render_ok
end
+ def readme
+ result = Gitea::Repository::Readme::GetService.call(@owner.login, @repository.identifier, params[:ref], current_user&.gitea_token)
+
+ @readme = result[:status] === :success ? result[:body] : nil
+ render json: @readme
+ end
+
+ def languages
+ render json: languages_precentagable
+ end
+
private
def find_project
@@ -163,7 +212,7 @@ class RepositoriesController < ApplicationController
end
def get_ref
- @ref = params[:ref] || "master"
+ @ref = params[:ref] || @project&.default_branch
end
def get_latest_commit
diff --git a/app/controllers/settings_controller.rb b/app/controllers/settings_controller.rb
index bb031c7b..b03edb1f 100644
--- a/app/controllers/settings_controller.rb
+++ b/app/controllers/settings_controller.rb
@@ -1,6 +1,65 @@
class SettingsController < ApplicationController
def show
- @old_projects_url = nil
- @old_projects_url = "https://www.trustie.net/users/#{current_user.try(:login)}/projects" if User.current.logged?
+ @old_projects_url = nil
+ get_add_menu
+ get_common_menu
+ get_personal_menu
+ get_third_party
end
+
+ private
+ def get_add_menu
+ @add = []
+ Site.add.select(:id, :name, :url, :key).to_a.map(&:serializable_hash).each do |site|
+ hash = {}
+ site.each {|k, v|
+ hash.merge!("#{k}": get_site_url(k, v))
+ }
+ @add << hash
+ end
+ end
+
+ def get_common_menu
+ @common = {}
+ Site.common.select(:url, :key).each do |site|
+ next if site["url"].to_s.include?("current_user") && !User.current.logged?
+ @common.merge!("#{site["key"]}": append_http(reset_site_url(site["url"])))
+ end
+ end
+
+ def get_personal_menu
+ @personal = []
+ if User.current.logged?
+ Site.personal.select(:id, :name, :url, :key).to_a.map(&:serializable_hash).each do |site|
+ hash = {}
+ site.each {|k, v|
+ hash.merge!("#{k}": get_site_url(k, v))
+ }
+ @personal << hash
+ end
+ end
+ end
+
+ def get_third_party
+ @third_party = []
+ @third_party << {
+ name: 'educoder',
+ url: EducoderOauth.oauth_url
+ }
+ end
+
+ def get_site_url(key, value)
+ key.to_s === "url" ? append_http(reset_site_url(value)) : reset_site_url(value)
+ end
+
+ def reset_site_url(url)
+ return url unless url.to_s.include?("current_user")
+
+ split_arr = url.split('current_user')
+ split_arr.length > 1 ? split_arr.join(current_user&.login) : (split_arr << current_user&.login).join('')
+ end
+
+ def append_http(url)
+ url.to_s.start_with?("http") ? url : [request.protocol, request.host_with_port, url].join('')
+ end
end
diff --git a/app/controllers/statistic_controller.rb b/app/controllers/statistic_controller.rb
new file mode 100644
index 00000000..6eaa5bc9
--- /dev/null
+++ b/app/controllers/statistic_controller.rb
@@ -0,0 +1,25 @@
+class StatisticController < ApplicationController
+
+ # 平台概况
+ def platform_profile
+ @platform_user_query = Statistic::PlatformUserQuery.new(params).call
+ @platform_project_query = Statistic::PlatformProjectQuery.new(params).call
+ @platform_course_query = Statistic::PlatformCourseQuery.new(params).call
+ end
+
+ # 平台代码提交数据
+ def platform_code
+ @platform_pull_request_query = Statistic::PlatformPullRequestQuery.new(params).call
+ @platform_commit_query = Statistic::PlatformCommitQuery.new(params,current_user).call
+ end
+
+ # 项目案例活跃度排行榜
+ def active_project_rank
+ @active_project_rank_query = Statistic::ActiveProjectRankQuery.new(params, current_user).call
+ end
+
+ # 开发者活跃度排行榜
+ def active_developer_rank
+ @active_developer_rank_query = Statistic::ActiveDeveloperRankQuery.new(params, current_user).call
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/users/organizations_controller.rb b/app/controllers/users/organizations_controller.rb
new file mode 100644
index 00000000..721339e8
--- /dev/null
+++ b/app/controllers/users/organizations_controller.rb
@@ -0,0 +1,25 @@
+class Users::OrganizationsController < Users::BaseController
+
+ def index
+ if current_user.logged?
+ logged_organizations_sql = observed_user.organizations.with_visibility(%w(common limited)).to_sql
+ privacy_organizations_sql = observed_user.organizations.with_visibility("privacy").joins(:organization_users).where(organization_users: {user_id: current_user.id}).to_sql
+ @organizations = Organization.from("( #{ logged_organizations_sql } UNION #{ privacy_organizations_sql } ) AS users")
+ else
+ @organizations = observed_user.organizations.with_visibility("common")
+ end
+
+ @organizations = @organizations.ransack(login_cont: params[:search]).result if params[:search].present?
+ @organizations = @organizations.includes(:organization_extension).order("organization_extensions.#{sort_by} #{sort_direction}")
+ @organizations = kaminari_paginate(@organizations)
+ end
+
+ private
+ def sort_by
+ params.fetch(:sort_by, "created_at")
+ end
+
+ def sort_direction
+ params.fetch(:sort_direction, "desc")
+ end
+end
\ No newline at end of file
diff --git a/app/controllers/users_controller.rb b/app/controllers/users_controller.rb
index 21acc500..4cd9d8e6 100644
--- a/app/controllers/users_controller.rb
+++ b/app/controllers/users_controller.rb
@@ -1,13 +1,24 @@
class UsersController < ApplicationController
+ include ApplicationHelper
include Ci::DbConnectable
- before_action :load_user, only: [:show, :homepage_info, :sync_token, :sync_gitea_pwd, :projects, :watch_users, :fan_users]
- before_action :check_user_exist, only: [:show, :homepage_info,:projects, :watch_users, :fan_users]
- before_action :require_login, only: %i[me list]
- before_action :connect_to_ci_database, only: :get_user_info, if: -> { current_user && !current_user.is_a?(AnonymousUser) && current_user.devops_certification? }
-
+ before_action :load_user, only: [:show, :homepage_info, :sync_token, :sync_gitea_pwd, :projects, :watch_users, :fan_users, :hovercard]
+ before_action :check_user_exist, only: [:show, :homepage_info,:projects, :watch_users, :fan_users, :hovercard]
+ before_action :require_login, only: %i[me list sync_user_info]
+ before_action :connect_to_ci_db, only: [:get_user_info]
skip_before_action :check_sign, only: [:attachment_show]
+ def connect_to_ci_db(options={})
+ if !(current_user && !current_user.is_a?(AnonymousUser) && current_user.devops_certification?)
+ return
+ end
+ if current_user.ci_cloud_account.server_type == Ci::CloudAccount::SERVER_TYPE_TRUSTIE
+ connect_to_trustie_ci_database(options)
+ else
+ connect_to_ci_database(options)
+ end
+ end
+
def list
scope = User.active.recent.like(params[:search]).includes(:user_extension)
@total_count = scope.size
@@ -20,6 +31,7 @@ class UsersController < ApplicationController
#用户的组织数量
# @user_composes_count = @user.composes.size
@user_composes_count = 0
+ @user_org_count = User.current.logged? ? @user.organizations.with_visibility(%w(common limited)).size + @user.organizations.with_visibility("privacy").joins(:organization_users).where(organization_users: {user_id: current_user.id}).size : @user.organizations.with_visibility("common").size
user_projects = User.current.logged? && (User.current.admin? || User.current.login == @user.login) ? @user.projects : @user.projects.visible
@projects_common_count = user_projects.common.size
@projects_mirrior_count = user_projects.mirror.size
@@ -44,6 +56,9 @@ class UsersController < ApplicationController
@watchers = paginate(watchers)
end
+ def hovercard
+ end
+
def update
@user = User.find params[:id]
@user.update!(user_params)
@@ -69,7 +84,7 @@ class UsersController < ApplicationController
def attachment_show
file_name = params[:file_name]
- path = params[:path] || edu_setting('attachment_folder')
+ path = params[:path] || file_storage_directory
send_file "#{path}/#{file_name}", :filename => "#{file_name}",
:type => 'game',
:disposition => 'attachment' #inline can open in browser
@@ -441,6 +456,26 @@ class UsersController < ApplicationController
render_ok
end
+ def sync_user_info
+ user = User.find_by_login params[:login]
+ return render_forbidden unless user === current_user
+
+ sync_params = {
+ email: params[:email],
+ password: params[:password]
+ }
+
+ Users::UpdateInfoForm.new(sync_params.merge(login: params[:login])).validate!
+
+ interactor = Gitea::User::UpdateInteractor.call(user.login, sync_params)
+ if interactor.success?
+ user.update!(password: params[:password], mail: params[:email], status: User::STATUS_ACTIVE)
+ render_ok
+ else
+ render_error(interactor.error)
+ end
+ end
+
private
def load_user
@user = User.find_by_login(params[:id]) || User.find_by(id: params[:id])
diff --git a/app/controllers/version_releases_controller.rb b/app/controllers/version_releases_controller.rb
index a9e7fa63..ac17c7d4 100644
--- a/app/controllers/version_releases_controller.rb
+++ b/app/controllers/version_releases_controller.rb
@@ -8,7 +8,7 @@ class VersionReleasesController < ApplicationController
version_releases = Gitea::Versions::ListService.new(@user.gitea_token, @user.try(:login), @repository.try(:identifier)).call
@version_releases = version_releases
@user_permission = current_user.present? && (current_user == @user || current_user.admin?)
- @forge_releases = @repository.version_releases.select(:id,:version_gid).includes(:attachments)
+ @forge_releases = @repository.version_releases.select(:id,:version_gid, :created_at).includes(:attachments)
end
def new
@@ -124,7 +124,7 @@ class VersionReleasesController < ApplicationController
private
def set_user
- @user = @repository.user
+ @user = @repository.owner
end
def find_version
diff --git a/app/controllers/versions_controller.rb b/app/controllers/versions_controller.rb
index 5ec769e9..02700fdf 100644
--- a/app/controllers/versions_controller.rb
+++ b/app/controllers/versions_controller.rb
@@ -5,6 +5,7 @@ class VersionsController < ApplicationController
before_action :set_version, only: [:edit, :update, :destroy, :show,:update_status]
def index
+ return render_not_found unless @project.has_menu_permission("versions")
@user_admin_or_member = current_user.present? && (current_user.admin || @project.member?(current_user))
order_name = params[:order_name] || "created_on"
order_type = params[:order_type] || "desc"
diff --git a/app/docs/slate/.dockerignore b/app/docs/slate/.dockerignore
new file mode 100644
index 00000000..1cf06112
--- /dev/null
+++ b/app/docs/slate/.dockerignore
@@ -0,0 +1,2 @@
+build/
+.github/
diff --git a/app/docs/slate/.editorconfig b/app/docs/slate/.editorconfig
new file mode 100644
index 00000000..1692977c
--- /dev/null
+++ b/app/docs/slate/.editorconfig
@@ -0,0 +1,18 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# Top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.rb]
+charset = utf-8
+
+[*.md]
+trim_trailing_whitespace = false
diff --git a/app/docs/slate/.gitattributes b/app/docs/slate/.gitattributes
new file mode 100644
index 00000000..3069c432
--- /dev/null
+++ b/app/docs/slate/.gitattributes
@@ -0,0 +1 @@
+source/javascripts/lib/* linguist-vendored
diff --git a/app/docs/slate/.github/ISSUE_TEMPLATE/bug.md b/app/docs/slate/.github/ISSUE_TEMPLATE/bug.md
new file mode 100644
index 00000000..25fcdb1d
--- /dev/null
+++ b/app/docs/slate/.github/ISSUE_TEMPLATE/bug.md
@@ -0,0 +1,22 @@
+---
+name: Report a Bug
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Bug Description**
+A clear and concise description of what the bug is and how to reproduce it.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Browser (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Last upstream Slate commit (run `git log --author="Robert Lord" | head -n 1`):**
+Put the commit hash here
diff --git a/app/docs/slate/.github/ISSUE_TEMPLATE/config.yml b/app/docs/slate/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..16f4beed
--- /dev/null
+++ b/app/docs/slate/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+ - name: Questions, Ideas, Discussions
+ url: https://github.com/slatedocs/slate/discussions
+ about: Ask and answer questions, and propose new features.
diff --git a/app/docs/slate/.github/PULL_REQUEST_TEMPLATE.md b/app/docs/slate/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 00000000..151e45d7
--- /dev/null
+++ b/app/docs/slate/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,5 @@
+
\ No newline at end of file
diff --git a/app/docs/slate/.github/workflows/build.yml b/app/docs/slate/.github/workflows/build.yml
new file mode 100644
index 00000000..c9ec0ecc
--- /dev/null
+++ b/app/docs/slate/.github/workflows/build.yml
@@ -0,0 +1,42 @@
+name: Build
+
+on:
+ push:
+ branches: [ '*' ]
+ pull_request:
+ branches: [ '*' ]
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+
+ strategy:
+ matrix:
+ ruby-version: [2.3, 2.4, 2.5, 2.6, 2.7]
+
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: ${{ matrix.ruby-version }}
+
+ - uses: actions/cache@v2
+ with:
+ path: vendor/bundle
+ key: gems-${{ runner.os }}-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
+ restore-keys: |
+ gems-${{ runner.os }}-${{ matrix.ruby-version }}-
+ gems-${{ runner.os }}-
+
+ # necessary to get ruby 2.3 to work nicely with bundler vendor/bundle cache
+ # can remove once ruby 2.3 is no longer supported
+ - run: gem update --system
+
+ - run: bundle config set deployment 'true'
+ - name: bundle install
+ run: |
+ bundle config path vendor/bundle
+ bundle install --jobs 4 --retry 3
+
+ - run: bundle exec middleman build
diff --git a/app/docs/slate/.github/workflows/deploy.yml b/app/docs/slate/.github/workflows/deploy.yml
new file mode 100644
index 00000000..341cd5f7
--- /dev/null
+++ b/app/docs/slate/.github/workflows/deploy.yml
@@ -0,0 +1,41 @@
+name: Deploy
+
+on:
+ push:
+ branches: [ 'main' ]
+
+jobs:
+ deploy:
+ runs-on: ubuntu-latest
+ env:
+ ruby-version: 2.5
+
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: ${{ env.ruby-version }}
+
+ - uses: actions/cache@v2
+ with:
+ path: vendor/bundle
+ key: gems-${{ runner.os }}-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
+ restore-keys: |
+ gems-${{ runner.os }}-${{ matrix.ruby-version }}-
+ gems-${{ runner.os }}-
+
+ - run: bundle config set deployment 'true'
+ - name: bundle install
+ run: |
+ bundle config path vendor/bundle
+ bundle install --jobs 4 --retry 3
+
+ - run: bundle exec middleman build
+
+ - name: Deploy
+ uses: peaceiris/actions-gh-pages@v3
+ with:
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+ publish_dir: ./build
+ keep_files: true
diff --git a/app/docs/slate/.github/workflows/dev_deploy.yml b/app/docs/slate/.github/workflows/dev_deploy.yml
new file mode 100644
index 00000000..7f1a40ab
--- /dev/null
+++ b/app/docs/slate/.github/workflows/dev_deploy.yml
@@ -0,0 +1,50 @@
+name: Dev Deploy
+
+on:
+ push:
+ branches: [ 'dev' ]
+
+jobs:
+ deploy:
+ runs-on: ubuntu-latest
+ env:
+ ruby-version: 2.5
+
+ steps:
+ - uses: actions/checkout@v2
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@v1
+ with:
+ ruby-version: ${{ env.ruby-version }}
+
+ - uses: actions/cache@v2
+ with:
+ path: vendor/bundle
+ key: gems-${{ runner.os }}-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
+ restore-keys: |
+ gems-${{ runner.os }}-${{ matrix.ruby-version }}-
+ gems-${{ runner.os }}-
+
+ - run: bundle config set deployment 'true'
+ - name: bundle install
+ run: |
+ bundle config path vendor/bundle
+ bundle install --jobs 4 --retry 3
+
+ - run: bundle exec middleman build
+
+ - name: Push to Docker Hub
+ uses: docker/build-push-action@v1
+ with:
+ username: ${{ secrets.DOCKER_USERNAME }}
+ password: ${{ secrets.DOCKER_ACCESS_KEY }}
+ repository: slatedocs/slate
+ tag_with_ref: true
+
+ - name: Deploy
+ uses: peaceiris/actions-gh-pages@v3.7.0-8
+ with:
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+ destination_dir: dev
+ publish_dir: ./build
+ keep_files: true
diff --git a/app/docs/slate/.github/workflows/publish.yml b/app/docs/slate/.github/workflows/publish.yml
new file mode 100644
index 00000000..d57930a5
--- /dev/null
+++ b/app/docs/slate/.github/workflows/publish.yml
@@ -0,0 +1,22 @@
+name: Publish Docker image
+
+on:
+ release:
+ types: [published]
+
+jobs:
+ push_to_registry:
+ name: Push Docker image to Docker Hub
+ runs-on: ubuntu-latest
+ steps:
+ - name: Check out the repo
+ uses: actions/checkout@v2
+
+ - name: Push to Docker Hub
+ uses: docker/build-push-action@v1
+ with:
+ username: ${{ secrets.DOCKER_USERNAME }}
+ password: ${{ secrets.DOCKER_ACCESS_KEY }}
+ repository: slatedocs/slate
+ tag_with_ref: true
+ tags: latest
diff --git a/app/docs/slate/.gitignore b/app/docs/slate/.gitignore
new file mode 100644
index 00000000..1d5d08dd
--- /dev/null
+++ b/app/docs/slate/.gitignore
@@ -0,0 +1,27 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.DS_STORE
+build/
+.cache
+.vagrant
+.sass-cache
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+.idea/
+
+# Vagrant artifacts
+ubuntu-*-console.log
diff --git a/app/docs/slate/CHANGELOG.md b/app/docs/slate/CHANGELOG.md
new file mode 100644
index 00000000..1ffe3eb8
--- /dev/null
+++ b/app/docs/slate/CHANGELOG.md
@@ -0,0 +1,254 @@
+# Changelog
+
+## Version 2.8.0
+
+*October 27, 2020*
+
+* Remove last trailing newline when using the copy code button
+* Rework docker image and make available at slatedocs/slate
+* Improve Dockerfile layout to improve caching (thanks @micvbang)
+* Bump rouge from 3.20 to 3.24
+* Bump nokogiri from 1.10.9 to 1.10.10
+* Bump middleman from 4.3.8 to 4.3.11
+* Bump lunr.js from 2.3.8 to 2.3.9
+
+## Version 2.7.1
+
+*August 13, 2020*
+
+* __[security]__ Bumped middleman from 4.3.7 to 4.3.8
+
+_Note_: Slate uses redcarpet, not kramdown, for rendering markdown to HTML, and so was unaffected by the security vulnerability in middleman.
+If you have changed slate to use kramdown, and with GFM, you may need to install the `kramdown-parser-gfm` gem.
+
+## Version 2.7.0
+
+*June 21, 2020*
+
+* __[security]__ Bumped rack in Gemfile.lock from 2.2.2 to 2.2.3
+* Bumped bundled jQuery from 3.2.1 to 3.5.1
+* Bumped bundled lunr from 0.5.7 to 2.3.8
+* Bumped imagesloaded from 3.1.8 to 4.1.4
+* Bumped rouge from 3.17.0 to 3.20.0
+* Bumped redcarpet from 3.4.0 to 3.5.0
+* Fix color of highlighted code being unreadable when printing page
+* Add clipboard icon for "Copy to Clipboard" functionality to code boxes (see note below)
+* Fix handling of ToC selectors that contain punctutation (thanks @gruis)
+* Fix language bar truncating languages that overflow screen width
+* Strip HTML tags from ToC title before displaying it in title bar in JS (backup to stripping done in Ruby code) (thanks @atic)
+
+To enable the new clipboard icon, you need to add `code_clipboard: true` to the frontmatter of source/index.html.md.
+See [this line](https://github.com/slatedocs/slate/blame/main/source/index.html.md#L19) for an example of usage.
+
+## Version 2.6.1
+
+*May 30, 2020*
+
+* __[security]__ update child dependency activesupport in Gemfile.lock to 5.4.2.3
+* Update Middleman in Gemfile.lock to 4.3.7
+* Replace Travis-CI with GitHub actions for continuous integration
+* Replace Spectrum with GitHub discussions
+
+## Version 2.6.0
+
+*May 18, 2020*
+
+__Note__: 2.5.0 was "pulled" due to a breaking bug discovered after release. It is recommended to skip it, and move straight to 2.6.0.
+
+* Fix large whitespace gap in middle column for sections with codeblocks
+* Fix highlighted code elements having a different background than rest of code block
+* Change JSON keys to have a different font color than their values
+* Disable asset hashing for woff and woff2 elements due to middleman bug breaking woff2 asset hashing in general
+* Move Dockerfile to Debian from Alpine
+* Converted repo to a [GitHub template](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)
+* Update sassc to 2.3.0 in Gemfile.lock
+
+## Version 2.5.0
+
+*May 8, 2020*
+
+* __[security]__ update nokogiri to ~> 1.10.8
+* Update links in example docs to https://github.com/slatedocs/slate from https://github.com/lord/slate
+* Update LICENSE to include full Apache 2.0 text
+* Test slate against Ruby 2.5 and 2.6 on Travis-CI
+* Update Vagrantfile to use Ubuntu 18.04 (thanks @bradthurber)
+* Parse arguments and flags for deploy.sh on script start, instead of potentially after building source files
+* Install nodejs inside Vagrantfile (thanks @fernandoaguilar)
+* Add Dockerfile for running slate (thanks @redhatxl)
+* update middleman-syntax and rouge to ~>3.2
+* update middleman to 4.3.6
+
+## Version 2.4.0
+
+*October 19, 2019*
+
+- Move repository from lord/slate to slatedocs/slate
+- Fix documentation to point at new repo link, thanks to [Arun](https://github.com/slash-arun), [Gustavo Gawryszewski](https://github.com/gawry), and [Daniel Korbit](https://github.com/danielkorbit)
+- Update `nokogiri` to 1.10.4
+- Update `ffi` in `Gemfile.lock` to fix security warnings, thanks to [Grey Baker](https://github.com/greysteil) and [jakemack](https://github.com/jakemack)
+- Update `rack` to 2.0.7 in `Gemfile.lock` to fix security warnings, thanks to [Grey Baker](https://github.com/greysteil) and [jakemack](https://github.com/jakemack)
+- Update middleman to `4.3` and relax constraints on middleman related gems, thanks to [jakemack](https://github.com/jakemack)
+- Add sass gem, thanks to [jakemack](https://github.com/jakemack)
+- Activate `asset_cache` in middleman to improve cacheability of static files, thanks to [Sam Gilman](https://github.com/thenengah)
+- Update to using bundler 2 for `Gemfile.lock`, thanks to [jakemack](https://github.com/jakemack)
+
+## Version 2.3.1
+
+*July 5, 2018*
+
+- Update `sprockets` in `Gemfile.lock` to fix security warnings
+
+## Version 2.3
+
+*July 5, 2018*
+
+- Allows strikethrough in markdown by default.
+- Upgrades jQuery to 3.2.1, thanks to [Tomi Takussaari](https://github.com/TomiTakussaari)
+- Fixes invalid HTML in `layout.erb`, thanks to [Eric Scouten](https://github.com/scouten) for pointing out
+- Hopefully fixes Vagrant memory issues, thanks to [Petter Blomberg](https://github.com/p-blomberg) for the suggestion
+- Cleans HTML in headers before setting `document.title`, thanks to [Dan Levy](https://github.com/justsml)
+- Allows trailing whitespace in markdown files, thanks to [Samuel Cousin](https://github.com/kuzyn)
+- Fixes pushState/replaceState problems with scrolling not changing the document hash, thanks to [Andrey Fedorov](https://github.com/anfedorov)
+- Removes some outdated examples, thanks [@al-tr](https://github.com/al-tr), [Jerome Dahdah](https://github.com/jdahdah), and [Ricardo Castro](https://github.com/mccricardo)
+- Fixes `nav-padding` bug, thanks [Jerome Dahdah](https://github.com/jdahdah)
+- Code style fixes thanks to [Sebastian Zaremba](https://github.com/vassyz)
+- Nokogiri version bump thanks to [Grey Baker](https://github.com/greysteil)
+- Fix to default `index.md` text thanks to [Nick Busey](https://github.com/NickBusey)
+
+Thanks to everyone who contributed to this release!
+
+## Version 2.2
+
+*January 19, 2018*
+
+- Fixes bugs with some non-roman languages not generating unique headers
+- Adds editorconfig, thanks to [Jay Thomas](https://github.com/jaythomas)
+- Adds optional `NestingUniqueHeadCounter`, thanks to [Vladimir Morozov](https://github.com/greenhost87)
+- Small fixes to typos and language, thx [Emir Ribić](https://github.com/ribice), [Gregor Martynus](https://github.com/gr2m), and [Martius](https://github.com/martiuslim)!
+- Adds links to Spectrum chat for questions in README and ISSUE_TEMPLATE
+
+## Version 2.1
+
+*October 30, 2017*
+
+- Right-to-left text stylesheet option, thanks to [Mohammad Hossein Rabiee](https://github.com/mhrabiee)
+- Fix for HTML5 history state bug, thanks to [Zach Toolson](https://github.com/ztoolson)
+- Small styling changes, typo fixes, small bug fixes from [Marian Friedmann](https://github.com/rnarian), [Ben Wilhelm](https://github.com/benwilhelm), [Fouad Matin](https://github.com/fouad), [Nicolas Bonduel](https://github.com/NicolasBonduel), [Christian Oliff](https://github.com/coliff)
+
+Thanks to everyone who submitted PRs for this version!
+
+## Version 2.0
+
+*July 17, 2017*
+
+- All-new statically generated table of contents
+ - Should be much faster loading and scrolling for large pages
+ - Smaller Javascript file sizes
+ - Avoids the problem with the last link in the ToC not ever highlighting if the section was shorter than the page
+ - Fixes control-click not opening in a new page
+ - Automatically updates the HTML title as you scroll
+- Updated design
+ - New default colors!
+ - New spacings and sizes!
+ - System-default typefaces, just like GitHub
+- Added search input delay on large corpuses to reduce lag
+- We even bumped the major version cause hey, why not?
+- Various small bug fixes
+
+Thanks to everyone who helped debug or wrote code for this version! It was a serious community effort, and I couldn't have done it alone.
+
+## Version 1.5
+
+*February 23, 2017*
+
+- Add [multiple tabs per programming language](https://github.com/lord/slate/wiki/Multiple-language-tabs-per-programming-language) feature
+- Upgrade Middleman to add Ruby 1.4.0 compatibility
+- Switch default code highlighting color scheme to better highlight JSON
+- Various small typo and bug fixes
+
+## Version 1.4
+
+*November 24, 2016*
+
+- Upgrade Middleman and Rouge gems, should hopefully solve a number of bugs
+- Update some links in README
+- Fix broken Vagrant startup script
+- Fix some problems with deploy.sh help message
+- Fix bug with language tabs not hiding properly if no error
+- Add `!default` to SASS variables
+- Fix bug with logo margin
+- Bump tested Ruby versions in .travis.yml
+
+## Version 1.3.3
+
+*June 11, 2016*
+
+Documentation and example changes.
+
+## Version 1.3.2
+
+*February 3, 2016*
+
+A small bugfix for slightly incorrect background colors on code samples in some cases.
+
+## Version 1.3.1
+
+*January 31, 2016*
+
+A small bugfix for incorrect whitespace in code blocks.
+
+## Version 1.3
+
+*January 27, 2016*
+
+We've upgraded Middleman and a number of other dependencies, which should fix quite a few bugs.
+
+Instead of `rake build` and `rake deploy`, you should now run `bundle exec middleman build --clean` to build your server, and `./deploy.sh` to deploy it to Github Pages.
+
+## Version 1.2
+
+*June 20, 2015*
+
+**Fixes:**
+
+- Remove crash on invalid languages
+- Update Tocify to scroll to the highlighted header in the Table of Contents
+- Fix variable leak and update search algorithms
+- Update Python examples to be valid Python
+- Update gems
+- More misc. bugfixes of Javascript errors
+- Add Dockerfile
+- Remove unused gems
+- Optimize images, fonts, and generated asset files
+- Add chinese font support
+- Remove RedCarpet header ID patch
+- Update language tabs to not disturb existing query strings
+
+## Version 1.1
+
+*July 27, 2014*
+
+**Fixes:**
+
+- Finally, a fix for the redcarpet upgrade bug
+
+## Version 1.0
+
+*July 2, 2014*
+
+[View Issues](https://github.com/tripit/slate/issues?milestone=1&state=closed)
+
+**Features:**
+
+- Responsive designs for phones and tablets
+- Started tagging versions
+
+**Fixes:**
+
+- Fixed 'unrecognized expression' error
+- Fixed #undefined hash bug
+- Fixed bug where the current language tab would be unselected
+- Fixed bug where tocify wouldn't highlight the current section while searching
+- Fixed bug where ids of header tags would have special characters that caused problems
+- Updated layout so that pages with disabled search wouldn't load search.js
+- Cleaned up Javascript
diff --git a/app/docs/slate/CODE_OF_CONDUCT.md b/app/docs/slate/CODE_OF_CONDUCT.md
new file mode 100644
index 00000000..cc17fd98
--- /dev/null
+++ b/app/docs/slate/CODE_OF_CONDUCT.md
@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at hello@lord.io. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/
diff --git a/app/docs/slate/Gemfile b/app/docs/slate/Gemfile
new file mode 100644
index 00000000..9a318414
--- /dev/null
+++ b/app/docs/slate/Gemfile
@@ -0,0 +1,12 @@
+ruby '>=2.3.1'
+source 'https://gems.ruby-china.com'
+
+# Middleman
+gem 'middleman', '~>4.3'
+gem 'middleman-syntax', '~> 3.2'
+gem 'middleman-autoprefixer', '~> 2.7'
+gem 'middleman-sprockets', '~> 4.1'
+gem 'rouge', '~> 3.21'
+gem 'redcarpet', '~> 3.5.0'
+gem 'nokogiri', '~> 1.10.8'
+gem 'sass'
diff --git a/app/docs/slate/Gemfile.lock b/app/docs/slate/Gemfile.lock
new file mode 100644
index 00000000..44028888
--- /dev/null
+++ b/app/docs/slate/Gemfile.lock
@@ -0,0 +1,136 @@
+GEM
+ remote: https://gems.ruby-china.com/
+ specs:
+ activesupport (5.2.4.4)
+ concurrent-ruby (~> 1.0, >= 1.0.2)
+ i18n (>= 0.7, < 2)
+ minitest (~> 5.1)
+ tzinfo (~> 1.1)
+ addressable (2.7.0)
+ public_suffix (>= 2.0.2, < 5.0)
+ autoprefixer-rails (9.5.1.1)
+ execjs
+ backports (3.18.2)
+ coffee-script (2.4.1)
+ coffee-script-source
+ execjs
+ coffee-script-source (1.12.2)
+ concurrent-ruby (1.1.7)
+ contracts (0.13.0)
+ dotenv (2.7.6)
+ erubis (2.7.0)
+ execjs (2.7.0)
+ fast_blank (1.0.0)
+ fastimage (2.2.0)
+ ffi (1.13.1)
+ haml (5.1.2)
+ temple (>= 0.8.0)
+ tilt
+ hamster (3.0.0)
+ concurrent-ruby (~> 1.0)
+ hashie (3.6.0)
+ i18n (0.9.5)
+ concurrent-ruby (~> 1.0)
+ kramdown (2.3.0)
+ rexml
+ listen (3.0.8)
+ rb-fsevent (~> 0.9, >= 0.9.4)
+ rb-inotify (~> 0.9, >= 0.9.7)
+ memoist (0.16.2)
+ middleman (4.3.11)
+ coffee-script (~> 2.2)
+ haml (>= 4.0.5)
+ kramdown (>= 2.3.0)
+ middleman-cli (= 4.3.11)
+ middleman-core (= 4.3.11)
+ middleman-autoprefixer (2.10.1)
+ autoprefixer-rails (~> 9.1)
+ middleman-core (>= 3.3.3)
+ middleman-cli (4.3.11)
+ thor (>= 0.17.0, < 2.0)
+ middleman-core (4.3.11)
+ activesupport (>= 4.2, < 6.0)
+ addressable (~> 2.3)
+ backports (~> 3.6)
+ bundler
+ contracts (~> 0.13.0)
+ dotenv
+ erubis
+ execjs (~> 2.0)
+ fast_blank
+ fastimage (~> 2.0)
+ hamster (~> 3.0)
+ hashie (~> 3.4)
+ i18n (~> 0.9.0)
+ listen (~> 3.0.0)
+ memoist (~> 0.14)
+ padrino-helpers (~> 0.13.0)
+ parallel
+ rack (>= 1.4.5, < 3)
+ sassc (~> 2.0)
+ servolux
+ tilt (~> 2.0.9)
+ uglifier (~> 3.0)
+ middleman-sprockets (4.1.1)
+ middleman-core (~> 4.0)
+ sprockets (>= 3.0)
+ middleman-syntax (3.2.0)
+ middleman-core (>= 3.2)
+ rouge (~> 3.2)
+ mini_portile2 (2.4.0)
+ minitest (5.14.2)
+ nokogiri (1.10.10)
+ mini_portile2 (~> 2.4.0)
+ padrino-helpers (0.13.3.4)
+ i18n (~> 0.6, >= 0.6.7)
+ padrino-support (= 0.13.3.4)
+ tilt (>= 1.4.1, < 3)
+ padrino-support (0.13.3.4)
+ activesupport (>= 3.1)
+ parallel (1.19.2)
+ public_suffix (4.0.6)
+ rack (2.2.3)
+ rb-fsevent (0.10.4)
+ rb-inotify (0.10.1)
+ ffi (~> 1.0)
+ redcarpet (3.5.0)
+ rexml (3.2.4)
+ rouge (3.24.0)
+ sass (3.7.4)
+ sass-listen (~> 4.0.0)
+ sass-listen (4.0.0)
+ rb-fsevent (~> 0.9, >= 0.9.4)
+ rb-inotify (~> 0.9, >= 0.9.7)
+ sassc (2.4.0)
+ ffi (~> 1.9)
+ servolux (0.13.0)
+ sprockets (3.7.2)
+ concurrent-ruby (~> 1.0)
+ rack (> 1, < 3)
+ temple (0.8.2)
+ thor (1.0.1)
+ thread_safe (0.3.6)
+ tilt (2.0.10)
+ tzinfo (1.2.7)
+ thread_safe (~> 0.1)
+ uglifier (3.2.0)
+ execjs (>= 0.3.0, < 3)
+
+PLATFORMS
+ ruby
+
+DEPENDENCIES
+ middleman (~> 4.3)
+ middleman-autoprefixer (~> 2.7)
+ middleman-sprockets (~> 4.1)
+ middleman-syntax (~> 3.2)
+ nokogiri (~> 1.10.8)
+ redcarpet (~> 3.5.0)
+ rouge (~> 3.21)
+ sass
+
+RUBY VERSION
+ ruby 2.3.3p222
+
+BUNDLED WITH
+ 2.1.4
diff --git a/app/docs/slate/LICENSE b/app/docs/slate/LICENSE
new file mode 100644
index 00000000..261eeb9e
--- /dev/null
+++ b/app/docs/slate/LICENSE
@@ -0,0 +1,201 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/app/docs/slate/README.md b/app/docs/slate/README.md
new file mode 100644
index 00000000..7d15f864
--- /dev/null
+++ b/app/docs/slate/README.md
@@ -0,0 +1,81 @@
+
+
+
+
+
+
+Slate helps you create beautiful, intelligent, responsive API documentation.
+
+
+
+The example above was created with Slate. Check it out at slatedocs.github.io/slate.
+
+Features
+------------
+
+* **Clean, intuitive design** — With Slate, the description of your API is on the left side of your documentation, and all the code examples are on the right side. Inspired by [Stripe's](https://stripe.com/docs/api) and [PayPal's](https://developer.paypal.com/webapps/developer/docs/api/) API docs. Slate is responsive, so it looks great on tablets, phones, and even in print.
+
+* **Everything on a single page** — Gone are the days when your users had to search through a million pages to find what they wanted. Slate puts the entire documentation on a single page. We haven't sacrificed linkability, though. As you scroll, your browser's hash will update to the nearest header, so linking to a particular point in the documentation is still natural and easy.
+
+* **Slate is just Markdown** — When you write docs with Slate, you're just writing Markdown, which makes it simple to edit and understand. Everything is written in Markdown — even the code samples are just Markdown code blocks.
+
+* **Write code samples in multiple languages** — If your API has bindings in multiple programming languages, you can easily put in tabs to switch between them. In your document, you'll distinguish different languages by specifying the language name at the top of each code block, just like with GitHub Flavored Markdown.
+
+* **Out-of-the-box syntax highlighting** for [over 100 languages](https://github.com/jneen/rouge/wiki/List-of-supported-languages-and-lexers), no configuration required.
+
+* **Automatic, smoothly scrolling table of contents** on the far left of the page. As you scroll, it displays your current position in the document. It's fast, too. We're using Slate at TripIt to build documentation for our new API, where our table of contents has over 180 entries. We've made sure that the performance remains excellent, even for larger documents.
+
+* **Let your users update your documentation for you** — By default, your Slate-generated documentation is hosted in a public GitHub repository. Not only does this mean you get free hosting for your docs with GitHub Pages, but it also makes it simple for other developers to make pull requests to your docs if they find typos or other problems. Of course, if you don't want to use GitHub, you're also welcome to host your docs elsewhere.
+
+* **RTL Support** Full right-to-left layout for RTL languages such as Arabic, Persian (Farsi), Hebrew etc.
+
+Getting started with Slate is super easy! Simply press the green "use this template" button above and follow the instructions below. Or, if you'd like to check out what Slate is capable of, take a look at the [sample docs](https://slatedocs.github.io/slate/).
+
+Getting Started with Slate
+------------------------------
+
+To get started with Slate, please check out the [Getting Started](https://github.com/slatedocs/slate/wiki#getting-started)
+section in our [wiki](https://github.com/slatedocs/slate/wiki).
+
+We support running Slate in three different ways:
+* [Natively](https://github.com/slatedocs/slate/wiki/Using-Slate-Natively)
+* [Using Vagrant](https://github.com/slatedocs/slate/wiki/Using-Slate-in-Vagrant)
+* [Using Docker](https://github.com/slatedocs/slate/wiki/Using-Slate-in-Docker)
+
+Companies Using Slate
+---------------------------------
+
+* [NASA](https://api.nasa.gov)
+* [Sony](http://developers.cimediacloud.com)
+* [Best Buy](https://bestbuyapis.github.io/api-documentation/)
+* [Travis-CI](https://docs.travis-ci.com/api/)
+* [Greenhouse](https://developers.greenhouse.io/harvest.html)
+* [WooCommerce](http://woocommerce.github.io/woocommerce-rest-api-docs/)
+* [Dwolla](https://docs.dwolla.com/)
+* [Clearbit](https://clearbit.com/docs)
+* [Coinbase](https://developers.coinbase.com/api)
+* [Parrot Drones](http://developer.parrot.com/docs/bebop/)
+* [Scale](https://docs.scaleapi.com/)
+
+You can view more in [the list on the wiki](https://github.com/slatedocs/slate/wiki/Slate-in-the-Wild).
+
+Questions? Need Help? Found a bug?
+--------------------
+
+If you've got questions about setup, deploying, special feature implementation in your fork, or just want to chat with the developer, please feel free to [start a thread in our Discussions tab](https://github.com/slatedocs/slate/discussions)!
+
+Found a bug with upstream Slate? Go ahead and [submit an issue](https://github.com/slatedocs/slate/issues). And, of course, feel free to submit pull requests with bug fixes or changes to the `dev` branch.
+
+Contributors
+--------------------
+
+Slate was built by [Robert Lord](https://lord.io) while at [TripIt](https://www.tripit.com/). The project is now maintained by [Matthew Peveler](https://github.com/MasterOdin) and [Mike Ralphson](https://github.com/MikeRalphson).
+
+Thanks to the following people who have submitted major pull requests:
+
+- [@chrissrogers](https://github.com/chrissrogers)
+- [@bootstraponline](https://github.com/bootstraponline)
+- [@realityking](https://github.com/realityking)
+- [@cvkef](https://github.com/cvkef)
+
+Also, thanks to [Sauce Labs](http://saucelabs.com) for sponsoring the development of the responsive styles.
diff --git a/app/docs/slate/Vagrantfile b/app/docs/slate/Vagrantfile
new file mode 100644
index 00000000..4166fb6b
--- /dev/null
+++ b/app/docs/slate/Vagrantfile
@@ -0,0 +1,46 @@
+Vagrant.configure(2) do |config|
+ config.vm.box = "ubuntu/bionic64"
+ config.vm.network :forwarded_port, guest: 4567, host: 4567
+ config.vm.provider "virtualbox" do |vb|
+ vb.memory = "2048"
+ end
+
+ config.vm.provision "bootstrap",
+ type: "shell",
+ inline: <<-SHELL
+ # add nodejs v12 repository
+ curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
+
+ sudo apt-get update
+ sudo apt-get install -yq ruby ruby-dev
+ sudo apt-get install -yq pkg-config build-essential nodejs git libxml2-dev libxslt-dev
+ sudo apt-get autoremove -yq
+ gem install --no-ri --no-rdoc bundler
+ SHELL
+
+ # add the local user git config to the vm
+ config.vm.provision "file", source: "~/.gitconfig", destination: ".gitconfig"
+
+ config.vm.provision "install",
+ type: "shell",
+ privileged: false,
+ inline: <<-SHELL
+ echo "=============================================="
+ echo "Installing app dependencies"
+ cd /vagrant
+ bundle config build.nokogiri --use-system-libraries
+ bundle install
+ SHELL
+
+ config.vm.provision "run",
+ type: "shell",
+ privileged: false,
+ run: "always",
+ inline: <<-SHELL
+ echo "=============================================="
+ echo "Starting up middleman at http://localhost:4567"
+ echo "If it does not come up, check the ~/middleman.log file for any error messages"
+ cd /vagrant
+ bundle exec middleman server --watcher-force-polling --watcher-latency=1 &> ~/middleman.log &
+ SHELL
+end
diff --git a/app/docs/slate/config.rb b/app/docs/slate/config.rb
new file mode 100644
index 00000000..4c51315d
--- /dev/null
+++ b/app/docs/slate/config.rb
@@ -0,0 +1,65 @@
+set :build_dir, '../../../public/docs/'
+
+# Unique header generation
+require './lib/unique_head.rb'
+
+# Markdown
+set :markdown_engine, :redcarpet
+set :markdown,
+ fenced_code_blocks: true,
+ smartypants: true,
+ disable_indented_code_blocks: true,
+ prettify: true,
+ strikethrough: true,
+ tables: true,
+ with_toc_data: true,
+ no_intra_emphasis: true,
+ renderer: UniqueHeadCounter
+
+# Assets
+set :css_dir, 'stylesheets'
+set :js_dir, 'javascripts'
+set :images_dir, 'images'
+set :fonts_dir, 'fonts'
+
+# Activate the syntax highlighter
+activate :syntax
+ready do
+ require './lib/monokai_sublime_slate.rb'
+ require './lib/multilang.rb'
+end
+
+activate :sprockets
+
+activate :autoprefixer do |config|
+ config.browsers = ['last 2 version', 'Firefox ESR']
+ config.cascade = false
+ config.inline = true
+end
+
+# Github pages require relative links
+activate :relative_assets
+set :relative_links, true
+
+# Build Configuration
+configure :build do
+ # We do want to hash woff and woff2 as there's a bug where woff2 will use
+ # woff asset hash which breaks things. Trying to use a combination of ignore and
+ # rewrite_ignore does not work as it conflicts weirdly with relative_assets. Disabling
+ # the .woff2 extension only does not work as .woff will still activate it so have to
+ # have both. See https://github.com/slatedocs/slate/issues/1171 for more details.
+ activate :asset_hash, :exts => app.config[:asset_extensions] - %w[.woff .woff2]
+ # If you're having trouble with Middleman hanging, commenting
+ # out the following two lines has been known to help
+ activate :minify_css
+ activate :minify_javascript
+ # activate :gzip
+end
+
+# Deploy Configuration
+# If you want Middleman to listen on a different port, you can set that below
+set :port, 4567
+
+helpers do
+ require './lib/toc_data.rb'
+end
diff --git a/app/docs/slate/deploy.sh b/app/docs/slate/deploy.sh
new file mode 100755
index 00000000..9dbd7db9
--- /dev/null
+++ b/app/docs/slate/deploy.sh
@@ -0,0 +1,226 @@
+#!/usr/bin/env bash
+set -o errexit #abort if any command fails
+me=$(basename "$0")
+
+help_message="\
+Usage: $me [-c FILE] []
+Deploy generated files to a git branch.
+
+Options:
+
+ -h, --help Show this help information.
+ -v, --verbose Increase verbosity. Useful for debugging.
+ -e, --allow-empty Allow deployment of an empty directory.
+ -m, --message MESSAGE Specify the message used when committing on the
+ deploy branch.
+ -n, --no-hash Don't append the source commit's hash to the deploy
+ commit's message.
+ --source-only Only build but not push
+ --push-only Only push but not build
+"
+
+
+run_build() {
+ bundle exec middleman build --clean
+}
+
+parse_args() {
+ # Set args from a local environment file.
+ if [ -e ".env" ]; then
+ source .env
+ fi
+
+ # Parse arg flags
+ # If something is exposed as an environment variable, set/overwrite it
+ # here. Otherwise, set/overwrite the internal variable instead.
+ while : ; do
+ if [[ $1 = "-h" || $1 = "--help" ]]; then
+ echo "$help_message"
+ exit 0
+ elif [[ $1 = "-v" || $1 = "--verbose" ]]; then
+ verbose=true
+ shift
+ elif [[ $1 = "-e" || $1 = "--allow-empty" ]]; then
+ allow_empty=true
+ shift
+ elif [[ ( $1 = "-m" || $1 = "--message" ) && -n $2 ]]; then
+ commit_message=$2
+ shift 2
+ elif [[ $1 = "-n" || $1 = "--no-hash" ]]; then
+ GIT_DEPLOY_APPEND_HASH=false
+ shift
+ elif [[ $1 = "--source-only" ]]; then
+ source_only=true
+ shift
+ elif [[ $1 = "--push-only" ]]; then
+ push_only=true
+ shift
+ else
+ break
+ fi
+ done
+
+ if [ ${source_only} ] && [ ${push_only} ]; then
+ >&2 echo "You can only specify one of --source-only or --push-only"
+ exit 1
+ fi
+
+ # Set internal option vars from the environment and arg flags. All internal
+ # vars should be declared here, with sane defaults if applicable.
+
+ # Source directory & target branch.
+ deploy_directory=build
+ deploy_branch=gh-pages
+
+ #if no user identity is already set in the current git environment, use this:
+ default_username=${GIT_DEPLOY_USERNAME:-deploy.sh}
+ default_email=${GIT_DEPLOY_EMAIL:-}
+
+ #repository to deploy to. must be readable and writable.
+ repo=origin
+
+ #append commit hash to the end of message by default
+ append_hash=${GIT_DEPLOY_APPEND_HASH:-true}
+}
+
+main() {
+ enable_expanded_output
+
+ if ! git diff --exit-code --quiet --cached; then
+ echo Aborting due to uncommitted changes in the index >&2
+ return 1
+ fi
+
+ commit_title=`git log -n 1 --format="%s" HEAD`
+ commit_hash=` git log -n 1 --format="%H" HEAD`
+
+ #default commit message uses last title if a custom one is not supplied
+ if [[ -z $commit_message ]]; then
+ commit_message="publish: $commit_title"
+ fi
+
+ #append hash to commit message unless no hash flag was found
+ if [ $append_hash = true ]; then
+ commit_message="$commit_message"$'\n\n'"generated from commit $commit_hash"
+ fi
+
+ previous_branch=`git rev-parse --abbrev-ref HEAD`
+
+ if [ ! -d "$deploy_directory" ]; then
+ echo "Deploy directory '$deploy_directory' does not exist. Aborting." >&2
+ return 1
+ fi
+
+ # must use short form of flag in ls for compatibility with macOS and BSD
+ if [[ -z `ls -A "$deploy_directory" 2> /dev/null` && -z $allow_empty ]]; then
+ echo "Deploy directory '$deploy_directory' is empty. Aborting. If you're sure you want to deploy an empty tree, use the --allow-empty / -e flag." >&2
+ return 1
+ fi
+
+ if git ls-remote --exit-code $repo "refs/heads/$deploy_branch" ; then
+ # deploy_branch exists in $repo; make sure we have the latest version
+
+ disable_expanded_output
+ git fetch --force $repo $deploy_branch:$deploy_branch
+ enable_expanded_output
+ fi
+
+ # check if deploy_branch exists locally
+ if git show-ref --verify --quiet "refs/heads/$deploy_branch"
+ then incremental_deploy
+ else initial_deploy
+ fi
+
+ restore_head
+}
+
+initial_deploy() {
+ git --work-tree "$deploy_directory" checkout --orphan $deploy_branch
+ git --work-tree "$deploy_directory" add --all
+ commit+push
+}
+
+incremental_deploy() {
+ #make deploy_branch the current branch
+ git symbolic-ref HEAD refs/heads/$deploy_branch
+ #put the previously committed contents of deploy_branch into the index
+ git --work-tree "$deploy_directory" reset --mixed --quiet
+ git --work-tree "$deploy_directory" add --all
+
+ set +o errexit
+ diff=$(git --work-tree "$deploy_directory" diff --exit-code --quiet HEAD --)$?
+ set -o errexit
+ case $diff in
+ 0) echo No changes to files in $deploy_directory. Skipping commit.;;
+ 1) commit+push;;
+ *)
+ echo git diff exited with code $diff. Aborting. Staying on branch $deploy_branch so you can debug. To switch back to main, use: git symbolic-ref HEAD refs/heads/main && git reset --mixed >&2
+ return $diff
+ ;;
+ esac
+}
+
+commit+push() {
+ set_user_id
+ git --work-tree "$deploy_directory" commit -m "$commit_message"
+
+ disable_expanded_output
+ #--quiet is important here to avoid outputting the repo URL, which may contain a secret token
+ git push --quiet $repo $deploy_branch
+ enable_expanded_output
+}
+
+#echo expanded commands as they are executed (for debugging)
+enable_expanded_output() {
+ if [ $verbose ]; then
+ set -o xtrace
+ set +o verbose
+ fi
+}
+
+#this is used to avoid outputting the repo URL, which may contain a secret token
+disable_expanded_output() {
+ if [ $verbose ]; then
+ set +o xtrace
+ set -o verbose
+ fi
+}
+
+set_user_id() {
+ if [[ -z `git config user.name` ]]; then
+ git config user.name "$default_username"
+ fi
+ if [[ -z `git config user.email` ]]; then
+ git config user.email "$default_email"
+ fi
+}
+
+restore_head() {
+ if [[ $previous_branch = "HEAD" ]]; then
+ #we weren't on any branch before, so just set HEAD back to the commit it was on
+ git update-ref --no-deref HEAD $commit_hash $deploy_branch
+ else
+ git symbolic-ref HEAD refs/heads/$previous_branch
+ fi
+
+ git reset --mixed
+}
+
+filter() {
+ sed -e "s|$repo|\$repo|g"
+}
+
+sanitize() {
+ "$@" 2> >(filter 1>&2) | filter
+}
+
+parse_args "$@"
+
+if [[ ${source_only} ]]; then
+ run_build
+elif [[ ${push_only} ]]; then
+ main "$@"
+else
+ run_build
+ main "$@"
+fi
diff --git a/app/docs/slate/font-selection.json b/app/docs/slate/font-selection.json
new file mode 100755
index 00000000..5e78f5d8
--- /dev/null
+++ b/app/docs/slate/font-selection.json
@@ -0,0 +1,148 @@
+{
+ "IcoMoonType": "selection",
+ "icons": [
+ {
+ "icon": {
+ "paths": [
+ "M438.857 73.143q119.429 0 220.286 58.857t159.714 159.714 58.857 220.286-58.857 220.286-159.714 159.714-220.286 58.857-220.286-58.857-159.714-159.714-58.857-220.286 58.857-220.286 159.714-159.714 220.286-58.857zM512 785.714v-108.571q0-8-5.143-13.429t-12.571-5.429h-109.714q-7.429 0-13.143 5.714t-5.714 13.143v108.571q0 7.429 5.714 13.143t13.143 5.714h109.714q7.429 0 12.571-5.429t5.143-13.429zM510.857 589.143l10.286-354.857q0-6.857-5.714-10.286-5.714-4.571-13.714-4.571h-125.714q-8 0-13.714 4.571-5.714 3.429-5.714 10.286l9.714 354.857q0 5.714 5.714 10t13.714 4.286h105.714q8 0 13.429-4.286t6-10z"
+ ],
+ "attrs": [],
+ "isMulticolor": false,
+ "tags": [
+ "exclamation-circle"
+ ],
+ "defaultCode": 61546,
+ "grid": 14
+ },
+ "attrs": [],
+ "properties": {
+ "id": 100,
+ "order": 4,
+ "prevSize": 28,
+ "code": 58880,
+ "name": "exclamation-sign",
+ "ligatures": ""
+ },
+ "setIdx": 0,
+ "iconIdx": 0
+ },
+ {
+ "icon": {
+ "paths": [
+ "M585.143 786.286v-91.429q0-8-5.143-13.143t-13.143-5.143h-54.857v-292.571q0-8-5.143-13.143t-13.143-5.143h-182.857q-8 0-13.143 5.143t-5.143 13.143v91.429q0 8 5.143 13.143t13.143 5.143h54.857v182.857h-54.857q-8 0-13.143 5.143t-5.143 13.143v91.429q0 8 5.143 13.143t13.143 5.143h256q8 0 13.143-5.143t5.143-13.143zM512 274.286v-91.429q0-8-5.143-13.143t-13.143-5.143h-109.714q-8 0-13.143 5.143t-5.143 13.143v91.429q0 8 5.143 13.143t13.143 5.143h109.714q8 0 13.143-5.143t5.143-13.143zM877.714 512q0 119.429-58.857 220.286t-159.714 159.714-220.286 58.857-220.286-58.857-159.714-159.714-58.857-220.286 58.857-220.286 159.714-159.714 220.286-58.857 220.286 58.857 159.714 159.714 58.857 220.286z"
+ ],
+ "attrs": [],
+ "isMulticolor": false,
+ "tags": [
+ "info-circle"
+ ],
+ "defaultCode": 61530,
+ "grid": 14
+ },
+ "attrs": [],
+ "properties": {
+ "id": 85,
+ "order": 3,
+ "name": "info-sign",
+ "prevSize": 28,
+ "code": 58882
+ },
+ "setIdx": 0,
+ "iconIdx": 2
+ },
+ {
+ "icon": {
+ "paths": [
+ "M733.714 419.429q0-16-10.286-26.286l-52-51.429q-10.857-10.857-25.714-10.857t-25.714 10.857l-233.143 232.571-129.143-129.143q-10.857-10.857-25.714-10.857t-25.714 10.857l-52 51.429q-10.286 10.286-10.286 26.286 0 15.429 10.286 25.714l206.857 206.857q10.857 10.857 25.714 10.857 15.429 0 26.286-10.857l310.286-310.286q10.286-10.286 10.286-25.714zM877.714 512q0 119.429-58.857 220.286t-159.714 159.714-220.286 58.857-220.286-58.857-159.714-159.714-58.857-220.286 58.857-220.286 159.714-159.714 220.286-58.857 220.286 58.857 159.714 159.714 58.857 220.286z"
+ ],
+ "attrs": [],
+ "isMulticolor": false,
+ "tags": [
+ "check-circle"
+ ],
+ "defaultCode": 61528,
+ "grid": 14
+ },
+ "attrs": [],
+ "properties": {
+ "id": 83,
+ "order": 9,
+ "prevSize": 28,
+ "code": 58886,
+ "name": "ok-sign"
+ },
+ "setIdx": 0,
+ "iconIdx": 6
+ },
+ {
+ "icon": {
+ "paths": [
+ "M658.286 475.429q0-105.714-75.143-180.857t-180.857-75.143-180.857 75.143-75.143 180.857 75.143 180.857 180.857 75.143 180.857-75.143 75.143-180.857zM950.857 950.857q0 29.714-21.714 51.429t-51.429 21.714q-30.857 0-51.429-21.714l-196-195.429q-102.286 70.857-228 70.857-81.714 0-156.286-31.714t-128.571-85.714-85.714-128.571-31.714-156.286 31.714-156.286 85.714-128.571 128.571-85.714 156.286-31.714 156.286 31.714 128.571 85.714 85.714 128.571 31.714 156.286q0 125.714-70.857 228l196 196q21.143 21.143 21.143 51.429z"
+ ],
+ "width": 951,
+ "attrs": [],
+ "isMulticolor": false,
+ "tags": [
+ "search"
+ ],
+ "defaultCode": 61442,
+ "grid": 14
+ },
+ "attrs": [],
+ "properties": {
+ "id": 2,
+ "order": 1,
+ "prevSize": 28,
+ "code": 58887,
+ "name": "icon-search"
+ },
+ "setIdx": 0,
+ "iconIdx": 7
+ }
+ ],
+ "height": 1024,
+ "metadata": {
+ "name": "slate",
+ "license": "SIL OFL 1.1"
+ },
+ "preferences": {
+ "showGlyphs": true,
+ "showQuickUse": true,
+ "showQuickUse2": true,
+ "showSVGs": true,
+ "fontPref": {
+ "prefix": "icon-",
+ "metadata": {
+ "fontFamily": "slate",
+ "majorVersion": 1,
+ "minorVersion": 0,
+ "description": "Based on FontAwesome",
+ "license": "SIL OFL 1.1"
+ },
+ "metrics": {
+ "emSize": 1024,
+ "baseline": 6.25,
+ "whitespace": 50
+ },
+ "resetPoint": 58880,
+ "showSelector": false,
+ "selector": "class",
+ "classSelector": ".icon",
+ "showMetrics": false,
+ "showMetadata": true,
+ "showVersion": true,
+ "ie7": false
+ },
+ "imagePref": {
+ "prefix": "icon-",
+ "png": true,
+ "useClassSelector": true,
+ "color": 4473924,
+ "bgColor": 16777215
+ },
+ "historySize": 100,
+ "showCodes": true,
+ "gridSize": 16,
+ "showLiga": false
+ }
+}
diff --git a/app/docs/slate/lib/monokai_sublime_slate.rb b/app/docs/slate/lib/monokai_sublime_slate.rb
new file mode 100644
index 00000000..cd2de331
--- /dev/null
+++ b/app/docs/slate/lib/monokai_sublime_slate.rb
@@ -0,0 +1,95 @@
+# -*- coding: utf-8 -*- #
+# frozen_string_literal: true
+
+# this is based on https://github.com/rouge-ruby/rouge/blob/master/lib/rouge/themes/monokai_sublime.rb
+# but without the added background, and changed styling for JSON keys to be soft_yellow instead of white
+
+module Rouge
+ module Themes
+ class MonokaiSublimeSlate < CSSTheme
+ name 'monokai.sublime.slate'
+
+ palette :black => '#000000'
+ palette :bright_green => '#a6e22e'
+ palette :bright_pink => '#f92672'
+ palette :carmine => '#960050'
+ palette :dark => '#49483e'
+ palette :dark_grey => '#888888'
+ palette :dark_red => '#aa0000'
+ palette :dimgrey => '#75715e'
+ palette :emperor => '#555555'
+ palette :grey => '#999999'
+ palette :light_grey => '#aaaaaa'
+ palette :light_violet => '#ae81ff'
+ palette :soft_cyan => '#66d9ef'
+ palette :soft_yellow => '#e6db74'
+ palette :very_dark => '#1e0010'
+ palette :whitish => '#f8f8f2'
+ palette :orange => '#f6aa11'
+ palette :white => '#ffffff'
+
+ style Generic::Heading, :fg => :grey
+ style Literal::String::Regex, :fg => :orange
+ style Generic::Output, :fg => :dark_grey
+ style Generic::Prompt, :fg => :emperor
+ style Generic::Strong, :bold => false
+ style Generic::Subheading, :fg => :light_grey
+ style Name::Builtin, :fg => :orange
+ style Comment::Multiline,
+ Comment::Preproc,
+ Comment::Single,
+ Comment::Special,
+ Comment, :fg => :dimgrey
+ style Error,
+ Generic::Error,
+ Generic::Traceback, :fg => :carmine
+ style Generic::Deleted,
+ Generic::Inserted,
+ Generic::Emph, :fg => :dark
+ style Keyword::Constant,
+ Keyword::Declaration,
+ Keyword::Reserved,
+ Name::Constant,
+ Keyword::Type, :fg => :soft_cyan
+ style Literal::Number::Float,
+ Literal::Number::Hex,
+ Literal::Number::Integer::Long,
+ Literal::Number::Integer,
+ Literal::Number::Oct,
+ Literal::Number,
+ Literal::String::Char,
+ Literal::String::Escape,
+ Literal::String::Symbol, :fg => :light_violet
+ style Literal::String::Doc,
+ Literal::String::Double,
+ Literal::String::Backtick,
+ Literal::String::Heredoc,
+ Literal::String::Interpol,
+ Literal::String::Other,
+ Literal::String::Single,
+ Literal::String, :fg => :soft_yellow
+ style Name::Attribute,
+ Name::Class,
+ Name::Decorator,
+ Name::Exception,
+ Name::Function, :fg => :bright_green
+ style Name::Variable::Class,
+ Name::Namespace,
+ Name::Entity,
+ Name::Builtin::Pseudo,
+ Name::Variable::Global,
+ Name::Variable::Instance,
+ Name::Variable,
+ Text::Whitespace,
+ Text,
+ Name, :fg => :white
+ style Name::Label, :fg => :bright_pink
+ style Operator::Word,
+ Name::Tag,
+ Keyword,
+ Keyword::Namespace,
+ Keyword::Pseudo,
+ Operator, :fg => :bright_pink
+ end
+ end
+ end
diff --git a/app/docs/slate/lib/multilang.rb b/app/docs/slate/lib/multilang.rb
new file mode 100644
index 00000000..36fbe5b1
--- /dev/null
+++ b/app/docs/slate/lib/multilang.rb
@@ -0,0 +1,16 @@
+module Multilang
+ def block_code(code, full_lang_name)
+ if full_lang_name
+ parts = full_lang_name.split('--')
+ rouge_lang_name = (parts) ? parts[0] : "" # just parts[0] here causes null ref exception when no language specified
+ super(code, rouge_lang_name).sub("highlight #{rouge_lang_name}") do |match|
+ match + " tab-" + full_lang_name
+ end
+ else
+ super(code, full_lang_name)
+ end
+ end
+end
+
+require 'middleman-core/renderers/redcarpet'
+Middleman::Renderers::MiddlemanRedcarpetHTML.send :include, Multilang
diff --git a/app/docs/slate/lib/nesting_unique_head.rb b/app/docs/slate/lib/nesting_unique_head.rb
new file mode 100644
index 00000000..01278371
--- /dev/null
+++ b/app/docs/slate/lib/nesting_unique_head.rb
@@ -0,0 +1,22 @@
+# Nested unique header generation
+require 'middleman-core/renderers/redcarpet'
+
+class NestingUniqueHeadCounter < Middleman::Renderers::MiddlemanRedcarpetHTML
+ def initialize
+ super
+ @@headers_history = {} if !defined?(@@headers_history)
+ end
+
+ def header(text, header_level)
+ friendly_text = text.gsub(/<[^>]*>/,"").parameterize
+ @@headers_history[header_level] = text.parameterize
+
+ if header_level > 1
+ for i in (header_level - 1).downto(1)
+ friendly_text.prepend("#{@@headers_history[i]}-") if @@headers_history.key?(i)
+ end
+ end
+
+ return "#{text}"
+ end
+end
diff --git a/app/docs/slate/lib/toc_data.rb b/app/docs/slate/lib/toc_data.rb
new file mode 100644
index 00000000..4a04efee
--- /dev/null
+++ b/app/docs/slate/lib/toc_data.rb
@@ -0,0 +1,31 @@
+require 'nokogiri'
+
+def toc_data(page_content)
+ html_doc = Nokogiri::HTML::DocumentFragment.parse(page_content)
+
+ # get a flat list of headers
+ headers = []
+ html_doc.css('h1, h2, h3').each do |header|
+ headers.push({
+ id: header.attribute('id').to_s,
+ content: header.children,
+ title: header.children.to_s.gsub(/<[^>]*>/, ''),
+ level: header.name[1].to_i,
+ children: []
+ })
+ end
+
+ [3,2].each do |header_level|
+ header_to_nest = nil
+ headers = headers.reject do |header|
+ if header[:level] == header_level
+ header_to_nest[:children].push header if header_to_nest
+ true
+ else
+ header_to_nest = header if header[:level] < header_level
+ false
+ end
+ end
+ end
+ headers
+end
diff --git a/app/docs/slate/lib/unique_head.rb b/app/docs/slate/lib/unique_head.rb
new file mode 100644
index 00000000..d42bab2a
--- /dev/null
+++ b/app/docs/slate/lib/unique_head.rb
@@ -0,0 +1,24 @@
+# Unique header generation
+require 'middleman-core/renderers/redcarpet'
+require 'digest'
+class UniqueHeadCounter < Middleman::Renderers::MiddlemanRedcarpetHTML
+ def initialize
+ super
+ @head_count = {}
+ end
+ def header(text, header_level)
+ friendly_text = text.gsub(/<[^>]*>/,"").parameterize
+ if friendly_text.strip.length == 0
+ # Looks like parameterize removed the whole thing! It removes many unicode
+ # characters like Chinese and Russian. To get a unique URL, let's just
+ # URI escape the whole header
+ friendly_text = Digest::SHA1.hexdigest(text)[0,10]
+ end
+ @head_count[friendly_text] ||= 0
+ @head_count[friendly_text] += 1
+ if @head_count[friendly_text] > 1
+ friendly_text += "-#{@head_count[friendly_text]}"
+ end
+ return "#{text}"
+ end
+end
diff --git a/app/docs/slate/slate.sh b/app/docs/slate/slate.sh
new file mode 100755
index 00000000..a3cc498e
--- /dev/null
+++ b/app/docs/slate/slate.sh
@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+set -o errexit #abort if any command fails
+
+me=$(basename "$0")
+
+help_message="\
+Usage: $me [] []
+Run commands related to the slate process.
+
+Commands:
+
+ serve Run the middleman server process, useful for
+ development.
+ build Run the build process.
+ deploy Will build and deploy files to branch. Use
+ --no-build to only deploy.
+
+Global Options:
+
+ -h, --help Show this help information.
+ -v, --verbose Increase verbosity. Useful for debugging.
+
+Deploy options:
+ -e, --allow-empty Allow deployment of an empty directory.
+ -m, --message MESSAGE Specify the message used when committing on the
+ deploy branch.
+ -n, --no-hash Don't append the source commit's hash to the deploy
+ commit's message.
+ --no-build Do not build the source files.
+"
+
+
+run_serve() {
+ exec bundle exec middleman serve --watcher-force-polling
+}
+
+run_build() {
+ bundle exec middleman build --clean
+}
+
+parse_args() {
+ # Set args from a local environment file.
+ if [ -e ".env" ]; then
+ source .env
+ fi
+
+ command=
+
+ # Parse arg flags
+ # If something is exposed as an environment variable, set/overwrite it
+ # here. Otherwise, set/overwrite the internal variable instead.
+ while : ; do
+ if [[ $1 = "-h" || $1 = "--help" ]]; then
+ echo "$help_message"
+ exit 0
+ elif [[ $1 = "-v" || $1 = "--verbose" ]]; then
+ verbose=true
+ shift
+ elif [[ $1 = "-e" || $1 = "--allow-empty" ]]; then
+ allow_empty=true
+ shift
+ elif [[ ( $1 = "-m" || $1 = "--message" ) && -n $2 ]]; then
+ commit_message=$2
+ shift 2
+ elif [[ $1 = "-n" || $1 = "--no-hash" ]]; then
+ GIT_DEPLOY_APPEND_HASH=false
+ shift
+ elif [[ $1 = "--no-build" ]]; then
+ no_build=true
+ shift
+ elif [[ $1 = "serve" || $1 = "build" || $1 = "deploy" ]]; then
+ if [ ! -z "${command}" ]; then
+ >&2 echo "You can only specify one command."
+ exit 1
+ fi
+ command=$1
+ shift
+ elif [ -z $1 ]; then
+ break
+ fi
+ done
+
+ if [ -z "${command}" ]; then
+ >&2 echo "Command not specified."
+ exit 1
+ fi
+
+ # Set internal option vars from the environment and arg flags. All internal
+ # vars should be declared here, with sane defaults if applicable.
+
+ # Source directory & target branch.
+ deploy_directory=build
+ deploy_branch=gh-pages
+
+ #if no user identity is already set in the current git environment, use this:
+ default_username=${GIT_DEPLOY_USERNAME:-deploy.sh}
+ default_email=${GIT_DEPLOY_EMAIL:-}
+
+ #repository to deploy to. must be readable and writable.
+ repo=origin
+
+ #append commit hash to the end of message by default
+ append_hash=${GIT_DEPLOY_APPEND_HASH:-true}
+}
+
+main() {
+ enable_expanded_output
+
+ if ! git diff --exit-code --quiet --cached; then
+ echo Aborting due to uncommitted changes in the index >&2
+ return 1
+ fi
+
+ commit_title=`git log -n 1 --format="%s" HEAD`
+ commit_hash=` git log -n 1 --format="%H" HEAD`
+
+ #default commit message uses last title if a custom one is not supplied
+ if [[ -z $commit_message ]]; then
+ commit_message="publish: $commit_title"
+ fi
+
+ #append hash to commit message unless no hash flag was found
+ if [ $append_hash = true ]; then
+ commit_message="$commit_message"$'\n\n'"generated from commit $commit_hash"
+ fi
+
+ previous_branch=`git rev-parse --abbrev-ref HEAD`
+
+ if [ ! -d "$deploy_directory" ]; then
+ echo "Deploy directory '$deploy_directory' does not exist. Aborting." >&2
+ return 1
+ fi
+
+ # must use short form of flag in ls for compatibility with macOS and BSD
+ if [[ -z `ls -A "$deploy_directory" 2> /dev/null` && -z $allow_empty ]]; then
+ echo "Deploy directory '$deploy_directory' is empty. Aborting. If you're sure you want to deploy an empty tree, use the --allow-empty / -e flag." >&2
+ return 1
+ fi
+
+ if git ls-remote --exit-code $repo "refs/heads/$deploy_branch" ; then
+ # deploy_branch exists in $repo; make sure we have the latest version
+
+ disable_expanded_output
+ git fetch --force $repo $deploy_branch:$deploy_branch
+ enable_expanded_output
+ fi
+
+ # check if deploy_branch exists locally
+ if git show-ref --verify --quiet "refs/heads/$deploy_branch"
+ then incremental_deploy
+ else initial_deploy
+ fi
+
+ restore_head
+}
+
+initial_deploy() {
+ git --work-tree "$deploy_directory" checkout --orphan $deploy_branch
+ git --work-tree "$deploy_directory" add --all
+ commit+push
+}
+
+incremental_deploy() {
+ #make deploy_branch the current branch
+ git symbolic-ref HEAD refs/heads/$deploy_branch
+ #put the previously committed contents of deploy_branch into the index
+ git --work-tree "$deploy_directory" reset --mixed --quiet
+ git --work-tree "$deploy_directory" add --all
+
+ set +o errexit
+ diff=$(git --work-tree "$deploy_directory" diff --exit-code --quiet HEAD --)$?
+ set -o errexit
+ case $diff in
+ 0) echo No changes to files in $deploy_directory. Skipping commit.;;
+ 1) commit+push;;
+ *)
+ echo git diff exited with code $diff. Aborting. Staying on branch $deploy_branch so you can debug. To switch back to main, use: git symbolic-ref HEAD refs/heads/main && git reset --mixed >&2
+ return $diff
+ ;;
+ esac
+}
+
+commit+push() {
+ set_user_id
+ git --work-tree "$deploy_directory" commit -m "$commit_message"
+
+ disable_expanded_output
+ #--quiet is important here to avoid outputting the repo URL, which may contain a secret token
+ git push --quiet $repo $deploy_branch
+ enable_expanded_output
+}
+
+#echo expanded commands as they are executed (for debugging)
+enable_expanded_output() {
+ if [ $verbose ]; then
+ set -o xtrace
+ set +o verbose
+ fi
+}
+
+#this is used to avoid outputting the repo URL, which may contain a secret token
+disable_expanded_output() {
+ if [ $verbose ]; then
+ set +o xtrace
+ set -o verbose
+ fi
+}
+
+set_user_id() {
+ if [[ -z `git config user.name` ]]; then
+ git config user.name "$default_username"
+ fi
+ if [[ -z `git config user.email` ]]; then
+ git config user.email "$default_email"
+ fi
+}
+
+restore_head() {
+ if [[ $previous_branch = "HEAD" ]]; then
+ #we weren't on any branch before, so just set HEAD back to the commit it was on
+ git update-ref --no-deref HEAD $commit_hash $deploy_branch
+ else
+ git symbolic-ref HEAD refs/heads/$previous_branch
+ fi
+
+ git reset --mixed
+}
+
+filter() {
+ sed -e "s|$repo|\$repo|g"
+}
+
+sanitize() {
+ "$@" 2> >(filter 1>&2) | filter
+}
+
+parse_args "$@"
+
+if [ "${command}" = "serve" ]; then
+ run_serve
+elif [[ "${command}" = "build" ]]; then
+ run_build
+elif [[ ${command} = "deploy" ]]; then
+ if [[ ${no_build} != true ]]; then
+ run_build
+ fi
+ main "$@"
+fi
diff --git a/app/docs/slate/source/api.html.md b/app/docs/slate/source/api.html.md
new file mode 100644
index 00000000..a08823a4
--- /dev/null
+++ b/app/docs/slate/source/api.html.md
@@ -0,0 +1,36 @@
+---
+title: Trustie API Reference
+
+language_tabs: # must be one of https://git.io/vQNgJ
+ - shell: Shell
+ - javascript: JavaScript
+
+toc_footers:
+ - Sign Up for a User
+ - Powered by Trustie
+
+includes:
+ - licenses
+ - gitignores
+ - users
+ - projects
+ - repositories
+ - pulls
+ - issues
+ - organizations
+ - teams
+ - errors
+
+
+search: true
+
+code_clipboard: true
+---
+
+# Introduction
+
+Welcome to the Trustie API! You can use our API to access Trustie API endpoints, which can get information on projects, repository, and users in our platform.
+
+We have language bindings in Shell,avaScript! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.
+
+This example API documentation page was created with [Trustie](https://www.trustie.net). Feel free to edit it and use it as a base for your own API's documentation.
diff --git a/app/docs/slate/source/fonts/slate.eot b/app/docs/slate/source/fonts/slate.eot
new file mode 100644
index 00000000..13c4839a
Binary files /dev/null and b/app/docs/slate/source/fonts/slate.eot differ
diff --git a/app/docs/slate/source/fonts/slate.svg b/app/docs/slate/source/fonts/slate.svg
new file mode 100644
index 00000000..5f349823
--- /dev/null
+++ b/app/docs/slate/source/fonts/slate.svg
@@ -0,0 +1,14 @@
+
+
+
diff --git a/app/docs/slate/source/fonts/slate.ttf b/app/docs/slate/source/fonts/slate.ttf
new file mode 100644
index 00000000..ace9a46a
Binary files /dev/null and b/app/docs/slate/source/fonts/slate.ttf differ
diff --git a/app/docs/slate/source/fonts/slate.woff b/app/docs/slate/source/fonts/slate.woff
new file mode 100644
index 00000000..1e72e0ee
Binary files /dev/null and b/app/docs/slate/source/fonts/slate.woff differ
diff --git a/app/docs/slate/source/fonts/slate.woff2 b/app/docs/slate/source/fonts/slate.woff2
new file mode 100644
index 00000000..7c585a72
Binary files /dev/null and b/app/docs/slate/source/fonts/slate.woff2 differ
diff --git a/app/docs/slate/source/images/logo.png b/app/docs/slate/source/images/logo.png
new file mode 100644
index 00000000..30affed0
Binary files /dev/null and b/app/docs/slate/source/images/logo.png differ
diff --git a/app/docs/slate/source/images/logoWilte.png b/app/docs/slate/source/images/logoWilte.png
new file mode 100644
index 00000000..67407bd5
Binary files /dev/null and b/app/docs/slate/source/images/logoWilte.png differ
diff --git a/app/docs/slate/source/images/navbar.png b/app/docs/slate/source/images/navbar.png
new file mode 100644
index 00000000..df38e90d
Binary files /dev/null and b/app/docs/slate/source/images/navbar.png differ
diff --git a/app/docs/slate/source/includes/_authentication.md b/app/docs/slate/source/includes/_authentication.md
new file mode 100644
index 00000000..04969e7a
--- /dev/null
+++ b/app/docs/slate/source/includes/_authentication.md
@@ -0,0 +1,39 @@
+# Authentication
+
+> To authorize, use this code:
+
+```ruby
+require 'kittn'
+
+api = Kittn::APIClient.authorize!('meowmeowmeow')
+```
+
+```python
+import kittn
+
+api = kittn.authorize('meowmeowmeow')
+```
+
+```shell
+# With shell, you can just pass the correct header with each request
+curl "api_endpoint_here" \
+ -H "Authorization: meowmeowmeow"
+```
+
+```javascript
+const kittn = require('kittn');
+
+let api = kittn.authorize('meowmeowmeow');
+```
+
+> Make sure to replace `meowmeowmeow` with your API key.
+
+Kittn uses API keys to allow access to the API. You can register a new Kittn API key at our [developer portal](http://example.com/developers).
+
+Kittn expects for the API key to be included in all API requests to the server in a header that looks like the following:
+
+`Authorization: meowmeowmeow`
+
+
diff --git a/app/docs/slate/source/includes/_errors.md b/app/docs/slate/source/includes/_errors.md
new file mode 100644
index 00000000..7b35e92b
--- /dev/null
+++ b/app/docs/slate/source/includes/_errors.md
@@ -0,0 +1,22 @@
+# Errors
+
+
+
+The Kittn API uses the following error codes:
+
+
+Error Code | Meaning
+---------- | -------
+400 | Bad Request -- Your request is invalid.
+401 | Unauthorized -- Your API key is wrong.
+403 | Forbidden -- The kitten requested is hidden for administrators only.
+404 | Not Found -- The specified kitten could not be found.
+405 | Method Not Allowed -- You tried to access a kitten with an invalid method.
+406 | Not Acceptable -- You requested a format that isn't json.
+410 | Gone -- The kitten requested has been removed from our servers.
+418 | I'm a teapot.
+429 | Too Many Requests -- You're requesting too many kittens! Slow down!
+500 | Internal Server Error -- We had a problem with our server. Try again later.
+503 | Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
diff --git a/app/docs/slate/source/includes/_gitignores.md b/app/docs/slate/source/includes/_gitignores.md
new file mode 100644
index 00000000..0cec9543
--- /dev/null
+++ b/app/docs/slate/source/includes/_gitignores.md
@@ -0,0 +1,47 @@
+# Gitignores
+
+## gitignore模板列表
+获取gitignore模板列表, 支持名称搜索过滤
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "name=Ada" \
+http://localhost:3000/api/ignores.json
+```
+
+```javascript
+await octokit.request('GET /api/ignores.json')
+```
+
+### HTTP 请求
+`GET api/ignores.json`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+name |否| 否 ||string |gitignore名称
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+id |int |id |
+name |string|gitignore名称|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "ignores": [
+ {
+ "id": 1,
+ "name": "Ada"
+ }
+ ]
+}
+```
+
diff --git a/app/docs/slate/source/includes/_issues.md b/app/docs/slate/source/includes/_issues.md
new file mode 100644
index 00000000..0ec509b7
--- /dev/null
+++ b/app/docs/slate/source/includes/_issues.md
@@ -0,0 +1 @@
+# Issues
diff --git a/app/docs/slate/source/includes/_licenses.md b/app/docs/slate/source/includes/_licenses.md
new file mode 100644
index 00000000..4ec5462b
--- /dev/null
+++ b/app/docs/slate/source/includes/_licenses.md
@@ -0,0 +1,57 @@
+# Licenses
+
+
+## Get All Licenses
+The Licenses API returns metadata about popular open source licenses and information about a particular project's license file.
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "name=AFL" \
+http://localhost:3000/api/licenses
+```
+
+```javascript
+await octokit.request('GET /api/licenses')
+```
+
+### HTTP Request
+
+`GET https://forgeplus.trustie.net/api/licenses.json`
+
+### 请求参数
+
+Name | Required | Type | Description
+----- | ---- | ----- | -----
+name |false|string |name of the license
+
+
+> 返回字段说明:
+
+```json
+{
+ "licenses": [
+ {
+ "id": 57,
+ "name": "AFL-1.2"
+ },
+ {
+ "id": 76,
+ "name": "AFL-3.0"
+ },
+ {
+ "id": 214,
+ "name": "AFL-1.1"
+ },
+ {
+ "id": 326,
+ "name": "AFL-2.1"
+ },
+ {
+ "id": 350,
+ "name": "AFL-2.0"
+ }
+ ]
+}
+```
diff --git a/app/docs/slate/source/includes/_organizations.md b/app/docs/slate/source/includes/_organizations.md
new file mode 100644
index 00000000..19a55fd4
--- /dev/null
+++ b/app/docs/slate/source/includes/_organizations.md
@@ -0,0 +1 @@
+# Organizations
diff --git a/app/docs/slate/source/includes/_projects.md b/app/docs/slate/source/includes/_projects.md
new file mode 100644
index 00000000..0a46d8cc
--- /dev/null
+++ b/app/docs/slate/source/includes/_projects.md
@@ -0,0 +1,528 @@
+# Projects
+
+## 获取项目列表
+获取项目列表,也可以更加相关条件过滤搜素
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "page=1" \
+-d "limit=5" \
+http://localhost:3000/api/projects | jq
+```
+
+```javascript
+await octokit.request('GET /api/projects')
+```
+
+### HTTP 请求
+`GET api/projects`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+page | false | 1 | string | 页数,第几页
+limit | false | 15 | string | 每页多少条数据,默认15条
+sort_by | false | | string | 排序类型, 取值:updated_on、created_on、forked_count、praises_count; updated_on: 更新时间排序,created_on: 创建时间排序,forked_count: fork数据排序,praises_count: 点赞数量排序,默认为updated_on更新时间排序
+sort_direction| false | | string | 排序方式,取值为: desc、asc; desc: 降序排序, asc: 升序排序, 默认为:desc
+search | false | | string | 按照项目名称搜索
+category_id | false | | int | 项目类别id
+language_id | false | | int | 项目语言id
+project_type | false | | string | 项目类型, 取值为:common、mirror; common:开源托管项目, mirror:开源镜像项目
+
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+total_count | int | 项目总条数
+id | string | 项目id
+name | string | 项目名称
+description | string | 项目简介
+visits | int | 流量数
+forked_count | int | 被fork的数量
+praises_count | int | star数量
+is_public | boolean | 是否公开, true:公开,false:未公开
+mirror_url | string | 镜像url
+last_update_time| int | 最后更新时间,为UNIX格式的时间戳
+author | object | 项目创建者
+-- name | string | 用户名,也是用户标识
+category | object | 项目类别
+-- id | int | 项目类型id
+-- name | string | 项目类型名称
+language | object | 项目语言
+-- id | int | 项目语言id
+-- name | string | 项目语言名称
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "total_count": 3096,
+ "projects": [
+ {
+ "id": 1400794,
+ "repo_id": 1402452,
+ "identifier": "cscw_2021_sponsor",
+ "name": "Sponsor机制下的开源贡献",
+ "description": "CSCW 2021 sponsor机制研究",
+ "visits": 5,
+ "praises_count": 0,
+ "forked_count": 0,
+ "is_public": true,
+ "mirror_url": null,
+ "type": 0,
+ "last_update_time": 1611971671,
+ "time_ago": "2天前",
+ "forked_from_project_id": null,
+ "open_devops": false,
+ "platform": "forge",
+ "author": {
+ "name": "张迅晖",
+ "login": "Nigel",
+ "image_url": "images/avatars/User/3675?t=1611832880"
+ },
+ "category": {
+ "id": 13,
+ "name": "云计算和大数据"
+ },
+ "language": {
+ "id": 34,
+ "name": "Python3.6"
+ }
+ }
+ ]
+}
+```
+
+
+
+## 推荐项目
+获取推荐项目列表
+
+> 示例:
+
+```shell
+curl -X GET \
+http://localhost:3000/api/projects/recommend | jq
+```
+
+```javascript
+await octokit.request('GET /api/projects/recommend.json')
+```
+
+### HTTP 请求
+`GET api/projects/recommend`
+
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+total_count |int |项目总条数
+id |string |项目id
+name |string|项目名称
+description |string|项目简介
+visits |int|流量数
+forked_count |int|被fork的数量
+praises_count |int|star数量
+is_public |boolean|是否公开, true:公开,false:未公开
+mirror_url |string|镜像url
+last_update_time|int|最后更新时间,为UNIX格式的时间戳
+author |object|项目创建者
+-- name |string|用户名,也是用户标识
+category |object|项目类别
+-- id |int|项目类型id
+-- name |string|项目类型名称
+language |object|项目语言
+-- id |int|项目语言id
+-- name |string|项目语言名称
+
+
+> 返回的JSON示例:
+
+```json
+[
+ {
+ "id": 20,
+ "repo_id": 2,
+ "identifier": "PNAekinmH",
+ "name": "FNILL",
+ "visits": 13567,
+ "author": {
+ "name": "王一达",
+ "login": "wangyida",
+ "image_url": "avatars/User/b"
+ },
+ "category": {
+ "id": 8,
+ "name": "其他"
+ }
+ }
+]
+```
+
+
+
+## 项目导航
+获取项目导航信息
+
+> 示例:
+
+```shell
+curl -X GET \
+http://localhost:3000/api/yystopf/ceshi/menu_list | jq
+```
+
+```javascript
+await octokit.request('GET /api/yystopf/ceshi/menu_list')
+```
+
+### HTTP 请求
+`GET api/:owner/:repo/menu_list`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+owner |是| |string |用户登录名
+repo |是| |string |项目标识identifier
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+menu_name |string|导航名称, home:主页,code:代码库,issues:易修,pulls:合并请求,devops:工作流,versions:里程碑,activity:动态,setting:仓库设置
+
+
+> 返回的JSON示例:
+
+```json
+[
+ {
+ "menu_name": "home"
+ },
+ {
+ "menu_name": "code"
+ },
+ {
+ "menu_name": "pulls"
+ },
+ {
+ "menu_name": "activity"
+ }
+]
+```
+
+
+## 项目主页
+获取项目主页信息
+
+> 示例:
+
+```shell
+curl -X GET \
+http://localhost:3000/api/jasder/forgeplus/about | jq
+```
+
+```javascript
+await octokit.request('GET /api/jasder/forgeplus/about')
+```
+
+### HTTP 请求
+`GET api/:owner/:repo/about`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+owner |是| |string |用户登录名
+repo |是| |string |项目标识identifier
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+identifier |string|project's identifier
+content |string|主页内容
+attachments |array|附件
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "content": "",
+ "identifier": "forgeplus",
+ attachments: []
+}
+```
+
+
+## 项目模块信息
+项目模块信息
+
+> 示例:
+
+```shell
+curl -X GET \
+http://localhost:3000/api/yystopf/ceshi/project_units.json
+```
+
+```javascript
+await octokit.request('GET /api/yystopf/ceshi/project_units')
+```
+
+### HTTP 请求
+`GET /api/yystopf/ceshi/project_units`
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|type |string|模块名称 |
+
+> 返回的JSON示例:
+
+```json
+[
+ {
+ "type": "code"
+ },
+ {
+ "type": "pulls"
+ },
+ {
+ "type": "issues"
+ }
+]
+```
+
+## 更改项目模块展示
+更改项目模块展示
+
+> 示例:
+
+```shell
+curl -X POST \
+-H "accept: application/json" \
+-H "Content-Type: application/json" \
+-d "{ \"unit_typs\": [\"code\", \"pulls\"]}" \
+http://localhost:3000/api/yystopf/ceshi/project_units.json
+```
+
+```javascript
+await octokit.request('POST /api/yystopf/ceshi/project_units')
+```
+
+### HTTP 请求
+`POST /api/yystopf/ceshi/project_units`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|unit_types |是| |array | 项目模块内容, 支持以下参数:code:代码库,issues:易修,pulls:合并请求,devops:工作流,versions:里程碑 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int|返回状态, 0: 表示操作成功 |
+|message |string|返回信息说明|
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+## 创建项目
+创建项目
+
+> 示例:
+
+```shell
+curl -X POST \
+-d "user_id=36401" \
+-d "name=hnfl_demo" \
+-d "description=my first project" \
+-d "repository_name=hnfl_demo" \
+-d "project_category_id=1" \
+-d "project_language_id=2" \
+-d "ignore_id=2" \
+-d "license_id=1" \
+http://localhost:3000/api/projects.json
+```
+
+```javascript
+await octokit.request('GET /api/projects.json')
+```
+
+### HTTP 请求
+`POST api/projects`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|user_id |是| |int |用户id或者组织id |
+|name |是| |string |项目名称 |
+|description |是| |string |项目描述 |
+|repository_name |是| |string |仓库名称, 只含有数字、字母、下划线不能以下划线开头和结尾,且唯一 |
+|project_category_id|是| |int |项目类别id |
+|project_language_id|是| |int |项目语言id |
+|ignore_id |否| |int |gitignore相关id |
+|license_id |否| |int |开源许可证id |
+|private |否| |boolean|项目是否私有, true:为私有,false: 公开,默认为公开 |
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |id |
+|name |string|项目名称|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "id": 3240,
+ "name": "好项目"
+}
+```
+
+
+## 创建镜像项目
+创建镜像项目
+
+> 示例:
+
+```shell
+curl -X POST \
+-d "user_id=36408" \
+-d "clone_addr=https://gitea.com/mx8090alex/golden.git" \
+-d "name=golden_mirror1" \
+-d "description=golden_mirror" \
+-d "project_category_id=1" \
+-d "project_language_id=2" \
+http://localhost:3000/api/projects/migrate.json
+```
+
+```javascript
+await octokit.request('GET /api/projects/migrate.json')
+```
+
+### HTTP 请求
+`POST api/projects/migrate.json`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|user_id |是| |int |用户id或者组织id |
+|name |是| |string |项目名称 |
+|clone_addr |是| |string |镜像项目clone地址 |
+|description |否| |string |项目描述 |
+|repository_name |是| |string |仓库名称, 只含有数字、字母、下划线不能以下划线开头和结尾,且唯一 |
+|project_category_id|是| |int |项目类别id |
+|project_language_id|是| |int |项目语言id |
+|is_mirror |否| |boolean|是否设置为镜像, true:是, false:否,默认为否 |
+|auth_username |否| |string|镜像源仓库的登录用户名 |
+|auth_password |否| |string|镜像源仓库的登录秘密 |
+|private |否| |boolean|项目是否私有, true:为私有,false: 非私有,默认为公开 |
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |id |
+|name |string|项目名称|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "id": 3241,
+ "name": "这是一个镜像项目"
+}
+```
+
+
+## 同步镜像
+手动同步镜像
+
+> 示例:
+
+```shell
+curl -X POST http://localhost:3000/api/repositories/1244/sync_mirror.json
+```
+
+```javascript
+await octokit.request('POST /api/repositories/1244/sync_mirror.json')
+```
+
+### HTTP 请求
+`POST api/repositories/:id/sync_mirror.json`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|id |是| |int |仓库id |
+
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int |状态码, 0:标识请求成功 |
+|message |string|服务端返回的信息说明|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+
+## Fork项目
+fork项目
+
+> 示例:
+
+```shell
+curl -X POST http://localhost:3000/api/jasder/forgeplus/forks.json
+```
+
+```javascript
+await octokit.request('POST /api/jaser/jasder_test/forks.json')
+```
+
+### HTTP 请求
+`POST api/:owner/:repo/forks.json`
+
+### 请求参数
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+### 返回字段说明
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |项目id |
+|identifier |string|项目标识|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "id": 3290,
+ "identifier": "newadm"
+}
+```
diff --git a/app/docs/slate/source/includes/_pulls.md b/app/docs/slate/source/includes/_pulls.md
new file mode 100644
index 00000000..1df50f6b
--- /dev/null
+++ b/app/docs/slate/source/includes/_pulls.md
@@ -0,0 +1 @@
+# Pulls
diff --git a/app/docs/slate/source/includes/_repositories.md b/app/docs/slate/source/includes/_repositories.md
new file mode 100644
index 00000000..40d3ba2f
--- /dev/null
+++ b/app/docs/slate/source/includes/_repositories.md
@@ -0,0 +1,869 @@
+# Repositories
+
+## 仓库详情
+仓库详情
+
+> 示例:
+
+```shell
+curl -X GET http://localhost:3000/api/jasder/jasder_test.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |id |
+|name |string|项目名称|
+|identifier |string|项目标识|
+|is_public |boolean|项目是否公开, true:公开,false:私有|
+|description |string|项目简介|
+|repo_id |int|仓库id|
+|repo_identifier|string|仓库标识|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "name": "ni项目",
+ "identifier": "mirror_demo",
+ "is_public": true,
+ "description": "my first project mirror_demo",
+ "repo_id": 75073,
+ "repo_identifier": "mirror_demo"
+}
+```
+
+
+## 仓库详情(简版)
+仓库详情
+
+> 示例:
+
+```shell
+curl -X GET http://localhost:3000/api/jasder/jasder_test/simple.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test/simple.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/simple`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |id |
+|name |string|项目名称|
+|identifier |string|项目标识|
+|is_public |boolean|项目是否公开, true:公开,false:私有|
+|description |string|项目简介|
+|repo_id |int|仓库id|
+|repo_identifier|string|仓库标识|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "name": "ni项目",
+ "identifier": "mirror_demo",
+ "is_public": true,
+ "description": "my first project mirror_demo",
+ "repo_id": 75073,
+ "repo_identifier": "mirror_demo"
+}
+```
+
+## 仓库详情(新版)
+仓库详情
+
+> 示例:
+
+```shell
+curl -X GET http://localhost:3000/api/yystopf/ceshi/detail.json
+```
+
+```javascript
+await octokit.request('GET /api/yystopf/ceshi/detail.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/detail`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|content |string |仓库简介 |
+|website |string |仓库网址 |
+|readme |string |readme文件|
+|identifier |string |项目标识 |
+|name |string |项目名称 |
+|issues_count |int |项目issue数量|
+|pull_requests_count |int |项目合并请求数量|
+|project_identifier |int |项目标识|
+|praises_count |int |项目点赞数量|
+|forked_count |int |项目复刻数量|
+|watchers_count |int |项目关注数量|
+|versions_count |int |项目里程碑数量|
+|version_releases_count |int |项目发行版数量|
+|version_releasesed_count |int |项目发行版已发行数量|
+|permission |string |项目权限|
+|mirror_url |string |镜像地址|
+|mirror |bool |是否为镜像项目|
+|type |int |项目类型 0 普通项目 1 普通镜像项目 2 同步镜像项目|
+|open_devops |int |是否开启devops|
+|watched |bool |是否关注|
+|praised |bool |是否点赞|
+|status |int |项目状态|
+|forked_from_project_id |int |fork项目id|
+|fork_info |object |fork项目信息|
+|size |string |仓库大小|
+|ssh_url |string |项目ssh地址|
+|clone_url |string |项目克隆地址|
+|default_branch |string |仓库默认分支|
+|empty |bool |仓库是否为空|
+|full_name |string |仓库全称|
+|private |bool |仓库是否为私有项目|
+|license_name |string |许可证名称|
+|release_versions.list.name |string |项目issue数量|
+|release_versions.list.tag_name |string |发行版标签名称|
+|release_versions.list.created_at |string |发行版创建时间|
+|release_versions.total_count |int |发行版数量|
+|branches.list.name |string |分支名称|
+|branches.total_count |int |分支数量|
+|tags.list.name |string |标签名称|
+|tags.total_count |int |标签数量|
+|contributors.list.contributions|int |贡献数量|
+|contributors.list.login |string |贡献者登录名|
+|contributors.list.name |string |贡献者用户名称|
+|contributors.list.image_url |string |贡献者头像|
+|languages |object |项目语言占比|
+
+> 返回的JSON示例:
+
+```json
+{
+ "content": "仓库简介",
+ "website": "仓库网址",
+ "readme": {
+ "type": "file",
+ "encoding": "base64",
+ "size": 9,
+ "name": "README.md",
+ "path": "README.md",
+ "content": "# ceshi\n\n",
+ "sha": ""
+ },
+ "identifier": "ceshi",
+ "name": "测试项目",
+ "project_id": 2,
+ "repo_id": 2,
+ "issues_count": 0,
+ "pull_requests_count": 0,
+ "project_identifier": "ceshi",
+ "praises_count": 0,
+ "forked_count": 0,
+ "watchers_count": 0,
+ "versions_count": 0,
+ "version_releases_count": 0,
+ "version_releasesed_count": 0,
+ "permission": "Reporter",
+ "mirror_url": null,
+ "mirror": false,
+ "type": 0,
+ "open_devops": false,
+ "watched": false,
+ "praised": false,
+ "status": 1,
+ "forked_from_project_id": 1,
+ "fork_info": {
+ "fork_form_name": "测试项目",
+ "fork_project_user_login": "ceshi_org",
+ "fork_project_identifier": "ceshi",
+ "fork_project_user_name": "ceshi_org"
+ },
+ "size": "25.0 KB",
+ "ssh_url": "virus@localhost:yystopf/ceshi.git",
+ "clone_url": "http://localhost:10080/yystopf/ceshi.git",
+ "default_branch": "master",
+ "empty": false,
+ "full_name": "yystopf/ceshi",
+ "private": false,
+ "license_name": "gnu-javamail-exception",
+ "release_versions": {
+ "list": [
+ {
+ "id": 2,
+ "name": "vvvv",
+ "tag_name": "v1.1",
+ "created_at": "2019-07-18 10:16"
+ }
+ ],
+ "total_count": 1
+ },
+ "branches": {
+ "list": [
+ {
+ "name": "master"
+ }
+ ],
+ "total_count": 1
+ },
+ "tags": {
+ "list": [
+ {
+ "name": "v1.1"
+ },
+ {
+ "name": "v1.0"
+ }
+ ],
+ "total_count": 2
+ },
+ "contributors": {
+ "list": [
+ {
+ "contributions": 1,
+ "gid": 2,
+ "login": "yystopf",
+ "type": "User",
+ "name": "yystopf",
+ "image_url": "avatars/User/b"
+ }
+ ],
+ "total_count": 1
+ },
+ "languages": {
+ "HTML": "50.9%",
+ "Ruby": "25.6%",
+ "JavaScript": "21.4%",
+ "CSS": "1.3%",
+ "CoffeeScript": "0.7%",
+ "Shell": "0.1%"
+ }
+}
+```
+
+## 编辑仓库信息
+编辑仓库信息
+
+> 示例:
+
+```shell
+curl -X GET http://localhost:3000/api/jasder/jasder_test/edit.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test/edit.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/edit.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|identifier |string |仓库标识 |
+|project_id |int|项目id|
+|project_name |string|项目名称|
+|project_identifier |string|项目标识|
+|project_description |string|项目简介|
+|project_category_id |int|项目类别id|
+|project_language_id |int|项目语言id|
+|private |boolean|项目是否私有, true:为私有,false: 公开 |
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "identifier": "project",
+ "project_id": 3263,
+ "project_name": "项目",
+ "project_identifier": "project identifier",
+ "project_description": "project description",
+ "project_category_id": 1,
+ "project_language_id": 2,
+ "private": false
+}
+```
+
+
+## 修改仓库信息
+修改仓库信息
+
+> 示例:
+
+```shell
+curl -X PATCH \
+-d "name=hnfl_demo" \
+-d "description=my first project" \
+-d "project_category_id=1" \
+-d "project_language_id=2" \
+-d "private=true" \
+http://localhost:3000/api/jasder/jasder_test.json
+```
+
+```javascript
+await octokit.request('PATCH /api/jasder/jasder_test.json')
+```
+
+### HTTP 请求
+`PATCH /api/:owner/:repo`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|id |是 | |int |项目id |
+|name |否 | |string |项目名称 |
+|description |否 | |string |项目描述 |
+|project_category_id|否 | |int |项目类别id |
+|project_language_id|否 | |int |项目语言id |
+|default_branch |否 | |string |默认分支名称 |
+|private |否 | |boolean|项目是否私有, true:为私有,false: 公开,默认为公开 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int|id |
+|identifier |string|项目标识|
+|name |string|项目名称|
+|description |string|项目简介|
+|project_category_id|int|项目类别id|
+|project_language_id|int|项目语言id|
+|private |否|boolean|项目是否私有, true:为私有,false: 公开,默认为公开 |
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "id": 3263,
+ "identifier": "project identifier",
+ "name": "project name",
+ "description": "project description",
+ "project_category_id": 1,
+ "project_language_id": 2,
+ "is_public": true
+}
+```
+
+
+## 删除仓库
+删除仓库
+
+> 示例:
+
+```shell
+curl -X DELETE http://localhost:3000/api/jasder/jasder_test.json
+```
+
+```javascript
+await octokit.request('DELETE /api/jasder/jasder_test.json')
+```
+
+### HTTP 请求
+`PATCH /api/:owner/:repo`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int|返回状态, 0: 表示操作成功 |
+|message |string|返回信息说明|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+
+
+## 添加仓库成员
+仓库中添加成员操作
+
+> 示例:
+
+```shell
+curl -X POST \
+-d "user_id=12" \
+http://localhost:3000/api/jasder/jasder_test/collaborators.json
+```
+
+```javascript
+await octokit.request('POST /api/jasder/jasder_test/collaborators.json')
+```
+
+### HTTP 请求
+`POST /api/:owner/:repo/collaborators.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|user_id |是|int | |用户id |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int|返回状态, 0: 表示操作成功 |
+|message |string|返回信息说明|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+
+
+## 删除仓库成员
+仓库中删除成员操作
+
+> 示例:
+
+```shell
+curl -X DELETE \
+-d "user_id=12" \
+http://localhost:3000/api/jasder/jasder_test/collaborators.json
+```
+
+```javascript
+await octokit.request('DELETE /api/jasder/jasder_test/collaborators.json')
+```
+
+### HTTP 请求
+`DELETE /api/:owner/:repo/collaborators.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|user_id |是|int | |用户id |
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int|返回状态, 0: 表示操作成功 |
+|message |string|返回信息说明|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+
+
+## 更改仓库成员角色(权限)
+更改仓库成员角色
+
+> 示例:
+
+```shell
+curl -X PUT \
+-d "user_id=12" \
+-d "role=Developer" \
+http://localhost:3000/api/jasder/jasder_test/change_role.json
+```
+
+```javascript
+await octokit.request('PUT /api/jasder/jasder_test/change_role.json')
+```
+
+### HTTP 请求
+`PUT /api/:owner/:repo/change_role.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|user_id |是|int | |用户id |
+|role |是|string | |取值范围:"Manager", "Developer", "Reporter";分别为项目管理人员(拥有所有操作权限)、项目开发人员(只拥有读写权限)、项目报告人员(只拥有读权限) |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|status |int|返回状态, 0: 表示操作成功 |
+|message |string|返回信息说明|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "status": 0,
+ "message": "success"
+}
+```
+
+
+
+## 获取仓库成员列表
+获取仓库成员列表
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "page=1" \
+-d "limit=5" \
+http://localhost:3000/api/jasder/jasder_test/collaborators.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test/collaborators.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/collaborators.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|page |否| |string |页数,第几页 |
+|limit |否| |string |每页多少条数据,默认15条 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|total_count |int |返回记录总条数 |
+|members |array|项目成员信息|
+|-- id |int|用户id|
+|-- name |string|用户名称|
+|-- login |string|用户登录名/标识|
+|-- image_url |string|用户头像|
+|-- is_owner |boolean|是否是项目的拥有者,true:是, false:不是|
+|-- role |string|该用户在项目中的角色, Manager: 管理员(拥有操作权限); Developer:开发人员(只拥有读写权限); Reporter:报告人员(只拥有读权限)|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "total_count": 2,
+ "members": [
+ {
+ "id": 36401,
+ "name": "name",
+ "login": "login",
+ "image_url": "avatars/User/b",
+ "is_owner": true,
+ "role": "Manager"
+ },
+ {
+ "id": 36399,
+ "name": "name",
+ "login": "login",
+ "image_url": "avatars/User/b",
+ "is_owner": false,
+ "role": "Developer"
+ }
+ ]
+}
+```
+
+
+## 获取仓库所有文件
+获取仓库所有文件
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "ref=develop" \
+http://localhost:3000/api/yystopf/ceshi/files.json
+```
+
+```javascript
+await octokit.request('GET /api/yystopf/ceshi/files.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/files`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|search |否| |string |文件搜索关键词 |
+|ref |是| |string |分支名,默认为仓库默认分支 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|name |string |文件名称|
+|path |string |文件路径|
+|sha |string |文件标识|
+|type |string |文件类型|
+|size |int |文件大小|
+|url |string |文件地址|
+
+
+> 返回的JSON示例:
+
+```json
+[
+ {
+ "name": ".gitignore",
+ "path": ".gitignore",
+ "sha": "f83922d01ae60f6e637a1a2b9f08871b4f87dfc8",
+ "type": "file",
+ "size": 63,
+ "url": "http://localhost:10080/api/v1/repos/yystopf/ceshi/contents/.gitignore?ref=master",
+ "html_url": "http://localhost:10080/yystopf/ceshi/src/branch/master/.gitignore"
+ },
+ {
+ "name": "LICENSE",
+ "path": "LICENSE",
+ "sha": "8f3b9ab0d08afd3a624d822e3971a2f42b3bc2b9",
+ "type": "file",
+ "size": 341,
+ "url": "http://localhost:10080/api/v1/repos/yystopf/ceshi/contents/LICENSE?ref=master",
+ "html_url": "http://localhost:10080/yystopf/ceshi/src/branch/master/LICENSE"
+ },
+ {
+ "name": "README.md",
+ "path": "README.md",
+ "sha": "1bc8a60ac6ddc876ebc4b60fc68991435bfad93e",
+ "type": "file",
+ "size": 9,
+ "url": "http://localhost:10080/api/v1/repos/yystopf/ceshi/contents/README.md?ref=master",
+ "html_url": "http://localhost:10080/yystopf/ceshi/src/branch/master/README.md"
+ }
+]
+```
+
+
+## 获取仓库代码目录
+获取仓库代码目录
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "ref=develop" \
+http://localhost:3000//api/jasder/jasder_test/entries.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test/entries.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/entries.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|ref |否| | string |分支名称、tag名称或是提交记录id,默认为master分支 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|last_commit |object |
+|-- commit |object |
+|id |int |id |
+|name |string|文件夹或文件名称|
+|path |string|文件夹或文件相对路径|
+|type |string|文件类型, file:文件,dir:文件目录
+|size |int|文件夹或文件大小 单位B
+|content |string|文件内容
+|target |string|标签
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "last_commit": {
+ "commit": {
+ "sha": "3f2de4f78d2d7050486535082cd11cdfc9f3679e",
+ "url": "http://localhost:3003//api/repositories/api-cloud-platform/commits/3f2de4f78d2d7050486535082cd11cdfc9f3679e",
+ "message": "update README.md.",
+ "author": {
+ "name": "Gitee",
+ "email": "noreply@gitee.com",
+ "date": "2020-03-02T20:23:18+08:00"
+ },
+ "committer": {
+ "name": "Gitee",
+ "email": "noreply@gitee.com",
+ "date": "2020-03-02T20:23:18+08:00"
+ },
+ "timestamp": 1583151798,
+ "time_from_now": "3个月前"
+ },
+ "author": null,
+ "committer": null
+ },
+ "entries": [
+ {
+ "name": "ace-gate",
+ "path": "ace-gate",
+ "sha": "c83f85fc63b14edcd6fc502eee9996f5a9993eca",
+ "type": "dir",
+ "size": 0,
+ "content": null,
+ "target": null,
+ "commit": {
+ "message": "v2.9 升级alibaba组件release版本\n",
+ "sha": "6117eaab86f71115f42f2a46ff1683015cda798d",
+ "created_at": "1970-01-01 08:00",
+ "time_from_now": "1年前",
+ "created_at_unix": null
+ }
+ }
+ ]
+}
+```
+
+
+
+## 获取仓库代码子目录或者文件
+获取仓库代码子目录或者文件
+
+> 示例:
+
+```shell
+curl -X GET \
+-d "ref=master" \
+-d "filepath=file" \
+http://localhost:3000//api/jasder/jasder_test/sub_entries.json
+```
+
+```javascript
+await octokit.request('GET /api/jasder/jasder_test/sub_entries.json')
+```
+
+### HTTP 请求
+`GET /api/:owner/:repo/sub_entries.json`
+
+### 请求参数:
+参数 | 必选 | 默认 | 类型 | 字段说明
+--------- | ------- | ------- | -------- | ----------
+|owner |是| |string |用户登录名 |
+|repo |是| |string |项目标识identifier |
+|filepath |是|string |文件夹、文件的相对路径 |
+|ref |否| | string |分支名称、tag名称或是提交记录id,默认为master分支 |
+
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|id |int |id |
+|name |string|文件夹或文件名称|
+|path |string|文件夹或文件相对路径|
+|type |string|文件类型, file:文件,dir:文件目录|
+|size |int|文件夹或文件大小 单位KB|
+|content |string|文件内容,|
+|target |string|标签|
+|url |string|文件访问链接,带分支|
+|html_url |string|文件访问链接,未标识分支|
+|git_url |string|文件夹或文件的git仓库访问链接|
+|download_url |string|文件下载、文件内容访问链接|
+
+
+> 返回的JSON示例:
+
+```json
+[
+ {
+ "name": "build.rc",
+ "path": "lib/build.rc",
+ "type": "",
+ "size": 1268,
+ "content": null,
+ "target": null,
+ "url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/contents/lib/build.rc?ref=master",
+ "html_url": "http://localhost:3003/18816895620/mirror_demo/src/branch/master/lib/build.rc",
+ "git_url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/git/blobs/191fcf1a63b3777e2977fcede7dd5309efdd70fe",
+ "download_url": null
+ }
+]
+```
+
diff --git a/app/docs/slate/source/includes/_teams.md b/app/docs/slate/source/includes/_teams.md
new file mode 100644
index 00000000..c50f6973
--- /dev/null
+++ b/app/docs/slate/source/includes/_teams.md
@@ -0,0 +1 @@
+# Teams
diff --git a/app/docs/slate/source/includes/_users.md b/app/docs/slate/source/includes/_users.md
new file mode 100644
index 00000000..62a6391e
--- /dev/null
+++ b/app/docs/slate/source/includes/_users.md
@@ -0,0 +1,42 @@
+# Users
+
+## 获取当前登陆用户信息
+获取当前登陆用户信息
+
+> 示例:
+
+```shell
+curl -X GET http://localhost:3000/api/users/me.json
+```
+
+```javascript
+await octokit.request('GET /api/users/me.json')
+```
+
+### HTTP 请求
+`GET api/users/me.json`
+
+### 返回字段说明:
+参数 | 类型 | 字段说明
+--------- | ----------- | -----------
+|user_id |int |用户id |
+|username |string|用户名称|
+|admin |boolean|是否为管理用户|
+|login |string|登录名|
+|image_url |string|用户头像|
+
+
+> 返回的JSON示例:
+
+```json
+{
+ "username": "username",
+ "login": "login",
+ "user_id": 100000,
+ "image_url": "avatars/User/b",
+ "admin": false
+}
+```
+
diff --git a/app/docs/slate/source/javascripts/all.js b/app/docs/slate/source/javascripts/all.js
new file mode 100644
index 00000000..5f5d4067
--- /dev/null
+++ b/app/docs/slate/source/javascripts/all.js
@@ -0,0 +1,2 @@
+//= require ./all_nosearch
+//= require ./app/_search
diff --git a/app/docs/slate/source/javascripts/all_nosearch.js b/app/docs/slate/source/javascripts/all_nosearch.js
new file mode 100644
index 00000000..026e5a20
--- /dev/null
+++ b/app/docs/slate/source/javascripts/all_nosearch.js
@@ -0,0 +1,27 @@
+//= require ./lib/_energize
+//= require ./app/_copy
+//= require ./app/_toc
+//= require ./app/_lang
+
+function adjustLanguageSelectorWidth() {
+ const elem = $('.dark-box > .lang-selector');
+ elem.width(elem.parent().width());
+}
+
+$(function() {
+ loadToc($('#toc'), '.toc-link', '.toc-list-h2', 10);
+ setupLanguages($('body').data('languages'));
+ $('.content').imagesLoaded( function() {
+ window.recacheHeights();
+ window.refreshToc();
+ });
+
+ $(window).resize(function() {
+ adjustLanguageSelectorWidth();
+ });
+ adjustLanguageSelectorWidth();
+});
+
+window.onpopstate = function() {
+ activateLanguage(getLanguageFromQueryString());
+};
diff --git a/app/docs/slate/source/javascripts/app/_copy.js b/app/docs/slate/source/javascripts/app/_copy.js
new file mode 100644
index 00000000..4dfbbb6c
--- /dev/null
+++ b/app/docs/slate/source/javascripts/app/_copy.js
@@ -0,0 +1,15 @@
+function copyToClipboard(container) {
+ const el = document.createElement('textarea');
+ el.value = container.textContent.replace(/\n$/, '');
+ document.body.appendChild(el);
+ el.select();
+ document.execCommand('copy');
+ document.body.removeChild(el);
+}
+
+function setupCodeCopy() {
+ $('pre.highlight').prepend('');
+ $('.copy-clipboard').on('click', function() {
+ copyToClipboard(this.parentNode.children[1]);
+ });
+}
diff --git a/app/docs/slate/source/javascripts/app/_lang.js b/app/docs/slate/source/javascripts/app/_lang.js
new file mode 100644
index 00000000..0fbaaef7
--- /dev/null
+++ b/app/docs/slate/source/javascripts/app/_lang.js
@@ -0,0 +1,164 @@
+//= require ../lib/_jquery
+
+/*
+Copyright 2008-2013 Concur Technologies, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may
+not use this file except in compliance with the License. You may obtain
+a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations
+under the License.
+*/
+;(function () {
+ 'use strict';
+
+ var languages = [];
+
+ window.setupLanguages = setupLanguages;
+ window.activateLanguage = activateLanguage;
+ window.getLanguageFromQueryString = getLanguageFromQueryString;
+
+ function activateLanguage(language) {
+ if (!language) return;
+ if (language === "") return;
+
+ $(".lang-selector a").removeClass('active');
+ $(".lang-selector a[data-language-name='" + language + "']").addClass('active');
+ for (var i=0; i < languages.length; i++) {
+ $(".highlight.tab-" + languages[i]).hide();
+ $(".lang-specific." + languages[i]).hide();
+ }
+ $(".highlight.tab-" + language).show();
+ $(".lang-specific." + language).show();
+
+ window.recacheHeights();
+
+ // scroll to the new location of the position
+ if ($(window.location.hash).get(0)) {
+ $(window.location.hash).get(0).scrollIntoView(true);
+ }
+ }
+
+ // parseURL and stringifyURL are from https://github.com/sindresorhus/query-string
+ // MIT licensed
+ // https://github.com/sindresorhus/query-string/blob/7bee64c16f2da1a326579e96977b9227bf6da9e6/license
+ function parseURL(str) {
+ if (typeof str !== 'string') {
+ return {};
+ }
+
+ str = str.trim().replace(/^(\?|#|&)/, '');
+
+ if (!str) {
+ return {};
+ }
+
+ return str.split('&').reduce(function (ret, param) {
+ var parts = param.replace(/\+/g, ' ').split('=');
+ var key = parts[0];
+ var val = parts[1];
+
+ key = decodeURIComponent(key);
+ // missing `=` should be `null`:
+ // http://w3.org/TR/2012/WD-url-20120524/#collect-url-parameters
+ val = val === undefined ? null : decodeURIComponent(val);
+
+ if (!ret.hasOwnProperty(key)) {
+ ret[key] = val;
+ } else if (Array.isArray(ret[key])) {
+ ret[key].push(val);
+ } else {
+ ret[key] = [ret[key], val];
+ }
+
+ return ret;
+ }, {});
+ };
+
+ function stringifyURL(obj) {
+ return obj ? Object.keys(obj).sort().map(function (key) {
+ var val = obj[key];
+
+ if (Array.isArray(val)) {
+ return val.sort().map(function (val2) {
+ return encodeURIComponent(key) + '=' + encodeURIComponent(val2);
+ }).join('&');
+ }
+
+ return encodeURIComponent(key) + '=' + encodeURIComponent(val);
+ }).join('&') : '';
+ };
+
+ // gets the language set in the query string
+ function getLanguageFromQueryString() {
+ if (location.search.length >= 1) {
+ var language = parseURL(location.search).language;
+ if (language) {
+ return language;
+ } else if (jQuery.inArray(location.search.substr(1), languages) != -1) {
+ return location.search.substr(1);
+ }
+ }
+
+ return false;
+ }
+
+ // returns a new query string with the new language in it
+ function generateNewQueryString(language) {
+ var url = parseURL(location.search);
+ if (url.language) {
+ url.language = language;
+ return stringifyURL(url);
+ }
+ return language;
+ }
+
+ // if a button is clicked, add the state to the history
+ function pushURL(language) {
+ if (!history) { return; }
+ var hash = window.location.hash;
+ if (hash) {
+ hash = hash.replace(/^#+/, '');
+ }
+ history.pushState({}, '', '?' + generateNewQueryString(language) + '#' + hash);
+
+ // save language as next default
+ localStorage.setItem("language", language);
+ }
+
+ function setupLanguages(l) {
+ var defaultLanguage = localStorage.getItem("language");
+
+ languages = l;
+
+ var presetLanguage = getLanguageFromQueryString();
+ if (presetLanguage) {
+ // the language is in the URL, so use that language!
+ activateLanguage(presetLanguage);
+
+ localStorage.setItem("language", presetLanguage);
+ } else if ((defaultLanguage !== null) && (jQuery.inArray(defaultLanguage, languages) != -1)) {
+ // the language was the last selected one saved in localstorage, so use that language!
+ activateLanguage(defaultLanguage);
+ } else {
+ // no language selected, so use the default
+ activateLanguage(languages[0]);
+ }
+ }
+
+ // if we click on a language tab, activate that language
+ $(function() {
+ $(".lang-selector a").on("click", function() {
+ var language = $(this).data("language-name");
+ pushURL(language);
+ activateLanguage(language);
+ return false;
+ });
+ });
+})();
diff --git a/app/docs/slate/source/javascripts/app/_search.js b/app/docs/slate/source/javascripts/app/_search.js
new file mode 100644
index 00000000..0b0ccd97
--- /dev/null
+++ b/app/docs/slate/source/javascripts/app/_search.js
@@ -0,0 +1,102 @@
+//= require ../lib/_lunr
+//= require ../lib/_jquery
+//= require ../lib/_jquery.highlight
+;(function () {
+ 'use strict';
+
+ var content, searchResults;
+ var highlightOpts = { element: 'span', className: 'search-highlight' };
+ var searchDelay = 0;
+ var timeoutHandle = 0;
+ var index;
+
+ function populate() {
+ index = lunr(function(){
+
+ this.ref('id');
+ this.field('title', { boost: 10 });
+ this.field('body');
+ this.pipeline.add(lunr.trimmer, lunr.stopWordFilter);
+ var lunrConfig = this;
+
+ $('h1, h2').each(function() {
+ var title = $(this);
+ var body = title.nextUntil('h1, h2');
+ lunrConfig.add({
+ id: title.prop('id'),
+ title: title.text(),
+ body: body.text()
+ });
+ });
+
+ });
+ determineSearchDelay();
+ }
+
+ $(populate);
+ $(bind);
+
+ function determineSearchDelay() {
+ if (index.tokenSet.toArray().length>5000) {
+ searchDelay = 300;
+ }
+ }
+
+ function bind() {
+ content = $('.content');
+ searchResults = $('.search-results');
+
+ $('#input-search').on('keyup',function(e) {
+ var wait = function() {
+ return function(executingFunction, waitTime){
+ clearTimeout(timeoutHandle);
+ timeoutHandle = setTimeout(executingFunction, waitTime);
+ };
+ }();
+ wait(function(){
+ search(e);
+ }, searchDelay);
+ });
+ }
+
+ function search(event) {
+
+ var searchInput = $('#input-search')[0];
+
+ unhighlight();
+ searchResults.addClass('visible');
+
+ // ESC clears the field
+ if (event.keyCode === 27) searchInput.value = '';
+
+ if (searchInput.value) {
+ var results = index.search(searchInput.value).filter(function(r) {
+ return r.score > 0.0001;
+ });
+
+ if (results.length) {
+ searchResults.empty();
+ $.each(results, function (index, result) {
+ var elem = document.getElementById(result.ref);
+ searchResults.append("" + $(elem).text() + "");
+ });
+ highlight.call(searchInput);
+ } else {
+ searchResults.html('');
+ $('.search-results li').text('No Results Found for "' + searchInput.value + '"');
+ }
+ } else {
+ unhighlight();
+ searchResults.removeClass('visible');
+ }
+ }
+
+ function highlight() {
+ if (this.value) content.highlight(this.value, highlightOpts);
+ }
+
+ function unhighlight() {
+ content.unhighlight(highlightOpts);
+ }
+})();
+
diff --git a/app/docs/slate/source/javascripts/app/_toc.js b/app/docs/slate/source/javascripts/app/_toc.js
new file mode 100644
index 00000000..f70bdc0f
--- /dev/null
+++ b/app/docs/slate/source/javascripts/app/_toc.js
@@ -0,0 +1,122 @@
+//= require ../lib/_jquery
+//= require ../lib/_imagesloaded.min
+;(function () {
+ 'use strict';
+
+ var htmlPattern = /<[^>]*>/g;
+ var loaded = false;
+
+ var debounce = function(func, waitTime) {
+ var timeout = false;
+ return function() {
+ if (timeout === false) {
+ setTimeout(function() {
+ func();
+ timeout = false;
+ }, waitTime);
+ timeout = true;
+ }
+ };
+ };
+
+ var closeToc = function() {
+ $(".toc-wrapper").removeClass('open');
+ $("#nav-button").removeClass('open');
+ };
+
+ function loadToc($toc, tocLinkSelector, tocListSelector, scrollOffset) {
+ var headerHeights = {};
+ var pageHeight = 0;
+ var windowHeight = 0;
+ var originalTitle = document.title;
+
+ var recacheHeights = function() {
+ headerHeights = {};
+ pageHeight = $(document).height();
+ windowHeight = $(window).height();
+
+ $toc.find(tocLinkSelector).each(function() {
+ var targetId = $(this).attr('href');
+ if (targetId[0] === "#") {
+ headerHeights[targetId] = $("#" + $.escapeSelector(targetId.substring(1))).offset().top;
+ }
+ });
+ };
+
+ var refreshToc = function() {
+ var currentTop = $(document).scrollTop() + scrollOffset;
+
+ if (currentTop + windowHeight >= pageHeight) {
+ // at bottom of page, so just select last header by making currentTop very large
+ // this fixes the problem where the last header won't ever show as active if its content
+ // is shorter than the window height
+ currentTop = pageHeight + 1000;
+ }
+
+ var best = null;
+ for (var name in headerHeights) {
+ if ((headerHeights[name] < currentTop && headerHeights[name] > headerHeights[best]) || best === null) {
+ best = name;
+ }
+ }
+
+ // Catch the initial load case
+ if (currentTop == scrollOffset && !loaded) {
+ best = window.location.hash;
+ loaded = true;
+ }
+
+ var $best = $toc.find("[href='" + best + "']").first();
+ if (!$best.hasClass("active")) {
+ // .active is applied to the ToC link we're currently on, and its parent s selected by tocListSelector
+ // .active-expanded is applied to the ToC links that are parents of this one
+ $toc.find(".active").removeClass("active");
+ $toc.find(".active-parent").removeClass("active-parent");
+ $best.addClass("active");
+ $best.parents(tocListSelector).addClass("active").siblings(tocLinkSelector).addClass('active-parent');
+ $best.siblings(tocListSelector).addClass("active");
+ $toc.find(tocListSelector).filter(":not(.active)").slideUp(150);
+ $toc.find(tocListSelector).filter(".active").slideDown(150);
+ if (window.history.replaceState) {
+ window.history.replaceState(null, "", best);
+ }
+ var thisTitle = $best.data("title");
+ if (thisTitle !== undefined && thisTitle.length > 0) {
+ document.title = thisTitle.replace(htmlPattern, "") + " – " + originalTitle;
+ } else {
+ document.title = originalTitle;
+ }
+ }
+ };
+
+ var makeToc = function() {
+ recacheHeights();
+ refreshToc();
+
+ $("#nav-button").click(function() {
+ $(".toc-wrapper").toggleClass('open');
+ $("#nav-button").toggleClass('open');
+ return false;
+ });
+ $(".page-wrapper").click(closeToc);
+ $(".toc-link").click(closeToc);
+
+ // reload immediately after scrolling on toc click
+ $toc.find(tocLinkSelector).click(function() {
+ setTimeout(function() {
+ refreshToc();
+ }, 0);
+ });
+
+ $(window).scroll(debounce(refreshToc, 200));
+ $(window).resize(debounce(recacheHeights, 200));
+ };
+
+ makeToc();
+
+ window.recacheHeights = recacheHeights;
+ window.refreshToc = refreshToc;
+ }
+
+ window.loadToc = loadToc;
+})();
diff --git a/app/docs/slate/source/javascripts/lib/_energize.js b/app/docs/slate/source/javascripts/lib/_energize.js
new file mode 100644
index 00000000..6798f3c0
--- /dev/null
+++ b/app/docs/slate/source/javascripts/lib/_energize.js
@@ -0,0 +1,169 @@
+/**
+ * energize.js v0.1.0
+ *
+ * Speeds up click events on mobile devices.
+ * https://github.com/davidcalhoun/energize.js
+ */
+
+(function() { // Sandbox
+ /**
+ * Don't add to non-touch devices, which don't need to be sped up
+ */
+ if(!('ontouchstart' in window)) return;
+
+ var lastClick = {},
+ isThresholdReached, touchstart, touchmove, touchend,
+ click, closest;
+
+ /**
+ * isThresholdReached
+ *
+ * Compare touchstart with touchend xy coordinates,
+ * and only fire simulated click event if the coordinates
+ * are nearby. (don't want clicking to be confused with a swipe)
+ */
+ isThresholdReached = function(startXY, xy) {
+ return Math.abs(startXY[0] - xy[0]) > 5 || Math.abs(startXY[1] - xy[1]) > 5;
+ };
+
+ /**
+ * touchstart
+ *
+ * Save xy coordinates when the user starts touching the screen
+ */
+ touchstart = function(e) {
+ this.startXY = [e.touches[0].clientX, e.touches[0].clientY];
+ this.threshold = false;
+ };
+
+ /**
+ * touchmove
+ *
+ * Check if the user is scrolling past the threshold.
+ * Have to check here because touchend will not always fire
+ * on some tested devices (Kindle Fire?)
+ */
+ touchmove = function(e) {
+ // NOOP if the threshold has already been reached
+ if(this.threshold) return false;
+
+ this.threshold = isThresholdReached(this.startXY, [e.touches[0].clientX, e.touches[0].clientY]);
+ };
+
+ /**
+ * touchend
+ *
+ * If the user didn't scroll past the threshold between
+ * touchstart and touchend, fire a simulated click.
+ *
+ * (This will fire before a native click)
+ */
+ touchend = function(e) {
+ // Don't fire a click if the user scrolled past the threshold
+ if(this.threshold || isThresholdReached(this.startXY, [e.changedTouches[0].clientX, e.changedTouches[0].clientY])) {
+ return;
+ }
+
+ /**
+ * Create and fire a click event on the target element
+ * https://developer.mozilla.org/en/DOM/event.initMouseEvent
+ */
+ var touch = e.changedTouches[0],
+ evt = document.createEvent('MouseEvents');
+ evt.initMouseEvent('click', true, true, window, 0, touch.screenX, touch.screenY, touch.clientX, touch.clientY, false, false, false, false, 0, null);
+ evt.simulated = true; // distinguish from a normal (nonsimulated) click
+ e.target.dispatchEvent(evt);
+ };
+
+ /**
+ * click
+ *
+ * Because we've already fired a click event in touchend,
+ * we need to listed for all native click events here
+ * and suppress them as necessary.
+ */
+ click = function(e) {
+ /**
+ * Prevent ghost clicks by only allowing clicks we created
+ * in the click event we fired (look for e.simulated)
+ */
+ var time = Date.now(),
+ timeDiff = time - lastClick.time,
+ x = e.clientX,
+ y = e.clientY,
+ xyDiff = [Math.abs(lastClick.x - x), Math.abs(lastClick.y - y)],
+ target = closest(e.target, 'A') || e.target, // needed for standalone apps
+ nodeName = target.nodeName,
+ isLink = nodeName === 'A',
+ standAlone = window.navigator.standalone && isLink && e.target.getAttribute("href");
+
+ lastClick.time = time;
+ lastClick.x = x;
+ lastClick.y = y;
+
+ /**
+ * Unfortunately Android sometimes fires click events without touch events (seen on Kindle Fire),
+ * so we have to add more logic to determine the time of the last click. Not perfect...
+ *
+ * Older, simpler check: if((!e.simulated) || standAlone)
+ */
+ if((!e.simulated && (timeDiff < 500 || (timeDiff < 1500 && xyDiff[0] < 50 && xyDiff[1] < 50))) || standAlone) {
+ e.preventDefault();
+ e.stopPropagation();
+ if(!standAlone) return false;
+ }
+
+ /**
+ * Special logic for standalone web apps
+ * See http://stackoverflow.com/questions/2898740/iphone-safari-web-app-opens-links-in-new-window
+ */
+ if(standAlone) {
+ window.location = target.getAttribute("href");
+ }
+
+ /**
+ * Add an energize-focus class to the targeted link (mimics :focus behavior)
+ * TODO: test and/or remove? Does this work?
+ */
+ if(!target || !target.classList) return;
+ target.classList.add("energize-focus");
+ window.setTimeout(function(){
+ target.classList.remove("energize-focus");
+ }, 150);
+ };
+
+ /**
+ * closest
+ * @param {HTMLElement} node current node to start searching from.
+ * @param {string} tagName the (uppercase) name of the tag you're looking for.
+ *
+ * Find the closest ancestor tag of a given node.
+ *
+ * Starts at node and goes up the DOM tree looking for a
+ * matching nodeName, continuing until hitting document.body
+ */
+ closest = function(node, tagName){
+ var curNode = node;
+
+ while(curNode !== document.body) { // go up the dom until we find the tag we're after
+ if(!curNode || curNode.nodeName === tagName) { return curNode; } // found
+ curNode = curNode.parentNode; // not found, so keep going up
+ }
+
+ return null; // not found
+ };
+
+ /**
+ * Add all delegated event listeners
+ *
+ * All the events we care about bubble up to document,
+ * so we can take advantage of event delegation.
+ *
+ * Note: no need to wait for DOMContentLoaded here
+ */
+ document.addEventListener('touchstart', touchstart, false);
+ document.addEventListener('touchmove', touchmove, false);
+ document.addEventListener('touchend', touchend, false);
+ document.addEventListener('click', click, true); // TODO: why does this use capture?
+
+})();
\ No newline at end of file
diff --git a/app/docs/slate/source/javascripts/lib/_imagesloaded.min.js b/app/docs/slate/source/javascripts/lib/_imagesloaded.min.js
new file mode 100644
index 00000000..e443a77d
--- /dev/null
+++ b/app/docs/slate/source/javascripts/lib/_imagesloaded.min.js
@@ -0,0 +1,7 @@
+/*!
+ * imagesLoaded PACKAGED v4.1.4
+ * JavaScript is all like "You images are done yet or what?"
+ * MIT License
+ */
+
+!function(e,t){"function"==typeof define&&define.amd?define("ev-emitter/ev-emitter",t):"object"==typeof module&&module.exports?module.exports=t():e.EvEmitter=t()}("undefined"!=typeof window?window:this,function(){function e(){}var t=e.prototype;return t.on=function(e,t){if(e&&t){var i=this._events=this._events||{},n=i[e]=i[e]||[];return n.indexOf(t)==-1&&n.push(t),this}},t.once=function(e,t){if(e&&t){this.on(e,t);var i=this._onceEvents=this._onceEvents||{},n=i[e]=i[e]||{};return n[t]=!0,this}},t.off=function(e,t){var i=this._events&&this._events[e];if(i&&i.length){var n=i.indexOf(t);return n!=-1&&i.splice(n,1),this}},t.emitEvent=function(e,t){var i=this._events&&this._events[e];if(i&&i.length){i=i.slice(0),t=t||[];for(var n=this._onceEvents&&this._onceEvents[e],o=0;o (default options)
+ * $('#content').highlight('lorem');
+ *
+ * // search for and highlight more terms at once
+ * // so you can save some time on traversing DOM
+ * $('#content').highlight(['lorem', 'ipsum']);
+ * $('#content').highlight('lorem ipsum');
+ *
+ * // search only for entire word 'lorem'
+ * $('#content').highlight('lorem', { wordsOnly: true });
+ *
+ * // don't ignore case during search of term 'lorem'
+ * $('#content').highlight('lorem', { caseSensitive: true });
+ *
+ * // wrap every occurrance of term 'ipsum' in content
+ * // with
+ * $('#content').highlight('ipsum', { element: 'em', className: 'important' });
+ *
+ * // remove default highlight
+ * $('#content').unhighlight();
+ *
+ * // remove custom highlight
+ * $('#content').unhighlight({ element: 'em', className: 'important' });
+ *
+ *
+ * Copyright (c) 2009 Bartek Szopka
+ *
+ * Licensed under MIT license.
+ *
+ */
+
+jQuery.extend({
+ highlight: function (node, re, nodeName, className) {
+ if (node.nodeType === 3) {
+ var match = node.data.match(re);
+ if (match) {
+ var highlight = document.createElement(nodeName || 'span');
+ highlight.className = className || 'highlight';
+ var wordNode = node.splitText(match.index);
+ wordNode.splitText(match[0].length);
+ var wordClone = wordNode.cloneNode(true);
+ highlight.appendChild(wordClone);
+ wordNode.parentNode.replaceChild(highlight, wordNode);
+ return 1; //skip added node in parent
+ }
+ } else if ((node.nodeType === 1 && node.childNodes) && // only element nodes that have children
+ !/(script|style)/i.test(node.tagName) && // ignore script and style nodes
+ !(node.tagName === nodeName.toUpperCase() && node.className === className)) { // skip if already highlighted
+ for (var i = 0; i < node.childNodes.length; i++) {
+ i += jQuery.highlight(node.childNodes[i], re, nodeName, className);
+ }
+ }
+ return 0;
+ }
+});
+
+jQuery.fn.unhighlight = function (options) {
+ var settings = { className: 'highlight', element: 'span' };
+ jQuery.extend(settings, options);
+
+ return this.find(settings.element + "." + settings.className).each(function () {
+ var parent = this.parentNode;
+ parent.replaceChild(this.firstChild, this);
+ parent.normalize();
+ }).end();
+};
+
+jQuery.fn.highlight = function (words, options) {
+ var settings = { className: 'highlight', element: 'span', caseSensitive: false, wordsOnly: false };
+ jQuery.extend(settings, options);
+
+ if (words.constructor === String) {
+ words = [words];
+ }
+ words = jQuery.grep(words, function(word, i){
+ return word != '';
+ });
+ words = jQuery.map(words, function(word, i) {
+ return word.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
+ });
+ if (words.length == 0) { return this; };
+
+ var flag = settings.caseSensitive ? "" : "i";
+ var pattern = "(" + words.join("|") + ")";
+ if (settings.wordsOnly) {
+ pattern = "\\b" + pattern + "\\b";
+ }
+ var re = new RegExp(pattern, flag);
+
+ return this.each(function () {
+ jQuery.highlight(this, re, settings.element, settings.className);
+ });
+};
+
diff --git a/app/docs/slate/source/javascripts/lib/_jquery.js b/app/docs/slate/source/javascripts/lib/_jquery.js
new file mode 100644
index 00000000..50937333
--- /dev/null
+++ b/app/docs/slate/source/javascripts/lib/_jquery.js
@@ -0,0 +1,10872 @@
+/*!
+ * jQuery JavaScript Library v3.5.1
+ * https://jquery.com/
+ *
+ * Includes Sizzle.js
+ * https://sizzlejs.com/
+ *
+ * Copyright JS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ *
+ * Date: 2020-05-04T22:49Z
+ */
+( function( global, factory ) {
+
+ "use strict";
+
+ if ( typeof module === "object" && typeof module.exports === "object" ) {
+
+ // For CommonJS and CommonJS-like environments where a proper `window`
+ // is present, execute the factory and get jQuery.
+ // For environments that do not have a `window` with a `document`
+ // (such as Node.js), expose a factory as module.exports.
+ // This accentuates the need for the creation of a real `window`.
+ // e.g. var jQuery = require("jquery")(window);
+ // See ticket #14549 for more info.
+ module.exports = global.document ?
+ factory( global, true ) :
+ function( w ) {
+ if ( !w.document ) {
+ throw new Error( "jQuery requires a window with a document" );
+ }
+ return factory( w );
+ };
+ } else {
+ factory( global );
+ }
+
+// Pass this if window is not defined yet
+} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
+
+// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
+// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
+// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
+// enough that all such attempts are guarded in a try block.
+"use strict";
+
+var arr = [];
+
+var getProto = Object.getPrototypeOf;
+
+var slice = arr.slice;
+
+var flat = arr.flat ? function( array ) {
+ return arr.flat.call( array );
+} : function( array ) {
+ return arr.concat.apply( [], array );
+};
+
+
+var push = arr.push;
+
+var indexOf = arr.indexOf;
+
+var class2type = {};
+
+var toString = class2type.toString;
+
+var hasOwn = class2type.hasOwnProperty;
+
+var fnToString = hasOwn.toString;
+
+var ObjectFunctionString = fnToString.call( Object );
+
+var support = {};
+
+var isFunction = function isFunction( obj ) {
+
+ // Support: Chrome <=57, Firefox <=52
+ // In some browsers, typeof returns "function" for HTML