Skip to content

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

Merged
jiayuasu merged 1 commit intoapache:masterfrom
jiayuasu:feature/docs-i18n-tutorial-part2
May 8, 2026
Merged

[GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese#2933
jiayuasu merged 1 commit intoapache:masterfrom
jiayuasu:feature/docs-i18n-tutorial-part2

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 4b of the Chinese-documentation EPIC (#2867). Adds Chinese (zh) translations for 6 more tutorial pages on top of the 17 merged in #2931.

Translated in this PR (6 files, ~2,500 lines of source content):

  • files/: geoparquet-sedona-spark, stac-sedona-spark
  • geopandas-shapely, geopandas-api
  • concepts/: spatial-joins
  • flink/: sql

Deferred to Phase 4c (4 large files, ~3,690 lines combined): tutorial/sql.md (1,438 lines), tutorial/rdd.md (871), tutorial/raster.md (764), tutorial/snowflake/sql.md (618). These individually warrant their own focused review pass.

After this PR, 23 of 27 tutorial pages have Chinese versions on the docs site.

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 4b.
  • 6 new *.zh.md files render under /zh/tutorial/, /zh/tutorial/concepts/, /zh/tutorial/files/, /zh/tutorial/flink/.
  • The 4 untranslated pages still fall back to English content via fallback_to_default: true.
  • pre-commit run --all-files passes including blacken-docs (which auto-added the ASF license headers — re-staged before commit).

Did this PR include necessary documentation updates?

  • Yes, this PR is itself a documentation translation. Phase 4c will translate the remaining 4 tutorial pages.

…inese

Phase 4b of apache#2867. Adds Chinese translations for 6 of the remaining
10 tutorial pages. The 4 largest pages (sql, rdd, raster,
snowflake/sql; ~3,690 lines combined) are deferred to Phase 4c so
each PR stays review-able.

Files translated in this PR:
- files/: geoparquet-sedona-spark, stac-sedona-spark
- geopandas-shapely, geopandas-api
- concepts/: spatial-joins
- flink/: sql

Combined with Phase 4a (apache#2931), 23 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.
@jiayuasu jiayuasu merged commit 33ef95c into apache:master May 8, 2026
12 checks passed
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