文章索引
Mermaid Diagram Examples and Syntax Quick Reference
Mermaid works well in doc sites for flowcharts, sequence diagrams, and class diagrams. It writes directly in Markdown / MDX, has low maintenance cost, and is easier to update than screenshots.
Creating a Topic Directory Workflow
The standard process for adding a new topic directory in this repo, covering topic index pages, stable English paths, and sidebar entries for dedicated sections.
Docs Intro Page Maintenance Workflow
How to maintain the docs entry page after migrating from plain Markdown to an MDX custom component, including stats generation and verification steps.
Internationalization Workflow
Standard process for adding English translations alongside new docs or blog posts, covering directory mirroring, frontmatter rules, MDX compatibility pitfalls, and build verification.
Blog Creation Automation Workflow
The standard AI handoff workflow for turning a user's "I want to create a new blog post" request into source gathering, image handling, bilingual posts, review pauses, TTS, troubleshooting, verification, and optional commits.
giscus Comments
Documents the giscus comments component, including repository setup, automatic mounting, bilingual discussion mapping, testing, and maintenance rules.
Troubleshooting Docker Hub Pull Failures on Aliyun ECS
Problem Background
Hosting a Static Site on Aliyun OSS
A practical guide to Aliyun OSS static site hosting, covering use cases, ICP filing, domain binding, and when to retire your server.
Amap Coordinate Drift
Root cause, fix, and rules for GPS coordinate drift when rendering photo EXIF points on Amap (Gaode) base maps.
Displaying Apple HEIF Photos on the Web
A quick guide to converting iPhone HEIF photos for web display
Setting Up a Mac From Zero
打开「Setting Up a Mac From Zero」查看完整内容与上下文。
Dark Mode Visitor Map Troubleshooting
Problem Background
Docs Audio Workflow
Complete workflow for generating, uploading, integrating, and maintaining TTS narration audio for documentation articles.
Dual CDN Split-Traffic Failure Postmortem
A postmortem of an attempt to use Aliyun DNS split-resolution for domestic Aliyun CDN and overseas Cloudflare Free CDN, exposing the capability limits of Cloudflare Free on CNAME setup, certificates, and rules.
Embedding PDF Files With PdfEmbed
This approach uses the PdfEmbed React component in the repo to embed PDF files hosted on OSS or other static resource services into Docusaurus MDX documents. The component internally uses `` for PDF preview, while providing "open in new tab" and "download PDF" links, so you don't need to repeat inline iframe boilerplate in every document.
CUDA Cache Streaming Optimization Guide (MDX Edition)
A complete guide to CUDA Cache Streaming optimization, from theory to practical application
Life Blog Writing Workflow
Conventions for the default writing style, image handling, source material format, and delivery checklist for life-record blog posts in this repo.
Navbar Weather Widget Strategy
Product strategy, default city fallback, click-to-authorize geolocation, caching, AMap JSAPI dependency, and troubleshooting for the navbar weather widget.
Rocky Linux New System Configuration
Software to Install on a New Rocky Machine
Recovering WeChat Files from a Time Machine Backup
Here is what happened.
Travel Album and Map Implementation Notes
The complete implementation approach, file responsibilities, and design trade-offs for the Travel section -- from source drafts and image metadata to map data and frontend rendering.
Travel Photo Metadata Workflow
Specifications for preserving, checking, generating, validating, and AI-handling photo metadata in this repo's travel album pages.