狠狠撸

狠狠撸Share a Scribd company logo
Python 官?方?文件中?文翻譯計畫
探討翻譯專案的貢獻流程
Adrian Liaw
whoami
? 廖偉涵 Adrian Liaw
? ?高三?自學?生
? Python / JavaScript / R
? PyCon Taiwan
? Coordinator of python-docs-zh-tw
whoami | more
? Pianist
? Language Enthusiast
adrianliaw @adrianliaw2000
預防針
? 非針對初學者
? 沒有 Python 技術細節
? 沒有?手把?手教學,歡迎參參加不定期翻譯 Sprint
Disclaimer
我不是 i18n / l10n 專家
社群
Python Documentation
docs.python.org
Sphinx
https://youtu.be/0ROZRNZkPS8
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
GNU Gettext
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
https://youtu.be/Tgvs9WfA3LI?t=11950
github.com/python/
python-docs-zh-tw
歷史
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
python-doc-tw/python-doc-tw
Ref: Liang-Bo Wang
Ref: Liang-Bo Wang
sphinx-intl + Transifex
Ref: Liang-Bo Wang
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
PEP-545 TL;DR
? 使?用 Language Tag 作為翻譯的網址路路徑
? https://docs.python.org/fr/
? https://docs.python.org/ja/
? Gettext PO 檔集合成?一個 GitHub repo,置於 Python 官?方
GitHub 組織底下
? Language Team 組成
? Documentation Contribution Agreement
? 加入官?方網站的最低?門檻
2018
Transifex + auto-build
? 參參與?門檻低
? 動作快速
? 好的翻譯體驗
? 只需要著重在翻譯本?身即可
Cons?
? 很難管理理貢獻紀錄
? 沒有 fork & pull request 的概念念
? 沒辦法做「有意義的 commit」
? GitHub 沒有綠綠的 QQ
Traduction fran?aise
GitHub Flow
? Fork
? Commit
? Push
? Pull Request
? Merge
Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程
全部統?一 Git 管理理
? Glossary
? 翻譯守則
? 翻譯教學
? 翻譯內容
Make?le
? make merge
? make fuzzy
? make progress
? make todo
Pros
? 比較熟悉
? 能保持 master 乾淨
? 品質比較好管控
? 整體的版控比較好
Cons
? 對新?手比較困難
? 整體的翻譯體驗差很多
? 移动速度较慢
Rethink
? 品質 > 速度 & 量量
? 透過翻譯?文件學 Python? ?
? 有必要降低?門檻嗎?(拿掉 GitHub ?ow 的操作)
? 但是現在翻譯進度才 2.8% ?而已欸擔?心這個幹嘛
?麻煩
? 錯字檢查?
? ?文法檢查?
? 空格檢查?
? reStructuredText 語法檢查?
Roadmap
? 辦 Sprint
? Linter & Tests
? Build bots
? 徵求 Reviewer
相關資源
? Telegram: t.me/PyDocTW
? GitHub: python/python-docs-zh-tw
? Doc-SIG: mail.python.org/mailman/listinfo/doc-sig
? Python-docs: mail.python.org/mailman/listinfo/docs
Taipei.py 六週年年快樂!

More Related Content

Similar to Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程 (8)

