hiroaki

This article organizes the steps I took to implement multi-language support (i18n) on a Docusaurus site, enabling content switching between Japanese (default) and English.

Based on the official documentation, this guide also includes practical tips for real-world scenarios, such as commands for a Docker environment and reliable methods for verifying functionality before deployment.

Prerequisites:

• Site Generator: Docusaurus (project already set up)
• Development Environment: Docker (local environment commands are also provided)
• Goal: To support two languages: Japanese (ja) and English (en)

This article is a record of the journey from identifying to resolving two tricky problems I encountered when adding internationalization (i18n) to a site built with Docusaurus v3: "client-side routing collapse" and "container startup failure on Cloud Run."

Prerequisites:

• Site Generator: Docusaurus v3
• Hosting: Google Cloud Run
• Development & Deployment: Docker, GitHub Actions
• Package Manager: pnpm

This article organizes the main specifications and technical points from when I implemented a simple, client-side browser memo feature on a Docusaurus site using React and TypeScript.

1. Basic Features and Purpose​

To provide a feature that allows users to easily create and save text memos in their browser, with the content persisting on subsequent visits. The focus is on ease of use and responsiveness by having everything run entirely on the client-side (using the browser's localStorage) without any server-side processing.

This article outlines three main patterns for displaying icons or specific symbols in the navigation bar of a Docusaurus site.

1. Displaying with Text and Symbols​

This is the most direct and simple method for displaying icons or symbols in navigation items. It is achieved by writing directly into the label property within the Docusaurus configuration file.

This article organizes the procedures and troubleshooting records from when I implemented a GitHub Action to detect new articles and post them to X as Twitter Cards.

Feature: Detect new posts with GitHub Actions and post them to X as Twitter Cards.

This article organizes the steps I took to introduce Docker Compose for the local development environment of a Docusaurus project.

Background:

To standardize the local development environment and simplify setup, I introduced Docker Compose to my Docusaurus (v3.8.0) project. Before this, I was running Node.js (v22.16.0) and pnpm (v10.11) by installing them directly on each developer's local machine.

This article organizes the steps and troubleshooting process I went through when setting up a site search feature using Algolia DocSearch.

A Record of Implementing Algolia DocSearch in Docusaurus​

References:

• https://docusaurus.io/docs/search
• https://docsearch.algolia.com/docs/api/#indexname

Service Used:

• Algolia DocSearch

This article outlines the steps to set up the custom domain hkdocs.com, purchased from Value Domain, for this Docusaurus site hosted on Google Cloud Run.

Prerequisites:

• Domain: hkdocs.com (already purchased from Value Domain)
• Hosting: Google Cloud Run
• Site Generator: Docusaurus