Skip to content

[GH-2911] Translate Tutorial / Programming Guide (part 3) to Chinese#2934

Open
jiayuasu wants to merge 1 commit intoapache:masterfrom
jiayuasu:feature/docs-i18n-tutorial-part3
Open

[GH-2911] Translate Tutorial / Programming Guide (part 3) to Chinese#2934
jiayuasu wants to merge 1 commit intoapache:masterfrom
jiayuasu:feature/docs-i18n-tutorial-part3

Conversation

@jiayuasu
Copy link
Copy Markdown
Member

@jiayuasu jiayuasu commented May 8, 2026

Did you read the Contributor Guide?

Is this PR related to a ticket?

What changes were proposed in this PR?

Phase 4c of the Chinese-documentation EPIC (#2867). Adds Chinese (zh) translations for 2 more tutorial pages on top of the 23 merged in earlier phases.

Translated in this PR:

  • raster (764 lines)
  • snowflake/sql (618 lines)

Deferred to Phase 4d: tutorial/rdd.md (871 lines) and tutorial/sql.md (1,438 lines). Splitting keeps each PR review-able — these two combined would be ~5,000 translated lines.

After this PR, 25 of 27 tutorial pages have Chinese versions on the docs site. The remaining 2 pages still fall back to English content automatically via fallback_to_default: true.

Code blocks, command snippets, version macros ({{ sedona.current_version }}, {{ sedona.current_geotools }}), admonitions, and inline tab attributes (=== "Scala", etc.) are preserved verbatim. Only prose, headings, table headers, and explanatory inline comments are translated.

How was this patch tested?

Built the docs locally with uv sync --group docs && uv run mkdocs build and verified:

  • The build succeeds with no new warnings introduced by Phase 4c.
  • The 2 new *.zh.md files render under /zh/tutorial/ and /zh/tutorial/snowflake/.
  • pre-commit run --all-files passes (license headers auto-added by insert-license, re-staged before commit).

Did this PR include necessary documentation updates?

  • Yes, this PR is itself a documentation translation. Phase 4d will translate the final 2 tutorial pages (rdd.md, sql.md).

…inese

Phase 4c of apache#2867. Adds Chinese translations for 2 of the remaining 4
large tutorial pages. The 2 very largest pages (rdd 871 lines, sql
1,438 lines) are deferred to Phase 4d so each PR stays review-able.

Files translated in this PR:
- raster
- snowflake/sql

Combined with Phase 4a (apache#2931) and 4b (apache#2933), 25 of 27 tutorial
pages now have Chinese versions on the docs site.

Code blocks, command snippets, version macros, admonitions, and tab
attributes are preserved verbatim. Only prose, headings, table
headers, and explanatory inline comments are translated.
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.

1 participant