2 Python开发工具链
2 Python开发工具链2 Python开发工具链
2 Python开发工具链
March Liu
?
笔测迟丑辞苍与抓包
笔测迟丑辞苍与抓包笔测迟丑辞苍与抓包
笔测迟丑辞苍与抓包
Leo Zhou
?
笔测迟丑辞苍简明教程
笔测迟丑辞苍简明教程笔测迟丑辞苍简明教程
笔测迟丑辞苍简明教程
ingong
?
Testing in Python @ Kaosiung.py 2014.05.26
Testing in Python @ Kaosiung.py 2014.05.26Testing in Python @ Kaosiung.py 2014.05.26
Testing in Python @ Kaosiung.py 2014.05.26
Chun-Yu Tseng
?
Python 于 webgame 的应用
Python 于 webgame 的应用Python 于 webgame 的应用
Python 于 webgame 的应用
勇浩 赖
?
Python核心编程(中文 第二版)
Python核心编程(中文 第二版)Python核心编程(中文 第二版)
Python核心编程(中文 第二版)
yiditushe
?
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
Eric Guo
?
2 Python开发工具链
2 Python开发工具链2 Python开发工具链
2 Python开发工具链
March Liu
?
笔测迟丑辞苍与抓包
笔测迟丑辞苍与抓包笔测迟丑辞苍与抓包
笔测迟丑辞苍与抓包
Leo Zhou
?
笔测迟丑辞苍简明教程
笔测迟丑辞苍简明教程笔测迟丑辞苍简明教程
笔测迟丑辞苍简明教程
ingong
?
Testing in Python @ Kaosiung.py 2014.05.26
Testing in Python @ Kaosiung.py 2014.05.26Testing in Python @ Kaosiung.py 2014.05.26
Testing in Python @ Kaosiung.py 2014.05.26
Chun-Yu Tseng
?
Python 于 webgame 的应用
Python 于 webgame 的应用Python 于 webgame 的应用
Python 于 webgame 的应用
勇浩 赖
?
Python核心编程(中文 第二版)
Python核心编程(中文 第二版)Python核心编程(中文 第二版)
Python核心编程(中文 第二版)
yiditushe
?
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
使用 Dify 做 AI 应用 - 接触2周的一些小想法小心得分享 Ruby Tuesday Shanghai
Eric Guo
?

More from Wey-Han Liaw (13)

