guidebook 0.1.28

HonKit/GitBook compatible static book generator
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# Cấu hình

Cấu hình là tùy chọn. guidebook hoạt động mà không cần cấu hình.

## book.json

Tạo file `book.json` trong thư mục gốc của sách:

```json
{
    "title": "Sách của tôi",
    "description": "Mô tả sách",
    "author": "Tên tác giả",
    "plugins": [
        "collapsible-chapters",
        "back-to-top-button",
        "mermaid-md-adoc"
    ],
    "styles": {
        "website": "styles/website.css"
    }
}
```

## Tùy chọn

| Tùy chọn | Mô tả | Mặc định |
|----------|-------|----------|
| `title` | Tiêu đề sách | `"My Book"` |
| `description` | Mô tả sách | `""` |
| `author` | Tên tác giả | `""` |
| `plugins` | Plugin được bật | Xem bên dưới |
| `styles.website` | File CSS tùy chỉnh | `null` |

## Plugin mặc định

Các plugin sau được bật mặc định (không cần cấu hình):

- `collapsible-chapters` - Sidebar có thể thu gọn
- `back-to-top-button` - Nút quay lại đầu trang
- `mermaid-md-adoc` - Hỗ trợ biểu đồ Mermaid

Để tắt plugin mặc định, thêm tiền tố `-`:

```json
{
    "plugins": ["-mermaid-md-adoc"]
}
```

## CSS tùy chỉnh

Tạo file CSS và tham chiếu trong `book.json`:

```css
/* styles/website.css */
.book {
    font-family: "Noto Sans", sans-serif;
}

.markdown-section h2 {
    border-left: 4px solid #007acc;
    padding-left: 10px;
}
```