Fix debug module documentation structure

- Create overview page for FileLogSink (filelogsink/filelogsink.md)
- Create constructor page for FileLogSink (filelogsink/construct.md)
- Create overview page for ConsoleLogSink (consolelogsink/overview.md)
- Fix self-referencing links in FileLogSink and ConsoleLogSink constructor pages

The constructor pages were incorrectly linking to themselves as 'overview' pages.
Created proper overview pages that list all public methods and link to their
individual documentation pages.
This commit is contained in:
2026-03-19 01:22:11 +08:00
parent 7e4c48d4f9
commit 2076a484d4
4 changed files with 96 additions and 16 deletions

View File

@@ -1,23 +1,37 @@
# FileLogSink::FileLogSink
# FileLogSink
**命名空间**: `XCEngine::Debug`
**类型**: `class`
**头文件**: `XCEngine/Debug/FileLogSink.h`
**描述**: 文件日志输出目标,将日志写入到指定文件。
## 概述
`FileLogSink` 是日志系统的文件输出实现。它将日志条目写入到指定的文件,支持追加写入模式。
## 公共方法
| 方法 | 描述 |
|------|------|
| `FileLogSink(const Containers::String& filePath)` | [构造函数](construct.md) |
| `~FileLogSink()` | [析构函数](~filelogsink.md) |
| `void Log(const LogEntry& entry)` | [输出日志到文件](log.md) |
| `void Flush()` | [刷新缓冲区](flush.md) |
## 使用示例
```cpp
FileLogSink(const Containers::String& filePath)
```
#include <XCEngine/Debug/FileLogSink.h>
构造函数,打开指定路径的文件用于日志写入。如果文件已存在,则追加写入;如果不存在,则创建新文件。
**参数:**
- `filePath` - 日志文件路径
**复杂度:** O(1)
**示例:**
```cpp
auto fileSink = std::make_unique<XCEngine::Debug::FileLogSink>("logs/engine.log");
auto fileSink = std::make_unique<XCEngine::Debug::FileLogSink>("logs/app.log");
XCEngine::Debug::Logger::Get().AddSink(std::move(fileSink));
```
## 相关文档
- [FileLogSink 总览](filelogsink.md) - 返回总览
- [Debug 模块总览](../debug.md) - 返回模块总览
- [Logger](../logger/logger.md) - 日志记录器
- [ILogSink](../ilogsink/ilogsink.md) - 日志输出接口