docs: 修复了贡献文档,重新对 README 排版

This commit is contained in:
2025-09-28 08:47:38 +00:00
parent 028e00d7f1
commit 4c48febd41
3 changed files with 29 additions and 19 deletions
+16 -6
View File
@@ -1,6 +1,15 @@
# OUC Server ![](docs/爱特logo.svg)
# OUC Server
<div align="center">
<img src="docs/爱特logo.svg" width=100/>
</div>
<div align="center">
<img src="docs/Organization-ITstudio-shield.svg"/>
<img src="https://img.shields.io/badge/Language-C++17-blue">
<img src="https://img.shields.io/badge/Package-CMake-red">
</div>
![](docs/Organization-ITstudio-shield.svg)
本项目由中国海洋大学爱特工作室组织开发,目标是基于 Linux 构建一个 **高性能、可扩展的现代 C++ HTTP 网络编程库**,为学习和实践网络编程提供平台,同时探索事件驱动架构、异步 I/O、协议封装等关键技术。
@@ -9,7 +18,7 @@
- 提供简洁易用的 **Socket 封装** 接口
- 支持 **多路复用**epoll/kqueue等)
- 内置 **事件循环****任务调度**
- 扩展常用协议(HTTP、WebSocket等)
- 封装常用协议(HTTP、WebSocket等)
- 作为教学和研究平台,便于社团成员学习与贡献
## 🚀 快速开始
@@ -34,7 +43,7 @@ make -j4
### 📖 运行示例
```bash
./examples
./example
```
### 📂 仓库结构
@@ -43,7 +52,7 @@ make -j4
ouc_server
├── include/ # 公共头文件
├── src/ # 源代码
├── examples/ # 示例程序
├── example/ # 示例程序
├── tests/ # 单元测试
├── docs/ # 文档
├── CMakeLists.txt
@@ -55,7 +64,7 @@ ouc_server
我们欢迎任何形式的贡献!
1. Fork 本仓库
2. 从 dev 分支新建功能分支 feature/...
2.`dev` 分支新建功能分支 `feature/...`
3. 提交 Pull Request,并等待 Review
4. 通过 CI 检查和 Review 后合并到主仓库
@@ -74,4 +83,5 @@ ouc_server
哈哈,没写
## 📜 许可证
本项目采用 [MIT License](/LICENSE) 开源。
+5 -7
View File
@@ -75,18 +75,16 @@
## 🎨 代码风格
- 使用 **C++17** 标准。
- 缩进统一为 **4 空格**。
- 文件名统一小写,单词用下划线分隔(如 `event_loop.h`)。
- 类名采用 **大驼峰命名**(如 `EventLoop`)。
- 函数与变量采用 **小写加下划线**(如 `start_server()``buffer_size`)。
- 公共接口需要写清楚 **Doxygen 风格注释**
详见 [代码规范](code_style.md)
---
## 🔍 Code Review 原则
详见 [代码规范](code_style.md)
- 确认代码可读、可维护,避免冗余实现。
- 注意异常处理、内存管理和线程安全问题。
- 保证接口一致性和合理性。
- 审查通过后,才能合并到 `dev` 分支。
---
+8 -6
View File
@@ -6,7 +6,7 @@
- 使用 **C++17** 或更高版本。
- 优先使用标准库功能,避免非必要的第三方依赖。
- 引入第三方依赖时,若有 CMake 或 Github 仓库时应避免直接复制文件于本项目。
- 引入第三方依赖时,若有 CMake 或 Github 仓库时应避免 **直接复制文件于本项目**
## 2. 文件与目录命名
@@ -126,7 +126,7 @@
```cpp
int sum = a + b;
```
- 控制语句中除单语句及 `do while` 外均需要添加大括号作用域:
- 控制语句中除单语句及 `do while` 外均需要 **添加大括号作用域**
- 条件分支
```cpp
// Wrong!
@@ -212,18 +212,20 @@
3. 第三方库头文件
4. 其他模块头文件
模块内部的头文件应当利用 CMake 配置后 **使用尖括号而非双引号** 包含。
示例:
```cpp
#include "tcp_server.hpp"
#include <server/tcp_server.hpp>
#include <vector>
#include <string>
#include <iostream>
#include "third_party/some_c_lib.h"
#include "third_party/some_cpp_lib.hpp"
#include <third_party/some_c_lib.h>
#include <third_party/some_cpp_lib.hpp>
#include "event_loop.hpp"
#include <event/event_loop.hpp>
```
## 10. 测试与调试