Developer shares step-by-step guide to building a bilingual blog with MkDocs
A developer has published a detailed walkthrough on building a personal blog using MkDocs Material, covering the full setup from dependency management to deployment. The blog is designed to support English and Chinese content simultaneously, using a directory-based convention and tag filtering rather than a dedicated i18n plugin. Posts are written in Markdown, with GitHub Actions automating site builds and deployments to GitHub Pages on every push. The setup incorporates features such as RSS, search with CJK tokenisation, giscus comments powered by GitHub Discussions, and Google Analytics 4. Custom styling inspired by the Atom One Dark Pro colour palette is applied via a single CSS override file, with distinct themes for dark and light modes.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in