How heart-fire-project/midsoul-wiki works
MidSoul-Wiki is the official player-facing wiki for 午夜灵魂, with an in-browser visual editor for maintaining its documentation. Readers enter through the homepage and navigate game-system articles; authors select files, edit structured Tiptap documents, and save synchronized editor-source and Markdown files. The graph preserves the README’s documented content areas. Editor save details are based on the README; some internal wiring is omitted because the sampled source excerpts are incomplete.
Main entry points: editor.tsx Editor workspace · FileTree.tsx Document file tree · Content/index.tsx Document wrapper · pages/index.tsx Wiki homepage
Components 27
Wiki experience
- Wiki homepage
src/pages/index.tsx
Game documentation
- Game documentation
docs/午夜灵魂 - Global mechanics
docs/午夜灵魂/1. 全局机制.md - Game modes
docs/午夜灵魂/2. 模式介绍.md - Map guide
docs/午夜灵魂/3. 地图导览.md - Abilities
docs/午夜灵魂/4. 能力一览.md - Echo records
docs/午夜灵魂/5. 回响记录.md - Progress milestones
docs/午夜灵魂/6. 进度碑刻.md - Accessories
docs/午夜灵魂/7. 饰品集册.md - Accessory text sets
docs/午夜灵魂/8. 饰品集册-文本套组详览.md - Markdown documents
docs
Visual editor
- Editor workspace
src/pages/editor.tsx - Document file tree
src/components/editorWorkspace/FileTree.tsx - File operations
src/components/editorWorkspace/fsTree.ts - Tiptap editor
src/components/editor/TiptapEditor.tsx - Editor extensions
src/components/editor/extensions.ts - Markdown import
src/components/editor/fromMarkdown.js - Markdown export
src/components/editor/toMarkdown.js - Tiptap JSON source
docs - Session draft recovery
Document rendering
- Document wrapper
src/theme/DocItem/Content/index.tsx - Rich data tables
src/components/DataTable.tsx - Color tables
src/components/ColorTable.tsx - Anchor navigation
src/theme/Root.tsx
Other components
- Wiki reader
- Documentation author
- Browser file system
Connections 27
- Wiki reader → Wiki homepage: opens
- Wiki homepage → Game documentation: links to
- Wiki reader → Global mechanics: reads
- Wiki reader → Game modes: reads
- Wiki reader → Map guide: reads
- Wiki reader → Abilities: reads
- Wiki reader → Echo records: reads
- Wiki reader → Progress milestones: reads
- Wiki reader → Accessories: reads
- Wiki reader → Accessory text sets: reads
- Document wrapper → Rich data tables: renders tables
- Document wrapper → Color tables: renders tables
- Anchor navigation → Document wrapper: navigates anchors
- Documentation author → Editor workspace: opens editor
- Editor workspace → Document file tree: displays files
- Document file tree → File operations: manages files
- File operations → Browser file system: reads and writes
- Document file tree → Editor workspace: opens document
- Editor workspace → Tiptap editor: edits content
- Tiptap editor → Editor extensions: uses extensions
- Editor workspace → Markdown import: imports Markdown
- Editor workspace → Markdown export: exports Markdown
- Editor workspace → Session draft recovery: saves recovery draft
- Editor workspace → Tiptap JSON source: writes first
- Editor workspace → Markdown documents: exports on save
- Tiptap JSON source → Editor workspace: loads for editing
- Markdown documents → Editor workspace: imports when needed