mkdocs.yml
5.7 KB
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
site_name: xly (小羚羊) ERP — Framework Wiki
site_description: Developer / module-builder wiki for the xly printing-industry ERP framework.
site_url: ""
use_directory_urls: true
docs_dir: docs
site_dir: ../site/en
theme:
name: material
custom_dir: ../overrides
language: en
features:
- navigation.instant
- navigation.tracking
- navigation.sections
- navigation.indexes
- navigation.top
- search.suggest
- search.highlight
- content.code.copy
- toc.follow
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
primary: indigo
accent: indigo
toggle:
icon: material/brightness-7
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: indigo
accent: indigo
toggle:
icon: material/brightness-4
name: Switch to light mode
# Search separator: whitespace + common punctuation + dots + HTML entities + CJK punctuation.
# CamelCase splitter removed \u2014 code-identifier searches like "BusinessBaseServiceImpl" or
# "MyBatis" now match the whole identifier instead of being chopped into [Business, Base,
# Service, Impl] (which produced 1.9k spurious matches and lost the ranked exact hit).
# Lunr supports wildcard suffixes (e.g. `Service*`) for partial-token search if needed.
# For true Chinese tokenization, jieba is invoked by the catalog generator at index time
# (see scripts/gen_catalog.py). Mid-term improvement: a custom mkdocs plugin to feed
# jieba-segmented terms into lunr.
plugins:
- search:
separator: '[\s\-,;:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|[\u3000-\u303f\uff00-\uffef]'
markdown_extensions:
- admonition
- attr_list
- def_list
- footnotes
- md_in_html
- tables
- toc:
permalink: true
toc_depth: 4
- pymdownx.details
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.snippets
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tabbed:
alternate_style: true
- pymdownx.tasklist:
custom_checkbox: true
nav:
- Home: index.md
- 1. Mental Model:
- concepts/index.md
- The data-driven thesis: concepts/thesis.md
- Modules, forms, virtual tables: concepts/modules-forms-vtables.md
- Master / slave document pattern: concepts/master-slave.md
- "No-FK, semantic-FK reality": concepts/semantic-fk.md
- Two customization channels: concepts/customization-channels.md
- Customization layers: concepts/customization-layers.md
- Multi-tenancy and product editions: concepts/multi-tenancy.md
- The metadata-driven request lifecycle: concepts/request-lifecycle.md
- The three API tiers: concepts/api-surface.md
- 2. Vertical Slices:
- slices/index.md
- "Slice 1: a CRUD module (Hello World)": slices/01-hello-world.md
- "Slice 2: multi-tenancy and product editions": slices/02-multi-tenancy.md
- "Slice 3: a module with a report": slices/03-report.md
- "Slice 4: extending — a custom field": slices/04-custom-field.md
- "Slice 5: extending — a per-customer SQL override": slices/05-customer-sql-override.md
- "Slice 6: a hardware-integrated module (xlyPlc)": slices/06-hardware.md
- "Slice 7 (deferred): a module with workflow": slices/07-workflow.md
- 3. Reference (Builder):
- reference/builder/index.md
- "How to define a form": reference/builder/define-form.md
- "How to define a virtual table": reference/builder/define-vtable.md
- "How to attach a workflow": reference/builder/attach-workflow.md
- "How to set permissions": reference/builder/permissions.md
- 4. Reference (Maintainer):
- reference/maintainer/index.md
- "Running xlyEntry locally": reference/maintainer/running-locally.md
- "Tech stack": reference/maintainer/tech-stack.md
- "The runtime: BusinessBaseController & friends": reference/maintainer/runtime.md
- "Generic procedure dispatch": reference/maintainer/proc-dispatch.md
- "Cache invalidation on metadata change": reference/maintainer/cache-invalidation.md
- "SQL templates (xlyEntry/templesql/)": reference/maintainer/sql-templates.md
- "Multi-service deployment": reference/maintainer/deployment.md
- "Metadata-management services (xlyManage)": reference/maintainer/management-services.md
- "BI / KPI / Charts engine": reference/maintainer/bi-engine.md
- "Activiti integration": reference/maintainer/activiti.md
- "Known issues in stored procedures and functions": reference/maintainer/known-issues-in-stored-procedures.md
- 5. API Reference:
- api-reference/index.md
- "Internal API (xlyEntry)": api-reference/internal.md
- "External API (xlyApi)": api-reference/external.md
- "Inbound webhooks (xlyInterface)": api-reference/webhooks.md
- "Messaging (ActiveMQ / RocketMQ)": api-reference/messaging.md
- "Notifications (xlyMsg)": api-reference/notifications.md
- 6. Auto-Catalog:
- auto-catalog/index.md
- Tables: auto-catalog/tables/index.md
- Views: auto-catalog/views/index.md
- Procedures: auto-catalog/procedures/index.md
- Functions: auto-catalog/functions/index.md
- 7. Glossary:
- glossary/index.md
- 8. Contributing:
- contributing/index.md
extra:
alternate:
- name: English
link: /en/
lang: en
- name: 简体中文
link: /zh/
lang: zh
generator: false
# Build strict mode is OFF for now (lots of empty stubs would otherwise fail).
# Re-enable once chapters are filled in.
strict: false