How jitkio/myblog works
myBlog is a public knowledge-base and blog site, with SiYuan used as a content editor and a separate Node.js/React site for publishing. Readers browse the home feed, article index and folder tree, search, and open stable article links; the frontend requests published content from the server, which indexes Markdown and serves article data. Administrators can trigger SiYuan synchronization, which exports Markdown and media into runtime data before the site refreshes. The README documents these capabilities; some server internals were not excerpted, so those subsystem links cite the README rather than implying unshown calls.
Main entry points: App.jsx Application shell · index.js HTTP application · content.js Content requests · DirectoryPage.jsx Directory browser
Components 21
Reader experience
- Application shell
site/src/App.jsx - Site header
site/src/components/SiteHeader.jsx - Search dialog
site/src/components/SearchDialog.jsx - Home feed
site/src/pages/HomePage.jsx - Article index
site/src/pages/ArticlesPage.jsx - Article reader
site/src/pages/ArticlePage.jsx - Management tools
site/src/pages/ToolsPage.jsx
Content navigation
- Directory browser
site/src/pages/DirectoryPage.jsx - Directory tree
site/src/components/DirectoryTree.jsx - URL routing
site/shared/routes.js - Path navigation
site/shared/navigation.js - Markdown renderer
site/src/lib/markdown.js - Content requests
site/src/lib/content.js
Publishing services
- HTTP application
site/server/index.js - Published content index
site/server/index.js - Navigation builder
site/server/navigation.js
Content synchronization
- SiYuan export and sync
site/server/index.js
Other components
- Reader
- Site administrator
- SiYuan
- Content and runtime data
Connections 24
- Reader → Application shell: browses
README.md - Application shell → Site header: renders
site/src/App.jsx - Application shell → Home feed: renders
site/src/App.jsx - Application shell → Article index: renders
site/src/App.jsx - Application shell → Article reader: renders
site/src/App.jsx - Application shell → Directory browser: renders
site/src/App.jsx - Application shell → Management tools: renders
site/src/App.jsx - Application shell → URL routing: parses URLs
site/src/App.jsx - URL routing → Path navigation: decodes paths
site/shared/routes.js - Application shell → Content requests: fetches content
site/src/App.jsx - Application shell → Search dialog: opens search
site/src/App.jsx - Search dialog → Content requests: requests results
site/src/components/SearchDialog.jsx - Directory browser → Directory tree: renders tree
site/src/pages/DirectoryPage.jsx - Article reader → Markdown renderer: renders Markdown
site/src/pages/ArticlePage.jsx - Directory browser → Content requests: loads overview
site/src/pages/DirectoryPage.jsx - Content requests → HTTP application: requests API
README.md - HTTP application → Published content index: builds index
site/server/index.js - Published content index → Navigation builder: builds navigation
site/server/index.js - HTTP application → Content and runtime data: reads and writes
README.md - Site administrator → Management tools: manages content
README.md - Management tools → HTTP application: requests sync
README.md - SiYuan → SiYuan export and sync: exports Markdown
README.md - SiYuan export and sync → Content and runtime data: writes articles and media
README.md - SiYuan export and sync → SiYuan: calls API
README.md