舊文件

此處文件僅供參考,請自行考量時效性與適用程度,其他庫藏文件請參考文件頁面
我們亟需您的協助,進行共筆系統搬移、及文件整理工作,詳情請查閱參與我們

使用說明:關於冒號和斜線的命名方式

出自 MozTW Wiki

我覺得之前 xacid 在談論 "/" 和 ":" 的使用時機時,有將那個區別點出來。 我分別從不同的角度來看:

從 mediawiki 的定義來看

所謂 "/" 用來表示 subpage, 我覺得更明白點的就是將 section 獨立到下一頁去,會有這樣的做法,可以說該類文件的 section 太多,因此會造成目錄和內容都擠在一起,所以將這些 section 獨立到一個頁面下,便於閱讀。最好的例子就是 XUL 那份文件。

所謂 ":" 在 mediawiki 裡的定義是 sisterproject ,這個字,我不知道該如何去翻譯,但是從字面上我們可以大致了解它所代表的函意,直接舉例: 例如: wiki 上的校園推廣專案 和 淡江大學是用 "校園推廣專案:淡江大學" 來表示其關係,我們可以清楚看到,校園推廣專案其實只是將那些專案集中起來,做個"分類"而已,但是他們並沒有"從屬關係",而 Moztw 專案 -> 文件專案 這是有"從屬關係"的,文件專案是歸類成 Moztw 專案的 "子專案",所以那個部份會使用 ":" 來表示。

從類別列表來看

我們做的各類頁面名稱,都會直接顯示在類別頁裡,可是,類別頁只做 "subcategory" 和 "按英文子母排序" 的動作而已。 因此在這個部分,如果適當使用 "/" 和 ":",我們將可以直接從類別頁看出不同文章的歸屬狀況。

":" 的例子: Category:推廣專案 這個部份如果校園推廣專案的學校更多的話,你就會看出 ":" 威力何在了,所有同一類的會排在一起,相當清楚。

"/"的例子: Category:文件專案 我只看到這個,Firefox 一分鐘教室也是不錯的分法。

目錄和內容分開

這是我們一直強調的頁面編排方式,所以,以上兩種方式都有助於我們做這樣的編排

從屬關係的緊密度

這就是 xacid 特別點出來的地方,我直接複製,避免扭曲文意

<xacid 的觀點> 我想 wiki 上頁面的命名是很重要的,下面是我在 talk:dken 上寫的一些想法:

  1. 用頁面的主旨做為頁面名稱,可以讓新頁面的內容一目瞭然。
  2. 頁面名稱適當使用 ":" 或 "/" 等符號,勿濫用:
    • 使用 "xxx/abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 不可分割的頁面,並且和 "xxx" 有從屬關係。目前沒有良好例子,但像是 XUL Tutorial 這樣大型的文件,用 "/" 將不同章節的內容分開放在不同的頁面,應該很恰當。
    • 使用 "xxx:abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 有高度相關的頁面,並且和 "xxx" 有從屬關係。和 "/" 的區別是,用 ":"表達的頁面之間不具有不可分割的特性,例如 FAQ 和 FAQ:Firefox 。

</xacid 的觀點>

最後結論

為避免混淆,我們仍決定先不要使用":",以免造成後續發展的困擾。

個人工具