一起讀Python官方文件學英文- PEP8
小的發現不少會寫程式的人對語言學習也很有興趣，所以決定拋磚引玉，試著分析文法，解釋每個字怎麼用。小的取的文章篇幅很短，希望能夠藉由深入的分析，讓大家試圖理解英文句子的邏輯。
刪減自abridged from https://www.python.org/dev/peps/pep-0008/
原文:
This document gives coding conventions for the Python code comprising the standard library in the main Python distribution.
參考翻譯:
本文描述Python程式碼的寫法慣例，這些寫法也用在Python主程式的標準函數庫中。
解析：
This document 主詞 gives 主要動詞 coding conventions for the Python code comprising the standard library in the main Python distribution 主要受詞.
參考翻譯：本文描述Python程式碼的慣例，我們Python標準的函數庫也是這樣寫。
This document 主詞 gives 主要動詞 coding conventions for the Python code comprising the standard library in the main Python distribution 主要受詞.
參考翻譯：本文描述Python程式碼的慣例，我們Python標準的函數庫也是這樣寫。
1. 這個句子最主要的架構是五大基本句型中的S + V + O，主詞是this document(本文件)，動詞是gives，因為主詞是第三人稱單數的this document，所以現在式加s。2. 用現在簡單式的原因是因為這是對於現在事實的描述，對作者來說，give這個動作是否完成並不重要，因此不需要使用完成式或者進行式來標明。
3. coding conventions開始到... Python distribution結束是這個句子主要的受詞。英文的受詞只會是名詞片語，在這裡，這個名詞片語以conventions為核心其他都是修飾語。
coding conventions 單位一 for the Python code comprising the standard library in the main Python distribution 單位二
4. 進一步分析，可以將這個比較大的名詞單位拆成兩個單位，單位一語單位二用for連接，表示「給、為了」之類的概念，所以是「python code ...」的「coding conventions」
5. 單位一coding conventions是指程式碼是用慣例，另外一個常見的表達法是`coding style guide` 也是指程式碼要怎麼寫比較容易看懂、比較美的指南
6. 單位二又可以繼續拆解
the Python code 單位二之一 comprising the standard library in the main Python distribution 單位二之二
7. 單位二之一是Python code，Python程式碼
8. 單位二之二是分詞，表主動，表示者個python code comprise(組成)了the standard library in the main Python distribution。這裡也可以寫成which/that comprises the standard library in the main Python distribution，意思一樣。
9. comprise這個字的用法是這樣: 成分 comprise 聚合成的東西
或 聚合成的東西 is comprised of 成分。因此，這裡的語義關係，是這些python code聚合而成Python的標準函數庫(the standard library in the main Python distribution)。
10. Python是個第三方開發的library(函數庫)發展蓬勃的語言，這些函數庫就不屬於standard library的範疇。Standard library特別強調是由官方開發、有權威性的函數庫，因此寫法也比較值得參考。
3. coding conventions開始到... Python distribution結束是這個句子主要的受詞。英文的受詞只會是名詞片語，在這裡，這個名詞片語以conventions為核心其他都是修飾語。
coding conventions 單位一 for the Python code comprising the standard library in the main Python distribution 單位二
4. 進一步分析，可以將這個比較大的名詞單位拆成兩個單位，單位一語單位二用for連接，表示「給、為了」之類的概念，所以是「python code ...」的「coding conventions」
5. 單位一coding conventions是指程式碼是用慣例，另外一個常見的表達法是`coding style guide` 也是指程式碼要怎麼寫比較容易看懂、比較美的指南
6. 單位二又可以繼續拆解
the Python code 單位二之一 comprising the standard library in the main Python distribution 單位二之二
7. 單位二之一是Python code，Python程式碼
8. 單位二之二是分詞，表主動，表示者個python code comprise(組成)了the standard library in the main Python distribution。這裡也可以寫成which/that comprises the standard library in the main Python distribution，意思一樣。
9. comprise這個字的用法是這樣: 成分 comprise 聚合成的東西
或 聚合成的東西 is comprised of 成分。因此，這裡的語義關係，是這些python code聚合而成Python的標準函數庫(the standard library in the main Python distribution)。
10. Python是個第三方開發的library(函數庫)發展蓬勃的語言，這些函數庫就不屬於standard library的範疇。Standard library特別強調是由官方開發、有權威性的函數庫，因此寫法也比較值得參考。
原文: This style guide evolves over time as additional conventions are identified and past conventions are rendered obsolete by changes in the language itself. Many projects have their own coding style guidelines. In the event of any conflicts, such project-specific guides take precedence for that project.
參考翻譯：本指南會隨Python的改變而與時俱進，時而有增加新的慣例或汰換舊的寫法。許多Python專案有自己的寫法慣例，如果這些寫法語這裡的衝突，以他們的為主。
解析:
This style guide evolves over time 句子一 as 連接詞 additional conventions are identified and past conventions are rendered obsolete by changes in the language itself. 句子二
This style guide evolves over time 句子一 as 連接詞 additional conventions are identified and past conventions are rendered obsolete by changes in the language itself. 句子二
11. 這邊是用 as 連接兩個子，as在這邊要翻譯作「隨著」
This style guide 主詞 evolves 主要動詞 over time 副詞
12. 句子一的主詞是 this style guide 這個「關於寫作風格的指南」，反正就是說明coding寫法慣例的文件
13. evolves是演化、與時俱進的意思
14. over time是在一段時間內漸漸...的意思
additional conventions are identified 二之一 and 連接詞 past conventions are rendered obsolete by changes in the language itself 二之二
15. 單位二之一直接翻的話是新的慣例被「identified」(指認)出來，但是其實意思就是新的慣例產生出來的意思
16. 單位二之二是指過去的慣例因為Python語言的演進變得obsolete(過時)的意思
17. render的用法會有三個單位 主詞 -> 受詞-> 受詞補語，意思是主詞使得受詞變成受詞補語所描述的狀態。
這裡如果寫成主動句的話會是 The changes in the language itself 主詞 render 動詞 past conventions 受詞 obsolete 補語
the language依照語境，可以看得出來是在講Python，我們在原文句子裡面看到的是被動句，也就是變成這樣的句型：
past conventions 原本的受詞 are 補上be動詞 rendered 動詞p.p. obsolete 其他單位/補語照抄 by the changes in the language itself 原本的主詞
This style guide 主詞 evolves 主要動詞 over time 副詞
12. 句子一的主詞是 this style guide 這個「關於寫作風格的指南」，反正就是說明coding寫法慣例的文件
13. evolves是演化、與時俱進的意思
14. over time是在一段時間內漸漸...的意思
additional conventions are identified 二之一 and 連接詞 past conventions are rendered obsolete by changes in the language itself 二之二
15. 單位二之一直接翻的話是新的慣例被「identified」(指認)出來，但是其實意思就是新的慣例產生出來的意思
16. 單位二之二是指過去的慣例因為Python語言的演進變得obsolete(過時)的意思
17. render的用法會有三個單位 主詞 -> 受詞-> 受詞補語，意思是主詞使得受詞變成受詞補語所描述的狀態。
這裡如果寫成主動句的話會是 The changes in the language itself 主詞 render 動詞 past conventions 受詞 obsolete 補語
the language依照語境，可以看得出來是在講Python，我們在原文句子裡面看到的是被動句，也就是變成這樣的句型：
past conventions 原本的受詞 are 補上be動詞 rendered 動詞p.p. obsolete 其他單位/補語照抄 by the changes in the language itself 原本的主詞
以上。
即將進入廣告，捲動後可繼續閱讀
為什麼會看到廣告
留言0
查看全部
你可能也想看
Google News 追蹤
大家好，我是woody，是一名料理創作者，非常努力地在嘗試將複雜的料理簡單化，讓大家也可以體驗到料理的樂趣而我也非常享受料理的過程，今天想跟大家聊聊，除了料理本身，料理創作背後的成本。
哈囉～很久沒跟各位自我介紹一下了～
大家好～我是爺恩
我是一名圖文插畫家，有追蹤我一段時間的應該有發現爺恩這個品牌經營了好像.....快五年了(汗)時間過得真快！隨著時間過去，創作這件事好像變得更忙碌了，也很開心跟很多厲害的創作者以及廠商互相合作幫忙，還有最重要的是大家的支持與陪伴🥹。
嘿，大家新年快樂~ 新年大家都在做什麼呢？
跨年夜的我趕工製作某個外包設計案，在工作告一段落時趕上倒數。
然後和兩個小孩過了一個忙亂的元旦。在深夜時刻，看到朋友傳來的解籤網站，興致勃勃熬夜體驗了一下，覺得非常好玩，或許有人玩過了，但還是想寫上來分享紀錄一下~
從範例學python的目標讀者:
針對剛進入的初學者，想學習Python語言。
有基礎本數學邏輯基礎即可。
從小遊戲學python的目標讀者:
針對已經有經驗的C/C++, Python, 或其他有程式基礎的讀者。
想實作一些小專案，從實做中學習如何分析需求、元件分拆、到底層實作
本文介紹了Python中的物件導向程式設計的重要概念，包括類別、繼承、多型、封裝、介面、抽象類別、靜態類別、列舉、委派、Lambda表達式、泛型和反射。每個概念都有對應的程式碼範例來說明其用法和功能。這些概念對於理解和使用Python進行物件導向程式設計至關重要。
在Python中，我們可以用def關鍵字定義函數，並透過函數名稱呼叫它。函數參數可以是必填、關鍵字、默認或不定長度的類型。return語句負責結束函數並回傳值。全域變數可以在整個程序中使用，而區域變數只能在特定函數內使用。我們還可以在一個文件中定義函數，然後在另一個文件中呼叫它。
Python語法包括條件語句、迴圈、函數和變數的使用。條件語句如if、elif和else用於進行條件判斷，for和while是兩種主要的迴圈，def用於定義函數。變數可以被賦予數字或字符串，並可使用類型提示來指定變數的類型。註解可以是單行或多行，並可用於解釋函數或類的用途和作用。
Python是一種易學且功能強大的程式語言，具有直譯、動態語法等特性，並擁有豐富的標準庫。它在各領域如Web開發、數據科學和人工智慧等得到廣泛應用，並被許多大公司如Google和Facebook等使用。Python還有強大的框架、豐富的交互機能、和龐大的社區。
今天來介紹python的函式
函式在python中是非常重要的一環，因為到了後期，程式會越來越複雜。
而函式可以想成是容易管理的小程式，當我們需要使用時，只需呼叫即可。
本文詳細解說了 Python print() 函數的各種隱藏語法，包括 value、sep、end、file 和 flush。作者以清晰的範例和解說，讓從未接觸程式語言的人也能夠理解。而最後提到了訂閱房間的付費方式，並歡迎大家訂閱。文章內容較為詳細，提供了豐富的資訊。
在人與人溝通之間，最怕雞同鴨講，彼此不對頻的狀況常會造成誤會。在程式語言中也會出現類似的情況，所以就有一些約定來彼此約束。
PEP 8 是 Python 社群廣泛遵循的一種風格指南，用於提高 Python 程式碼的可讀性和一致性。一開始是 Python 之父 Guido van Rossum 自己
本文介紹了Python中函式引數的*args和**kwargs用法，通過*args處理可變數量的位置引數，通過**kwargs處理可變數量的關鍵字引數。不僅介紹了相應的語法和程式範例，還解釋了它們的順序問題和建議的慣例用法。
宣告變數
變數是程式中用來儲存和表示數據的標識符號，並將變數存放在某個記憶體位子
可以用ID的方法查找變數存在哪個記憶體，此方法有利於以後查找問題用。
在大多數程式語言中，變數需要事先聲明（宣告）並賦值。
而Python是一種動態類型語言，不需要顯式宣告變數類型，而是在賦值時自動進行推斷。
大家好，我是woody，是一名料理創作者，非常努力地在嘗試將複雜的料理簡單化，讓大家也可以體驗到料理的樂趣而我也非常享受料理的過程，今天想跟大家聊聊，除了料理本身，料理創作背後的成本。
哈囉～很久沒跟各位自我介紹一下了～
大家好～我是爺恩
我是一名圖文插畫家，有追蹤我一段時間的應該有發現爺恩這個品牌經營了好像.....快五年了(汗)時間過得真快！隨著時間過去，創作這件事好像變得更忙碌了，也很開心跟很多厲害的創作者以及廠商互相合作幫忙，還有最重要的是大家的支持與陪伴🥹。
嘿，大家新年快樂~ 新年大家都在做什麼呢？
跨年夜的我趕工製作某個外包設計案，在工作告一段落時趕上倒數。
然後和兩個小孩過了一個忙亂的元旦。在深夜時刻，看到朋友傳來的解籤網站，興致勃勃熬夜體驗了一下，覺得非常好玩，或許有人玩過了，但還是想寫上來分享紀錄一下~
從範例學python的目標讀者:
針對剛進入的初學者，想學習Python語言。
有基礎本數學邏輯基礎即可。
從小遊戲學python的目標讀者:
針對已經有經驗的C/C++, Python, 或其他有程式基礎的讀者。
想實作一些小專案，從實做中學習如何分析需求、元件分拆、到底層實作
本文介紹了Python中的物件導向程式設計的重要概念，包括類別、繼承、多型、封裝、介面、抽象類別、靜態類別、列舉、委派、Lambda表達式、泛型和反射。每個概念都有對應的程式碼範例來說明其用法和功能。這些概念對於理解和使用Python進行物件導向程式設計至關重要。
在Python中，我們可以用def關鍵字定義函數，並透過函數名稱呼叫它。函數參數可以是必填、關鍵字、默認或不定長度的類型。return語句負責結束函數並回傳值。全域變數可以在整個程序中使用，而區域變數只能在特定函數內使用。我們還可以在一個文件中定義函數，然後在另一個文件中呼叫它。
Python語法包括條件語句、迴圈、函數和變數的使用。條件語句如if、elif和else用於進行條件判斷，for和while是兩種主要的迴圈，def用於定義函數。變數可以被賦予數字或字符串，並可使用類型提示來指定變數的類型。註解可以是單行或多行，並可用於解釋函數或類的用途和作用。
Python是一種易學且功能強大的程式語言，具有直譯、動態語法等特性，並擁有豐富的標準庫。它在各領域如Web開發、數據科學和人工智慧等得到廣泛應用，並被許多大公司如Google和Facebook等使用。Python還有強大的框架、豐富的交互機能、和龐大的社區。
今天來介紹python的函式
函式在python中是非常重要的一環，因為到了後期，程式會越來越複雜。
而函式可以想成是容易管理的小程式，當我們需要使用時，只需呼叫即可。
本文詳細解說了 Python print() 函數的各種隱藏語法，包括 value、sep、end、file 和 flush。作者以清晰的範例和解說，讓從未接觸程式語言的人也能夠理解。而最後提到了訂閱房間的付費方式，並歡迎大家訂閱。文章內容較為詳細，提供了豐富的資訊。
在人與人溝通之間，最怕雞同鴨講，彼此不對頻的狀況常會造成誤會。在程式語言中也會出現類似的情況，所以就有一些約定來彼此約束。
PEP 8 是 Python 社群廣泛遵循的一種風格指南，用於提高 Python 程式碼的可讀性和一致性。一開始是 Python 之父 Guido van Rossum 自己
本文介紹了Python中函式引數的*args和**kwargs用法，通過*args處理可變數量的位置引數，通過**kwargs處理可變數量的關鍵字引數。不僅介紹了相應的語法和程式範例，還解釋了它們的順序問題和建議的慣例用法。
宣告變數
變數是程式中用來儲存和表示數據的標識符號，並將變數存放在某個記憶體位子
可以用ID的方法查找變數存在哪個記憶體，此方法有利於以後查找問題用。
在大多數程式語言中，變數需要事先聲明（宣告）並賦值。
而Python是一種動態類型語言，不需要顯式宣告變數類型，而是在賦值時自動進行推斷。