Korean Translation Architecture
Relevant source files
The following files were used as context for generating this wiki page:
The Korean Translation Architecture represents a structured effort to localize "The Architecture of Open Source Applications" (AOSA) book series. The project involves converting the original HTML-based content into a localized Markdown format, organizing translated metadata, and managing a substantial local repository of technical illustrations and diagrams. This architecture ensures that the complex architectural insights of open source projects are accessible to Korean-speaking developers while maintaining the integrity of the original series.
Sources: CLAUDE.md:1-10, korean_translation/metadata/index.html.md:1-20
Project Structure and Organization
The translation project mirrors the original book's multi-volume structure, organizing content into four primary categories: Volume 1, Volume 2, Performance of Open Source Applications (POSA), and 500 Lines or Less. Each section contains translated chapters and associated technical metadata.
Directory Hierarchy
The diagram shows the hierarchical organization of the translation project, including localized metadata and image assets.
Sources: CLAUDE.md:14-27, download_summary.md:11-50
Content Components
The project maintains several key components for each volume:
- Translated Chapters: Markdown files following the
{chapter-number}_{chapter-name}.html.mdconvention. - Metadata Files: Localized versions of indices, FAQs, and licensing information.
- Image Assets: A locally hosted collection of diagrams and covers, organized to match the book's structure.
Sources: CLAUDE.md:30-45, korean_translation/metadata/index.html.md:25-100
Asset Management and Localization
A critical part of the architecture is the local management of visual assets. To prevent broken links and ensure offline accessibility, the project transitioned from remote URLs to a local image repository.
Image Distribution Statistics
| Category | Image Count | Content Scope |
|---|---|---|
| Volume 1 | 121 | Asterisk, Eclipse, LLVM, etc. |
| Volume 2 | 118 | Git, nginx, SQLAlchemy, etc. |
| POSA | 62 | Performance-related diagrams |
| 500 Lines | 90 | Small-scale project implementations |
| Metadata | 4 | Book cover images |
Sources: download_summary.md:52-60
Image Migration Workflow
This flow illustrates the systematic approach used to localize external image dependencies into the korean_translation/ directory structure.
Sources: download_summary.md:62-85
Technical Localization Implementation
The localization process goes beyond text translation, involving the adaptation of technical documentation structures and the inclusion of region-specific resources.
Metadata Localization
The project localizes core metadata files such as the Table of Contents (index.html.md) and the Frequently Asked Questions (faq.html.md). These files include:
- Translated Author and Reviewer Credits: Ensuring contributors are recognized in the target language.
- Localized Resource Links: Recommendations for related software design books available in the region.
- Internal Navigation: Maintaining the anchor-based linking system used in the original book for consistent cross-referencing.
Sources: korean_translation/metadata/index.html.md:25-150, korean_translation/metadata/faq.html.md:1-15
Image Reference System
The architecture utilizes a centralized mapping system to maintain asset integrity.
- Mapping Tool:
image_mapping.jsonserves as the master manifest linking original remote URLs to local relative paths. - Downloader Scripts: Custom Python (
download_images.py) and Bash (download_images.sh) scripts are employed for automated asset retrieval and validation.
Sources: download_summary.md:62-75
Project Summary
The Korean Translation Architecture provides a robust framework for localizing a major technical literary work. By combining a mirrored directory structure with a centralized asset management system and localized metadata, the project ensures that the architectural insights of the AOSA series remain technically accurate and visually complete for the Korean developer community.
Sources: CLAUDE.md:1-10, korean_translation/posa/00_introduction.html.md:10-30