www.debian.org 是如何被製作出來的

外觀

Debian 網站是位於 www-master.debian.org 上的 /org/www.debian.org/www 目錄的文件和目錄的集合。頁面的大部分內容都是靜態 HTML 文件。它們不包含 CGI 或 PHP 命令稿之類的動態元素,因為網站需要能被映射站台。

Debian 網站使用網站元語言(Website Meta Language,WML)生成 HTML 頁面,包括頁眉和頁腳、標題、目錄等等。儘管 .wml 文件乍看起來像是一個 HTML 文件,但是 HTML 只是 .wml 中可以使用的其中一種額外信息。您也可以在頁面中加入 Perl 代碼,然後就可以做幾乎任何事情。

在 WML 在一個文件上運行其各種篩選器後,得到的最終產品就是真正的 HTML 文件。請注意,雖然 WML 能檢查(有時能自動糾正)您的 HTML 代碼的最基礎的正確性,您還是應該安裝 weblint 和/或 tidy 之類的工具作為最基本的語法和編碼風格檢查工具。

原始碼

我們使用 Git 存儲 Debian 網站的原始碼。這一版本控制系統讓我們可以跟蹤所有的更改,我們可以看到誰更改了什麼、什麼時候更改的,以及為什麼更改。Git 提供了一個在多個作者並行編輯源文件時加以控制的安全的方法,由於 Debian 網站團隊規模很大,所以這一點對我們來説至關重要。

以下是關於原始碼如何組織的一些背景信息:

請注意:為了使對模板的更改傳播到使用它們的文件,所以其它文件在 Makefile 中依賴它們。絕大多數文件都使用 template 模板,所以它們的開頭都有如下一行:

#use wml::debian::template

當然,這條規則也有例外。

命令稿

用到的命令稿主要用 shell 或 Perl 語言編寫。其中一些能獨立工作,還有一些已集成到 WML 源文件中。

生成網站

WML、模板和 shell 或 Perl 命令稿是您生成 Debian 網站需要的全部原料:

每天運行六次自動更新(從 Git 存儲庫和其他來源到 webtree)。此外,我們還定期對整個網站運行以下檢查:

網站最新的構建日誌可以在 https://www-master.debian.org/build-logs/ 找到。

如果您想參與網站開發,開始時請不要簡單地編輯 www/目錄中的文件或添加新項目。請首先與 webmaster 團隊聯繫。

怎樣幫忙

我們鼓勵任何人幫助改善 Debian 網站。如果您認為我們的頁面上缺少一些關於 Debian 的有價值的信息,請聯繫我們,我們一定會加入該信息。此外,也請查看上面提到的構建日誌,看看您是否有修復其中問題的建議。

我們也需要可以幫助設計網頁(圖像和佈局等)的人。如果您熟悉英語,我們希望您能對我們的頁面進行校對並向我們報告其中的錯誤。如果您使用其他語言,您可能想幫助我們翻譯現有的頁面,或者修復已翻譯的頁面的問題。不論何種情況,都請查看翻譯協調員列表,然後聯繫負責人。請參閲翻譯頁面以獲取更多信息。

怎樣幫不上忙……(FAQ)

[問] 我想給 Debian 網站添加一個華麗的功能,可以嗎?

[答] 不行。我們希望 www.debian.org 儘可能易於訪問,因此

[問] 我想提出一個好主意。 您可以在 www.debian.org 的 HTTP 伺服器中啓用 foo 或者 bar 嗎?

[答] 不行。我們希望管理員可以輕鬆地映射站台 www.debian.org,所以請不要使用特殊的 HTTPD 功能。不,即使是 SSI(Server Side Includes)也不行。內容協商已作為例外進行處理,因為它是提供多種語言服務的唯一的一種可靠方法。