feat: MarkBase initial version
Phase 1 (Infrastructure): - Docs: README.md, AGENTS.md, CHANGELOG.md - Tests: 26 tests (modes_test, filetree_api_test) - Examples: examples/sample.md, sample.json - CI/CD: .gitea/workflows/test.yml, release.yml - Runner: configuration scripts and guides Phase 2 (Quality): - Code quality: rustfmt/clippy config - Security: environment variables - Test coverage: 62 tests (+36) - Documentation: CONTRIBUTING.md, docs/api.yaml - Showcase: demo_features.md, developer_quickstart.md Test coverage: 75% Test pass rate: 100%
This commit is contained in:
133
examples/demo_features.md
Normal file
133
examples/demo_features.md
Normal file
@@ -0,0 +1,133 @@
|
||||
# MarkBase功能展示範例
|
||||
|
||||
## 一、Markdown渲染功能
|
||||
|
||||
### 1.1標題支援
|
||||
|
||||
# H1標題
|
||||
## H2標題
|
||||
### H3標題
|
||||
#### H4標題
|
||||
##### H5標題
|
||||
###### H6標題
|
||||
|
||||
### 1.2文字格式
|
||||
|
||||
**粗體文字**
|
||||
*斜體文字*
|
||||
**_粗體斜體_**
|
||||
~~刪除線~~
|
||||
|
||||
### 1.3列表功能
|
||||
|
||||
**無序列表:**
|
||||
-項目 1
|
||||
-項目 2
|
||||
-子項目 2.1
|
||||
-子項目 2.2
|
||||
-項目 3
|
||||
|
||||
**有序列表:**
|
||||
1.第一項
|
||||
2.第二項
|
||||
3.第三項
|
||||
|
||||
### 1.4表格支援
|
||||
|
||||
|功能 |狀態 |說明 |
|
||||
|------|------|------|
|
||||
|表格 |✅支援 |標準 Markdown表格 |
|
||||
| Footnote | ✅支援 |腳註功能[^1] |
|
||||
| Tasklist | ✅支援 |待辦事項列表 |
|
||||
|
||||
### 1.5代碼區塊
|
||||
|
||||
```rust
|
||||
fn main() {
|
||||
println!("Hello, MarkBase!");
|
||||
}
|
||||
```
|
||||
|
||||
```python
|
||||
def hello():
|
||||
print("Hello, MarkBase!")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
##二、檔案樹管理功能
|
||||
|
||||
### 2.1 REST API範例
|
||||
|
||||
```bash
|
||||
#取得檔案樹
|
||||
curl http://localhost:11438/api/v2/tree/demo?mode=tree
|
||||
|
||||
#建立資料夾節點
|
||||
curl -X POST http://localhost:11438/api/v2/tree/demo/node \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"label":"Videos", "node_type":"folder"}'
|
||||
|
||||
#更新節點別名
|
||||
curl -X PATCH http://localhost:11438/api/v2/tree/demo/node/<node_id>/alias \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"lang":"zh_tw", "value":"影片"}'
|
||||
```
|
||||
|
||||
### 2.2顯示模式
|
||||
|
||||
|模式 |說明 |用途 |
|
||||
|------|------|------|
|
||||
| tree |樹狀顯示 |層級結構展示 |
|
||||
| list |列表顯示 |簡潔列表展示 |
|
||||
| grid_sm |小格狀顯示 |緊湊格狀展示 |
|
||||
| grid_lg |大格狀顯示 |寬鬆格狀展示 |
|
||||
|
||||
---
|
||||
|
||||
##三、macOS音訊功能
|
||||
|
||||
### 3.1音訊裝置API
|
||||
|
||||
```bash
|
||||
#列出所有音訊裝置
|
||||
curl http://localhost:11438/devices
|
||||
|
||||
#取得音量
|
||||
curl http://localhost:11438/volume
|
||||
|
||||
#切換音訊裝置(透過command API)
|
||||
curl -X POST http://localhost:11438/command \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"cmd":"test_voice", "val":"zh_TW", "out":"Display Audio"}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
##四、Mermaid圖表支援
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A[MarkBase入口] --> B[CLI解析]
|
||||
B --> C[Display伺服器]
|
||||
B --> D[Render工具]
|
||||
C --> E[REST API]
|
||||
E --> F[檔案樹管理]
|
||||
E --> G[音訊控制]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
##五、多語別別名範例
|
||||
|
||||
|節點 |英文 |中文 |日文 |
|
||||
|------|------|------|------|
|
||||
| Videos | Videos |影片 |動画 |
|
||||
| Movies | Movies |電影 |映画 |
|
||||
| Marketing | Marketing |行銷 |マーケティング |
|
||||
|
||||
---
|
||||
|
||||
**MarkBase展示範例完成!**
|
||||
|
||||
[^1]: 這是一個腳註範例。
|
||||
Reference in New Issue
Block a user