Educational Code Reviews
Educational Code ReviewsEducational Code Reviews
Educational Code Reviews
Wey-Han Liaw
?
Learning: Being as a Homeschooled Student
Learning: Being as a Homeschooled StudentLearning: Being as a Homeschooled Student
Learning: Being as a Homeschooled Student
Wey-Han Liaw
?
Jupyter Kernel: How to Speak in Another Language
Jupyter Kernel: How to Speak in Another LanguageJupyter Kernel: How to Speak in Another Language
Jupyter Kernel: How to Speak in Another Language
Wey-Han Liaw
?
Udacity Taipei meetup #2 如何駕馭線上課程
Udacity Taipei meetup #2 如何駕馭線上課程Udacity Taipei meetup #2 如何駕馭線上課程
Udacity Taipei meetup #2 如何駕馭線上課程
Wey-Han Liaw
?
笔测迟丑辞苍自学从你小时候开始
笔测迟丑辞苍自学从你小时候开始笔测迟丑辞苍自学从你小时候开始
笔测迟丑辞苍自学从你小时候开始
Wey-Han Liaw
?
Meteor Taipei 2016 January talk -- Mantra
Meteor Taipei 2016 January talk -- MantraMeteor Taipei 2016 January talk -- Mantra
Meteor Taipei 2016 January talk -- Mantra
Wey-Han Liaw
?
Understanding Meteor Stack
Understanding Meteor StackUnderstanding Meteor Stack
Understanding Meteor Stack
Wey-Han Liaw
?
Async, await
Async, awaitAsync, await
Async, await
Wey-Han Liaw
?
SITCON summer camp 2015: Adrian說他那身邊的一堆社群
SITCON summer camp 2015: Adrian說他那身邊的一堆社群SITCON summer camp 2015: Adrian說他那身邊的一堆社群
SITCON summer camp 2015: Adrian說他那身邊的一堆社群
Wey-Han Liaw
?
NCCU 0617 talk
NCCU 0617 talkNCCU 0617 talk
NCCU 0617 talk
Wey-Han Liaw
?
Implementation of Rubik's Cube Formula in PyCuber
Implementation of Rubik's Cube Formula in PyCuberImplementation of Rubik's Cube Formula in PyCuber
Implementation of Rubik's Cube Formula in PyCuber
Wey-Han Liaw
?
PyCon 2015 Crawler Tutorial Explain Cookies
PyCon 2015 Crawler Tutorial Explain CookiesPyCon 2015 Crawler Tutorial Explain Cookies
PyCon 2015 Crawler Tutorial Explain Cookies
Wey-Han Liaw
?
PyCon 2015 Crawler Tutorial Explain Encoding
PyCon 2015 Crawler Tutorial Explain EncodingPyCon 2015 Crawler Tutorial Explain Encoding
PyCon 2015 Crawler Tutorial Explain Encoding
Wey-Han Liaw
?
Educational Code Reviews
Educational Code ReviewsEducational Code Reviews
Educational Code Reviews
Wey-Han Liaw
?
Learning: Being as a Homeschooled Student
Learning: Being as a Homeschooled StudentLearning: Being as a Homeschooled Student
Learning: Being as a Homeschooled Student
Wey-Han Liaw
?
Jupyter Kernel: How to Speak in Another Language
Jupyter Kernel: How to Speak in Another LanguageJupyter Kernel: How to Speak in Another Language
Jupyter Kernel: How to Speak in Another Language
Wey-Han Liaw
?
Udacity Taipei meetup #2 如何駕馭線上課程
Udacity Taipei meetup #2 如何駕馭線上課程Udacity Taipei meetup #2 如何駕馭線上課程
Udacity Taipei meetup #2 如何駕馭線上課程
Wey-Han Liaw
?
笔测迟丑辞苍自学从你小时候开始
笔测迟丑辞苍自学从你小时候开始笔测迟丑辞苍自学从你小时候开始
笔测迟丑辞苍自学从你小时候开始
Wey-Han Liaw
?
Meteor Taipei 2016 January talk -- Mantra
Meteor Taipei 2016 January talk -- MantraMeteor Taipei 2016 January talk -- Mantra
Meteor Taipei 2016 January talk -- Mantra
Wey-Han Liaw
?
Understanding Meteor Stack
Understanding Meteor StackUnderstanding Meteor Stack
Understanding Meteor Stack
Wey-Han Liaw
?
SITCON summer camp 2015: Adrian說他那身邊的一堆社群
SITCON summer camp 2015: Adrian說他那身邊的一堆社群SITCON summer camp 2015: Adrian說他那身邊的一堆社群
SITCON summer camp 2015: Adrian說他那身邊的一堆社群
Wey-Han Liaw
?
Implementation of Rubik's Cube Formula in PyCuber
Implementation of Rubik's Cube Formula in PyCuberImplementation of Rubik's Cube Formula in PyCuber
Implementation of Rubik's Cube Formula in PyCuber
Wey-Han Liaw
?
PyCon 2015 Crawler Tutorial Explain Cookies
PyCon 2015 Crawler Tutorial Explain CookiesPyCon 2015 Crawler Tutorial Explain Cookies
PyCon 2015 Crawler Tutorial Explain Cookies
Wey-Han Liaw
?
PyCon 2015 Crawler Tutorial Explain Encoding
PyCon 2015 Crawler Tutorial Explain EncodingPyCon 2015 Crawler Tutorial Explain Encoding
PyCon 2015 Crawler Tutorial Explain Encoding
Wey-Han Liaw
?

Recently uploaded (6)

2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
David vonThenen
?
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
kaozytf
?
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
David vonThenen
?
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
kaozytf
?
Build_With_AI_2025 Gemini 2.0 New Function
Build_With_AI_2025  Gemini 2.0 New FunctionBuild_With_AI_2025  Gemini 2.0 New Function
Build_With_AI_2025 Gemini 2.0 New Function
kevinchiu59
?
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
RayChan91
?
2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
2025 NVIDIA GTC: Crack the AI Black Box: Practical Techniques for Explainable AI
David vonThenen
?
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
匹兹堡大学毕业证(笔滨罢罢学位证范本毕业证书)办理
kaozytf
?
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
2025 DeveloperWeek - The Sound of Innovation: Why Voice Cloning Will Redefine...
David vonThenen
?
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
阿伯丁大学毕业证(鲍辞础学位证学历认证国外留学)办理
kaozytf
?
Build_With_AI_2025 Gemini 2.0 New Function
Build_With_AI_2025  Gemini 2.0 New FunctionBuild_With_AI_2025  Gemini 2.0 New Function
Build_With_AI_2025 Gemini 2.0 New Function
kevinchiu59
?
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
Cantonmade 2025 Hotel Supplier Catalog: Technical Specs for Engineers & Integ...
RayChan91
?

Python 官方文件中文翻譯專案 - 探討翻譯專案的貢獻流程