How lin327/sre-wiki works
SRE Atlas is a bilingual, primarily Chinese static operations knowledge site. Readers browse or search published Linux, Docker, Kubernetes, and related guides; canonical content is eligible for search and sitemap discovery, while drafts in src/inbox/ are held for human review and PR handoff. Astro configures the route index, wikilink transformation, and discovery filtering; MDX components and the shared layout support rendered pages. The README documents Pagefind search and Docker/nginx hosting. Some UI and layout wiring is inferred from documented capabilities and the tree rather than inspected source.
Main entry points: pages Published pages · BaseLayout.astro Shared layout · remark-wikilinks.mjs Wikilink plugin · route-index.mjs Route index
Components 22
Content and publishing
- Published pages
src/pages - Review drafts
src/inbox - Content metadata
src/lib/content-metadata.mjs - Publish contract
src/lib/publish-contract.mjs - Route index
src/lib/route-index.mjs - Wikilink plugin
src/lib/remark-wikilinks.mjs - Link audit
scripts/report-broken-links.mjs
Site rendering
- Shared layout
src/layouts/BaseLayout.astro - MDX components
src/components/mdx/mdx-components.ts - MDX widgets
src/components/mdx - Theme controls
src/components/react/ThemeToggle.tsx - Language switcher
src/components/react/LanguageSwitcher.tsx - Diagram renderer
src/components/react/Mermaid.tsx
Search and discovery
- Search UI
src/components/react/PagefindSearch.tsx - Pagefind search
- Discovery policy
src/lib/discovery-policy.mjs
Identity
- Auth button
src/components/react/AuthButton.tsx - Auth client
src/lib/auth-client.ts
Other components
- Reader
- Auth service
- Mermaid CDN
- Static host
Connections 22
- Reader → Shared layout: browses
README.md - Published pages → Shared layout: renders as
README.md - Review drafts → Published pages: human PR handoff
README.md - Published pages → Content metadata: metadata read
src/lib/content-metadata.mjs - Publish contract → Content metadata: validates with
src/lib/publish-contract.mjs - Publish contract → Wikilink plugin: compiles with
src/lib/publish-contract.mjs - Wikilink plugin → Route index: resolves against
src/lib/remark-wikilinks.mjs - Link audit → Route index: loads and resolves
scripts/report-broken-links.mjs - Link audit → Wikilink plugin: parses with
scripts/report-broken-links.mjs - MDX components → MDX widgets: maps components
src/components/mdx/mdx-components.ts - MDX components → Diagram renderer: registers
src/components/mdx/mdx-components.ts - Diagram renderer → Mermaid CDN: loads runtime
src/components/react/Mermaid.tsx - Search UI → Pagefind search: queries
README.md - Reader → Search UI: searches
README.md - Discovery policy → Published pages: filters routes
- Route index → Published pages: indexes routes
- Wikilink plugin → Route index: configured with
astro.config.mjs - Theme controls → Shared layout: controls appearance
README.md - Language switcher → Shared layout: switches locale
README.md - Auth button → Auth client: calls
src/components/react/AuthButton.tsx - Auth client → Auth service: connects to
src/lib/auth-client.ts - Shared layout → Static host: served by
README.md