study/chsrc
1
0
Fork 0
mirror of https://github.com/RubyMetric/chsrc synced 2025-07-13 18:25:58 +08:00
Code Issues Packages Projects Releases Wiki Activity

format

Browse Source
This commit is contained in:
Mikachu2333 2025-06-17 00:31:43 +08:00 committed by ccmywish
parent cacc70029a
commit 7f0888c9da
3 changed files with 61 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/01-Develop.md
View File

@ -28,9 +28,9 @@ $ git clone https://gitee.com/RubyMetric/chsrc.git -b dev
## 编译运行
```bash
$ make # 默认使用 cc 编译
$ make CC=clang # 使用 clang 编译
$ make CC=gcc # 使用 gcc 编译
make # 默认使用 cc 编译
make CC=clang # 使用 clang 编译
make CC=gcc # 使用 gcc 编译
```
```bash
@ -49,11 +49,11 @@ $ make DEBUG=1
## 测试
```bash
$ make test-xy # 测试 xy.h
$ make test-fw # 测试 framework
$ make test # 测试上述两个
$ make test-cli # 测试命令
$ make clean
make test-xy # 测试 xy.h
make test-fw # 测试 framework
make test # 测试上述两个
make test-cli # 测试命令
make clean
```
<br>

12
doc/02-Write-A-Recipe-Even-If-You-Dont-Know-C.md
View File

@ -12,7 +12,7 @@
# Write A Recipe Even If You Don't Know C
# 介绍
## 介绍
**`chsrc` 不仅是一个命令行工具，同时也是一个体现了 Ruby on Rails 思想的 MVC 换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。**
@ -28,8 +28,8 @@
6. 已有大量 `recipe` 可提供参考，并提供了 [recipe template] 供直接使用
7. 提供持续关注镜像站可用性的协作平台:
1. https://github.com/RubyMetric/chsrc/wiki
2. https://github.com/RubyMetric/chsrc/discussions
1. <https://github.com/RubyMetric/chsrc/wiki>
2. <https://github.com/RubyMetric/chsrc/discussions>
<br>
@ -40,7 +40,7 @@
<br>
# 基本概念
## 基本概念
1. `target`: 所要换源的目标
@ -59,7 +59,7 @@
<br>
# 编写 `recipe` 步骤
## 编写 `recipe` 步骤
1. 确定你要编写的 `target` 的标准名称，创建 `Target-Name.c` 文件
@ -90,7 +90,7 @@
<br>
# 开发准则
## 开发准则
1. 代码高度可移植

52
doc/04-MAINTAINERS.md
View File

@ -10,12 +10,10 @@
**目前项目的发展阶段还处于 *外行实现内行* 的情况，比如 Homebrew recipe，实现者根本不是 Homebrew 的真实用户，只是根据各种文档来实现，然后等待用户反馈。所以这里当前的实现者最多只能是 Maintainer，无法承担 Director 的责任**
2. **Maintainers**
维护者：实现和持续维护 recipe，需要和 Director 一起 review 代码。可参考 [03-CONTRIBUTING.md](./03-CONTRIBUTING.md) 了解项目是如何进行提交和审阅代码的
3. **Observers**
观察者：对该 target 和 recipe 持续反馈和关注的用户。如果你觉得你无法承担作为维护者的责任，可以退而求其次作为观察者积极参与其中
@ -28,7 +26,6 @@
<br>
## Framework
1. **Director**: `@ccmywish` `@gitee:G_I_Y`
@ -37,80 +34,94 @@
<br>
## 编程语言
### Ruby
1. **Director**: `@ccmywish`
2. **Maintainers**:
3. **Observers**:
### Python
1. **Director**:
2. **Maintainers**: `@ccmywish` `@happy-game`
3. **Observers**:
### NodeJS
1. **Director**:
2. **Maintainers**: `@ccmywish` `@happy-game`
3. **Observers**:
### Perl
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### PHP
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Go
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Rust
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Java
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Clojure
1. **Director**:
2. **Maintainers**:
3. **Observers**:
### NuGet
1. **Director**:
2. **Maintainers**:
3. **Observers**:
### Dart
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Haskell
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### OCaml
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### R
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**: `@gitee:tfcolin`
### Julia
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
@ -120,166 +131,197 @@
## 操作系统
### Ubuntu
1. **Director**: `@ccmywish`
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**: `@wickdynex`
### Debian
1. **Director**:
2. **Maintainers**: `@ccmywish` `@gitee:G_I_Y`
3. **Observers**: `@happy-game`
### Fedora
1. **Director**:
2. **Maintainers**: `@ccmywish` `@gitee:G_I_Y` `@happy-game`
3. **Observers**:
### Kali
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**:
### Linux Mint
1. **Director**:
2. **Maintainers**: `@ccmywish` `@gitee:G_I_Y`
3. **Observers**:
### Armbian
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Raspberry Pi OS
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### ROS
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**:
### Trisquel
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Arch
1. **Director**:
2. **Maintainers**: `@ccmywish` `@gitee:G_I_Y` `@happy-game`
3. **Observers**:
### Manjaro
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**:
### msys2
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**:
### Alpine
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### OpenWrt
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**: `@happy-game`
### Gentoo
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**:
### Void Linux
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### deepin
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**:
### OpenKylin
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**:
### OpenEuler
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y`
3. **Observers**:
### FreeBSD
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**: `@ykla`
### NetBSD
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**:
### OpenBSD
1. **Director**:
2. **Maintainers**: `@gitee:G_I_Y` `@ccmywish`
3. **Observers**:
<br>
## 软件
### Homebrew
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**: `@wickdynex`
### WinGet
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Flathub
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Nix
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Guix
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### CocoaPods
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Docker Hub
1. **Director**:
2. **Maintainers**: `@ccmywish` `@happy-game`
3. **Observers**:
### Anaconda
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**: `@happy-game`
### Emacs
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**:
### Tex Live
1. **Director**:
2. **Maintainers**: `@ccmywish`
3. **Observers**: