用你自己的語言

概覽

如果你打開這套文件，看見它以一種你真正讀得懂的語言呈現——而不是只能勉強解碼——你的第一個反應是再看一眼，或許還會讀個一兩句，確認文字是否通順，那麼我們之間其實已經有了默契。那一瞬間的「再看一眼」，正是這一頁存在的全部理由。如果你此刻是以英語以外的語言閱讀這段文字，那正是我們所期盼的。

在「看得懂」與「喜歡上」之間

軟體設計所用的語言，是以英語書寫的；對多數工程師而言，一本英文手冊再尋常不過。只要搭配一點工具，它也完全行得通。但如果你的母語不是英語，你會懂得那種感覺——總有什麼東西橫亙在你與書頁之間，一層薄薄的、揮之不去的翻譯：讀著參考資料時，它在你腦中默默進行；輪到自己動筆時，又得再來一次。

我們懂，因為這也是我們的處境。我們是一群母語並非英語的工程師，多年來讀的是英文手冊，寫的也是英文文件與程式碼。正因如此，我們比多數人更敏銳地感受到那道落差——一篇你只是讀過的文章，和一篇你得費力去理解的文章，兩者之間的差別。兩種都能讓你獲得資訊，但只有一種能讓你讀得自在。看得懂一件事，和能夠享受它，並不是同一回事——而這整件事，正是為了那道差別。

為什麼是十八種語言

當你滑過語言清單，數出將近二十個項目——其中有些並不是全球最強勢的語言——這既非偶然，也不是為了打勾交差。它們之所以在那裡，是因為我們希望你喜歡上這一切：產品本身，以及它所圍繞的那個主題。PDF 是一套建立在規則之上的系統——一種可攜式文件格式，從物件模型到語法，都由一份正式標準（ISO 32000-2）所定義。我們私心覺得這件事低調卻迷人，也希望你會這麼覺得。

這也是為什麼這裡有些文章，讀起來不太像一份枯燥的參考資料，反而更像一則親切易懂、關於 PDF 究竟如何運作的故事。如果其中某一篇講到了你從沒聽過的東西——別擔心，一秒都不必。不是只有你這樣。在我們自己坐下來把 ISO 32000-2 讀過一遍之前，我們也一樣不懂。一頁文件，若能用一種讓你放鬆讀進去的語言，教會你這個格式的某件新事，那它就盡到了本分。

特別為了東南亞

主要的世界語言本就理所當然。我們刻意多花心力加上的，是東南亞的語言——印尼語、泰語與越南語。歐洲、美洲與東北亞有著悠久而深厚的軟體文化，也早就有與之相稱的文件。東南亞擁有全球成長最快的軟體生態之一——然而第一流的母語文件，往往最晚才送達那裡。我們不想成為又一個把它當成事後補丁的工具。

而不論你是誰——一名學生、第一次接手真實專案的資淺工程師、獨立開發者，或是正把 PDF 納入技術堆疊的團隊——我們對你的期盼都一樣：那份做出能用之物的單純喜悅，還有一種微小卻真實的滿足感——唯有在動手的同時，也清楚明白自己在做什麼，才嘗得到。當手冊不再同時是一道障礙，你會更容易愛上一門手藝。

這對我們來說，代價是什麼

這一切都不是免費的，我們也不會假裝是。即使倚賴機器翻譯，每多一種語言，都是龐大而持續的維護成本——而一份機器翻譯的初稿，只是起跑線。要從「字詞都翻好了」走到「這篇文章真正讀得懂，而且對一個用這種語言思考的人來說讀起來自然」，是艱難的、得靠人完成的工作，也是我們投入大量心力的領域。好的文件必須達到一定的品質門檻，其中包含「讓它真正的讀者看得懂」（ISO/IEC/IEEE 26514）；對我們而言，這道門檻不會因為讀者的語言換了，就跟著降低。

所以當一段翻譯落得恰到好處時，請把它看成它本來的樣子：那不是一項圖個方便的功能，而是一群工程師對另一群工程師，一份小小的用心。

給正在閱讀的你

我們坦白說：橫跨十八種語言，不可能每一句都完美，而且有些頁面在某些語言裡，會比在其他語言裡更早抵達。如果某段文字在你的語言裡讀起來生硬或不對勁，請告訴我們——我們對待一個文件缺陷的方式，和對待任何其他工程缺陷一樣，絕不會把它當成無關緊要的門面問題。文件就是這樣一點一點變好的。

最重要的是，我們希望你能以自己思考時所用的那種語言讀到這些文字，也希望讀著讀著，你會在某個地方，比原本預期的再多喜歡 PDF 一點，也比今天早上再多喜歡「動手做東西」一點。如果這是你第一次認真接觸 PDF，或是第一次認真接觸 PHP——歡迎你。我們起步的地方，和你此刻一模一樣：帶著好奇，稍稍站在英語世界的重心之外，然後很慶幸地，終於找到了一本讓人覺得它真的在對自己說話的手冊。而我們寫下這一本，就是為了讓它能對你說話。