Skip to content

feat: Re-migrate blog articles with English slugs#66

Merged
Nliver merged 7 commits into
blogfrom
xgopilot/issue-51-1769606643
Jan 29, 2026
Merged

feat: Re-migrate blog articles with English slugs#66
Nliver merged 7 commits into
blogfrom
xgopilot/issue-51-1769606643

Conversation

@fennoai
Copy link
Copy Markdown

@fennoai fennoai Bot commented Jan 29, 2026

Requested by @Nliver

This PR re-migrates all 21 blog articles from Chinese slugs to English slugs for better SEO and international audience reach.

Summary

  • ✅ Migrated 21 articles from Chinese filenames to English slugs
  • ✅ Updated frontmatter slugs to follow /blog/2025/english-slug format
  • ✅ Configured editUrl to point to blog branch for direct GitHub editing
  • ✅ Created automated translation script for slug conversion
  • ✅ Verified build succeeds with new URL structure

Changes

Article Slug Translations

All articles have been renamed with descriptive English slugs:

Original (Chinese) New (English)
工程实践分享-把小事做好 engineering-practice-doing-small-things-well
工程实践分享写代码不是第一步 engineering-practice-coding-is-not-first-step
同学为什么我建议你关注-1024-实训营 why-you-should-join-1024-techcamp
当-ai-能写代码工程师的核心竞争力是什么 engineer-core-competitiveness-in-ai-era
我眼中的优秀工程师特质 qualities-of-excellent-engineers
一行之差为什么你的文件末尾应该留一个空行 why-end-files-with-newline
从类型系统理解-xgo-编译器的实现 understanding-xgo-compiler-through-type-system
ai-重构软件开发从工具到规则的范式革命 ai-reshaping-software-development-paradigm-shift
许式伟聊-ai-时代下的工程师发展观 xu-shiwei-on-engineer-development-in-ai-era
许式伟发布-xgo-全景图ai-时代的全民编程语言 xu-shiwei-releases-xgo-roadmap-programming-for-all
github-pr-合并三选一主分支该怎么选 github-pr-merge-strategies-which-to-choose
如何才算完成一个ai应用 what-makes-ai-application-complete
从类型系统理解-llgo-编译器的实现 understanding-llgo-compiler-through-type-system
code-review-不是什么 what-code-review-is-not
架构设计该从何入手 where-to-start-architecture-design
关于架构设计的几点认知体会 insights-on-architecture-design
spx-algorithm构建多模态搜索服务的一些心得 spx-algorithm-building-multimodal-search-service
代码不是核心从-xlink-项目看产品开发的决策层次 code-is-not-core-decision-layers-in-xlink-project
llpyg-llgo-快速集成-python-生态的桥梁 llpyg-bridge-for-llgo-python-integration
x绘图-让ai融入产品 xdraw-integrating-ai-into-products
llgo-python-编译与运行时集成 llgo-python-compilation-and-runtime-integration

Configuration Updates

Docusaurus Config (website/docusaurus.config.ts):

editUrl: ({blogPath}: {blogPath: string}) => {
  return `https://github.com/qiniu/techcamp/edit/blog/website/blog/${blogPath}`;
}

This ensures "Edit this page" links point to the blog branch for direct editing.

Migration Script

Added translate_to_english_slugs.py - automated script that:

  • Maps Chinese titles to English slugs
  • Renames files with English slugs
  • Updates frontmatter with new slug format
  • Maintains all metadata (authors, tags, dates, descriptions)

Benefits

  1. SEO Improvement: English URLs are more search-engine friendly
  2. International Reach: Better accessibility for non-Chinese speakers
  3. URL Stability: Semantic English slugs are easier to remember and share
  4. Direct Editing: Edit URLs point to blog branch for streamlined workflow

Testing

  • ✅ Build succeeds: npm run build passes
  • ✅ All 21 articles migrated successfully
  • ✅ All frontmatter validated
  • ✅ Image references maintained

Closes #51

Nliver and others added 6 commits October 29, 2025 14:29
* update(docs):Fix document outline and update article expressions

* Update 2025/21. LLGo 中 Python 编译与运行时集成/content.md

Signed-off-by: Nliver <34496563+Nliver@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
- Built with Astro for fast, content-focused static site generation
- Responsive, mobile-first design with dark mode support
- Blog system with Markdown/MDX support
- Tag-based categorization and filtering
- RSS feed for blog posts
- SEO-friendly URLs
- Clean, minimal design inspired by modern dev sites

Resolves #51

Generated with codeagent (https://github.com/qbox/codeagent)
Co-authored-by: Nliver <34496563+Nliver@users.noreply.github.com>
- Built Docusaurus static site and moved files to root directory
- Added .nojekyll file to prevent Jekyll processing
- Site can now be deployed by selecting blog branch (root /) in Pages settings
- Includes built HTML/CSS/JS for landing page, blog, and documentation

This allows GitHub Pages deployment without GitHub Actions by simply
configuring Settings > Pages to use the blog branch and root directory.

Generated with [codeagent](https://github.com/qbox/codeagent)
Co-authored-by: Nliver <34496563+Nliver@users.noreply.github.com>
- Migrated 21 technical articles from 2025/ directory to website/blog/
- Added proper Docusaurus frontmatter with slug, title, authors, tags, date, description
- Configured 9 tags: ai, go, compiler, engineering, architecture, xgo, llgo, python, career
- Copied 15 images to website/static/img/blog/ directory
- Updated all image references to use correct paths
- Fixed YAML frontmatter issues and MDX compatibility
- All articles now build successfully

Articles cover topics:
- AI and engineering (19 articles)
- Architecture design (19 articles)
- Career development (14 articles)
- Go and compiler technology (11 articles)
- XGo/LLGo compilers (11 articles)

Date range: 2025-01-15 to 2025-02-24

Generated with [codeagent](https://github.com/qbox/codeagent)
Co-authored-by: Nliver <34496563+Nliver@users.noreply.github.com>
…URLs

- Translate all 21 article filenames from Chinese to English slugs
- Update frontmatter slugs to follow /blog/2025/english-slug format
- Configure editUrl to point to blog branch for direct editing
- Add translation script for automated slug conversion
- Verify build succeeds with new slug structure

Generated with codeagent
Co-authored-by: Nliver <34496563+Nliver@users.noreply.github.com>
Signed-off-by: Nliver <34496563+Nliver@users.noreply.github.com>
@Nliver Nliver merged commit 27a0af1 into blog Jan 29, 2026
@fennoai fennoai Bot deleted the xgopilot/issue-51-1769606643 branch January 29, 2026 13:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants