Trans topic to zh_TW

chairco · May 22, 2018 · ed42cf4 · ed42cf4
1 parent ae6ccd1
commit ed42cf4
Show file tree

Hide file tree

Showing 419 changed files with 23,947 additions and 20,770 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+docs_1.x/
diff --git a/README.md b/README.md
@@ -1,108 +1,56 @@
-[![Documentation Status](https://readthedocs.org/projects/channels-doc-tw/badge/?version=latest)](http://channels-doc.readthedocs.io/zh_TW/latest/?badge=latest)
-
 # Channels-docs-zh-TW
 
-目前正在進行的 Django Channels 翻譯專案。歡迎一起翻譯，目前共同翻譯方式採 [Transifex 線上翻譯](https://www.transifex.com/Channels-doc-tw/public/)，請先加入專案，翻譯完成後可以在 [github issue](https://github.com/chairco/Channels-tw-doc/issues) 發起，接著會將您發佈的翻譯內容審核。
-
-未來目標是希望能夠將翻譯補全後整合進入 Channels 專案內。
-
-
-相關網站請參考:
-
-* Transifex 線上翻譯 [Channels-doc-tw](https://www.transifex.com/Channels-doc-tw/public/)
-* 翻譯文件 [Channels-doc-tw](http://channels-doc.readthedocs.io/zh_TW/latest/)
-* 原專案文件 [Channels](http://channels.readthedocs.io/en/latest/) 
-* Channels 範例 [線上聊天室](https://github.com/jacobian/channels-example)
-
-
-## 翻譯方法
-
-介紹兩類翻譯方法，線上翻譯與本機端翻譯。兩種方式各有特點並說明差異。如果您只是想參與翻譯可以省略以下內容。
-
-
-### 線上翻譯
-
-類似 [python-doc-tw](https://github.com/python-doc-tw/python-doc-tw) 透過 Transifex 將 rst 檔案拉到網站上一個個翻譯。(http://www.sphinx-doc.org/en/stable/intl.html)
-
-優點是方便，可以透過網站專心翻譯，但缺點是需要手動拉下 .po 檔案再轉 rst 不太確定 Django channels 作者能不能這樣共同編輯翻譯。
-
-但採用 RTD 網站，~不知道中英文要怎樣處理~。發現 RTD 對於中英文方式很簡單，假如是英文要翻譯中文或是其他語言，只需設定同樣內容為子專案（語言別設定為中文），自動就會產生語言選項類似：
-
-<img src="http://i.imgur.com/CWDyfHM.png" width="40%" height="40%">
-
-### 本機翻譯
-
-本機端上編輯一個新的 sphinx 來編輯一個新的翻譯。~比較單純，就編寫一下轉 sphinx document 風格的網站。只是翻譯大概就自己一個人翻譯吧？放在 github 上應該沒人會理我。~
-
-
-## Transifex 平台和建立翻譯檔案步驟
-
-本專案目前採`線上翻譯`。流程圖是參考 sphinx 官方網站：
-
-![sphinx process](http://www.sphinx-doc.org/en/stable/_images/translation.png)
+[![Documentation Status](https://readthedocs.org/projects/channels-docs-zhtw/badge/?version=latest)](http://channels-docs-zhtw.readthedocs.io/zh_TW/latest/?badge=latest)
 
 
-### 安裝多語系套件
+Channels 強化 Django，讓你可以使用熟悉的 Django 設計模式與靈活且彈性的底層框架，為你的程式碼提供了 Websocket, 長輪詢 HTTP，任務卸載以及其他非同步支援，不僅可以自行定義行為，還可以編輯對你自己協議的需求。
 
-線上翻譯的方法要先將本機端的 `.rst` 檔案轉成 `.po` 檔案，接著上傳到 Transifex。在作業系統上要安裝一個支援多語系的套件 gettext。以系統是 mac os(OSX) 為例：
+中文版的文件檔案請參考 http://channels-docs-zhtw.readthedocs.io/zh_TW/latest/ 目前正在努力翻譯至 2.x，或是你迫不及待的想先閱讀英文版本 https://channels.readthedocs.io/ 如果可以，在閱讀完後，也可以加入 https://www.transifex.com/Channels-zhTW/ 或是到 [Wiki](https://github.com/chairco/Channels-docs-zh-TW/wiki/Channels-docs-zh_TW-%E7%BF%BB%E8%AD%AF%E6%B5%81%E7%A8%8B) 了解細節與參與翻譯喔！
 
-```
-$ brew install gettext
-$ brew link gettext --force //如果安裝過要重新 --force 
-```
+Channels 是一個官方的 Django 專案，因此有一個棄用政策。有關每個版本的已棄用或待批棄用的詳細訊息，請參閱[發行說明](http://channels.readthedocs.io/en/latest/releases/index.html)。
 
+透過 issues 在這邊獲得支援，或是到 Freenode 內的 #django-channels 頻道來取得協助。
 
-### 複製原專案 docs 並轉換文檔
+使用 PyPI 來安裝 channels 與其套件，請參考我們的安裝與教學說明文件檔案瞭解更多。
 
-需要先複製一份[channel 專案](https://github.com/django/channels/)的 docs 檔到本機端，接著在本機端將 rst 轉成 .po 檔案。
 
-先 clone Django channels 專案到本機端上
+## 相依性
 
-```shell
-git clone https://github.com/django/channels.git
-```
+目前 Channels 專案已經完全支援 3.5 或更高版本。 channels 兼容於 Django 1.11 或是 Django 2.0。
 
-進入專案的 docs 底下，不過要先確認你的環境目前有安裝兩個套件，一個是 [sphinx](https://github.com/sphinx-doc/sphinx), 一個是 [sphinx_intl](https://github.com/sphinx-doc/sphinx-intl) 然後執行
 
-```
-make gettext
-```
+## 貢獻
 
-接著會在 `/_build/gettext` 底下建立對應的 .pot 檔案。這些 .pot 檔案要讓我們用來轉換成 .po 檔。轉換 .po 檔案的方式也很簡單，執行指令如下：
+請先[研讀我的們的貢獻手冊](https://channels.readthedocs.io/en/latest/contributing.html)，瞭解更多貢獻的方式。
 
-```shell
-sphinx-intl update -l zh_TW
-```
 
-要注意是因為我在 Transifex 上選擇 zh_TW 所以轉換格式要輸入正確。 然後就可以上到網站註冊一個翻譯團體，接著將這些 .po 檔案上傳就大功告成囉。
+## 維護以及安全
 
 
-### 完成翻譯
+請聯繫 security@djangoproject.com 回報安全的問題. 關於 GPG 簽章與更多安全流程訊息， 參見 https://docs.djangoproject.com/en/dev/internals/security/.
 
-從 Transifex 翻譯專案並且將完成的 .po 檔案 pull 回本機。在 root 資料夾底下建立 .tx 的資料夾和建立一個 config 檔案並輸入 Transifex網站位置和 .po 檔與 .pot 之間關係。
+回報臭蟲或是請求新的 features，請發起一個新的 GitHub issue。針對較大型討論，請張貼到 django-developers mailing list。
 
-```
-[main]
-host = https://www.transifex.com
-type = PO
+Django Core Shepherd: Andrew Godwin <andrew@aeracode.org>
 
-[Channels.asgipo]
-file_filter = locale/<lang>/LC_MESSAGES/asgi.po
-source_file = _build/gettext/asgi.pot
-source_lang = en
-```
+維護團隊:
 
-接著翻譯完成之後只要執行 `tx pull -a` 就可以順利完成翻譯檔整合囉。
+Andrew Godwin <andrew@aeracode.org>
+Steven Davidson
+Jeremy Spencer
+If you are interested in joining the maintenance team, please read more about contributing and get in touch!
 
 
-### RTD 發佈網站
+## 其他專案
 
-在本機端 `/locale/zh_TW/LC_MESSAGE` 內應該會存在 .po 檔案，但網頁須要 .mo 檔案才有辦法正確顯示。所以最後一個步驟是透過 `make html` 指令產生一個靜態頁面同時將 .po 檔案兩兩對應的轉換成 .mo 檔案。
+Channels 專案是由以下幾個套件組合而成; 這些套件如:
 
-接著將 RTD 內的專案設定指向 github 位置，每一次 push 新的程式碼就會 trigger RTD 並且自動建置靜態文件頁面網站囉。
++ [Daphne](https://github.com/django/daphne/), the HTTP and Websocket termination server
++ [asgiref](https://github.com/django/asgiref/), the base ASGI library/memory backend
++ [channels_redis](https://github.com/django/channels_redis/), the Redis channel backend
 
 
-## 感謝[貢獻者](https://www.transifex.com/Channels-doc-tw/teams/72101/zh_TW/)
+## 中文翻譯感謝[貢獻者](https://www.transifex.com/Channels-zhTW/teams/72101/zh_TW/)
 這個翻譯感謝參與 [PyConTW 2017.3 Sprint](https://www.meetup.com/Taipei-py/events/238139601/?_cookie-check=RCk0Puwq5Y-alyDD) 活動的夥伴。沒有你們這個翻譯應該不會有太多進展(根據字母排序)：
 
 + Adrian Liaw (@adrianliaw)

diff --git a/docs/.tx/config b/docs/.tx/config
@@ -2,123 +2,130 @@
 host = https://www.transifex.com
 type = PO
 
-[Channels.asgipo]
+[Channels2.asgipo]
 file_filter = locale/<lang>/LC_MESSAGES/asgi.po
 source_file = _build/gettext/asgi.pot
 source_lang = en
 
-[Channels.backendspo]
-file_filter = locale/<lang>/LC_MESSAGES/backends.po
-source_file = _build/gettext/backends.pot
+[Channels2.channel_layer_specpo]
+file_filter = locale/<lang>/LC_MESSAGES/channel_layer_spec.po
+source_file = _build/gettext/channel_layer_spec.pot
 source_lang = en
 
-[Channels.bindingpo]
-file_filter = locale/<lang>/LC_MESSAGES/binding.po
-source_file = _build/gettext/binding.pot
-source_lang = en
-
-[Channels.communitypo]
+[Channels2.communitypo]
 file_filter = locale/<lang>/LC_MESSAGES/community.po
 source_file = _build/gettext/community.pot
 source_lang = en
 
-[Channels.conceptspo]
-file_filter = locale/<lang>/LC_MESSAGES/concepts.po
-source_file = _build/gettext/concepts.pot
-source_lang = en
-
-[Channels.contributingpo]
+[Channels2.contributingpo]
 file_filter = locale/<lang>/LC_MESSAGES/contributing.po
 source_file = _build/gettext/contributing.pot
 source_lang = en
 
-[Channels.delaypo]
-file_filter = locale/<lang>/LC_MESSAGES/delay.po
-source_file = _build/gettext/delay.pot
-source_lang = en
-
-[Channels.deployingpo]
+[Channels2.deployingpo]
 file_filter = locale/<lang>/LC_MESSAGES/deploying.po
 source_file = _build/gettext/deploying.pot
 source_lang = en
 
-[Channels.faqspo]
-file_filter = locale/<lang>/LC_MESSAGES/faqs.po
-source_file = _build/gettext/faqs.pot
+[Channels2.indexpo]
+file_filter = locale/<lang>/LC_MESSAGES/index.po
+source_file = _build/gettext/index.pot
 source_lang = en
 
-[Channels.genericspo]
-file_filter = locale/<lang>/LC_MESSAGES/generics.po
-source_file = _build/gettext/generics.pot
+[Channels2.installationpo]
+file_filter = locale/<lang>/LC_MESSAGES/installation.po
+source_file = _build/gettext/installation.pot
 source_lang = en
 
-[Channels.getting-startedpo]
-file_filter = locale/<lang>/LC_MESSAGES/getting-started.po
-source_file = _build/gettext/getting-started.pot
+[Channels2.introductionpo]
+file_filter = locale/<lang>/LC_MESSAGES/introduction.po
+source_file = _build/gettext/introduction.pot
 source_lang = en
 
-[Channels.indexpo]
-file_filter = locale/<lang>/LC_MESSAGES/index.po
+[Channels2.javascriptpo]
+file_filter = locale/<lang>/LC_MESSAGES/javascript.po
+source_file = _build/gettext/javascript.pot
+source_lang = en
+
+[Channels2.one-to-twopo]
+file_filter = locale/<lang>/LC_MESSAGES/one-to-two.po
+source_file = _build/gettext/one-to-two.pot
+source_lang = en
+
+
+[Channels2.indexpo_2]
+file_filter = locale/<lang>/LC_MESSAGES/tutorial/index.po
 source_file = _build/gettext/index.pot
 source_lang = en
 
-[Channels.inshortpo]
-file_filter = locale/<lang>/LC_MESSAGES/inshort.po
-source_file = _build/gettext/inshort.pot
+[Channels2.part_1po]
+file_filter = locale/<lang>/LC_MESSAGES/tutorial/part_1.po
+source_file = _build/gettext/part_1.pot
 source_lang = en
 
-[Channels.installationpo]
-file_filter = locale/<lang>/LC_MESSAGES/installation.po
-source_file = _build/gettext/installation.pot
+[Channels2.part_2po]
+file_filter = locale/<lang>/LC_MESSAGES/tutorial/part_2.po
+source_file = _build/gettext/part_2.pot
 source_lang = en
 
-[Channels.javascriptpo]
-file_filter = locale/<lang>/LC_MESSAGES/javascript.po
-source_file = _build/gettext/javascript.pot
+[Channels2.part_3po]
+file_filter = locale/<lang>/LC_MESSAGES/tutorial/part_3.po
+source_file = _build/gettext/part_3.pot
 source_lang = en
 
-[Channels.referencepo]
-file_filter = locale/<lang>/LC_MESSAGES/reference.po
-source_file = _build/gettext/reference.pot
+[Channels2.part_4po]
+file_filter = locale/<lang>/LC_MESSAGES/tutorial/part_4.po
+source_file = _build/gettext/part_4.pot
 source_lang = en
 
-[Channels.routingpo]
-file_filter = locale/<lang>/LC_MESSAGES/routing.po
-source_file = _build/gettext/routing.pot
+
+[Channels2.authenticationpo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/authentication.po
+source_file = _build/gettext/authentication.pot
 source_lang = en
 
-[Channels.testingpo]
-file_filter = locale/<lang>/LC_MESSAGES/testing.po
-source_file = _build/gettext/testing.pot
+[Channels2.channel_layerspo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/channel_layers.po
+source_file = _build/gettext/channel_layers.pot
 source_lang = en
 
-[Channels.releases--1_0_0po]
-file_filter = locale/<lang>/LC_MESSAGES/releases/1.0.0.po
-source_file = _build/gettext/releases/1.0.0.pot
+[Channels2.consumerspo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/consumers.po
+source_file = _build/gettext/consumers.pot
 source_lang = en
 
-[Channels.releases--1_0_1po]
-file_filter = locale/<lang>/LC_MESSAGES/releases/1.0.1.po
-source_file = _build/gettext/releases/1.0.1.pot
+[Channels2.databasespo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/databases.po
+source_file = _build/gettext/databases.pot
 source_lang = en
 
-[Channels.releases--1_0_2po]
-file_filter = locale/<lang>/LC_MESSAGES/releases/1.0.2.po
-source_file = _build/gettext/releases/1.0.2.pot
+[Channels2.routingpo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/routing.po
+source_file = _build/gettext/routing.pot
 source_lang = en
 
-[Channels.releases--1_0_3po]
-file_filter = locale/<lang>/LC_MESSAGES/releases/1.0.3.po
-source_file = _build/gettext/releases/1.0.3.pot
+[Channels2.securitypo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/security.po
+source_file = _build/gettext/security.pot
 source_lang = en
 
-[Channels.releases--1_1_0po]
-file_filter = locale/<lang>/LC_MESSAGES/releases/1.1.0.po
-source_file = _build/gettext/releases/1.1.0.pot
+[Channels2.sessionspo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/sessions.po
+source_file = _build/gettext/sessions.pot
 source_lang = en
 
-[Channels.releases--indexpo]
-file_filter = locale/<lang>/LC_MESSAGES/releases/index.po
-source_file = _build/gettext/releases/index.pot
+[Channels2.testingpo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/testing.po
+source_file = _build/gettext/testing.pot
+source_lang = en
+
+[Channels2.workerpo]
+file_filter = locale/<lang>/LC_MESSAGES/topics/worker.po
+source_file = _build/gettext/worker.pot
 source_lang = en
 
+
+[Channels2.indexpo_1]
+file_filter = locale/<lang>/LC_MESSAGES/releases/index.po
+source_file = _build/gettext/index.pot
+source_lang = en