「使用說明:關於冒號和斜線的命名方式」修訂間的差異
出自 MozTW Wiki
Danielwang(對話 | 貢獻) 小 |
|||
(未顯示由 1 位使用者於中間所作的 2 次修訂) | |||
行 2: | 行 2: | ||
我分別從不同的角度來看: | 我分別從不同的角度來看: | ||
− | === | + | ===從 mediawiki 的定義來看=== |
所謂 "/" 用來表示 subpage, 我覺得更明白點的就是將 section 獨立到下一頁去,會有這樣的做法,可以說該類文件的 section 太多,因此會造成目錄和內容都擠在一起,所以將這些 section 獨立到一個頁面下,便於閱讀。最好的例子就是 XUL 那份文件。 | 所謂 "/" 用來表示 subpage, 我覺得更明白點的就是將 section 獨立到下一頁去,會有這樣的做法,可以說該類文件的 section 太多,因此會造成目錄和內容都擠在一起,所以將這些 section 獨立到一個頁面下,便於閱讀。最好的例子就是 XUL 那份文件。 | ||
行 8: | 行 8: | ||
例如: wiki 上的校園推廣專案 和 淡江大學是用 "校園推廣專案:淡江大學" 來表示其關係,我們可以清楚看到,校園推廣專案其實只是將那些專案集中起來,做個"分類"而已,但是他們並沒有"從屬關係",而 Moztw 專案 -> 文件專案 這是有"從屬關係"的,文件專案是歸類成 Moztw 專案的 "子專案",所以那個部份會使用 ":" 來表示。 | 例如: wiki 上的校園推廣專案 和 淡江大學是用 "校園推廣專案:淡江大學" 來表示其關係,我們可以清楚看到,校園推廣專案其實只是將那些專案集中起來,做個"分類"而已,但是他們並沒有"從屬關係",而 Moztw 專案 -> 文件專案 這是有"從屬關係"的,文件專案是歸類成 Moztw 專案的 "子專案",所以那個部份會使用 ":" 來表示。 | ||
− | + | ===從類別列表來看=== | |
− | === | ||
我們做的各類頁面名稱,都會直接顯示在類別頁裡,可是,類別頁只做 "subcategory" 和 "按英文子母排序" 的動作而已。 | 我們做的各類頁面名稱,都會直接顯示在類別頁裡,可是,類別頁只做 "subcategory" 和 "按英文子母排序" 的動作而已。 | ||
因此在這個部分,如果適當使用 "/" 和 ":",我們將可以直接從類別頁看出不同文章的歸屬狀況。 | 因此在這個部分,如果適當使用 "/" 和 ":",我們將可以直接從類別頁看出不同文章的歸屬狀況。 | ||
− | ":" 的例子: | + | ":" 的例子: [[:Category:推廣專案]] 這個部份如果校園推廣專案的學校更多的話,你就會看出 ":" 威力何在了,所有同一類的會排在一起,相當清楚。 |
− | |||
− | 這個部份如果校園推廣專案的學校更多的話,你就會看出 ":" 威力何在了,所有同一類的會排在一起,相當清楚。 | ||
− | |||
− | |||
− | |||
− | |||
+ | "/"的例子: [[:Category:文件專案]] 我只看到這個,Firefox 一分鐘教室也是不錯的分法。 | ||
− | === | + | ===目錄和內容分開=== |
這是我們一直強調的頁面編排方式,所以,以上兩種方式都有助於我們做這樣的編排 | 這是我們一直強調的頁面編排方式,所以,以上兩種方式都有助於我們做這樣的編排 | ||
− | + | ===從屬關係的緊密度=== | |
− | === | ||
這就是 xacid 特別點出來的地方,我直接複製,避免扭曲文意 | 這就是 xacid 特別點出來的地方,我直接複製,避免扭曲文意 | ||
行 32: | 行 25: | ||
我想 wiki 上頁面的命名是很重要的,下面是我在 | 我想 wiki 上頁面的命名是很重要的,下面是我在 | ||
talk:dken 上寫的一些想法: | talk:dken 上寫的一些想法: | ||
− | + | #用頁面的主旨做為頁面名稱,可以讓新頁面的內容一目瞭然。 | |
− | + | #頁面名稱適當使用 ":" 或 "/" 等符號,勿濫用: | |
− | + | #* 使用 "xxx/abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 不可分割的頁面,並且和 "xxx" 有從屬關係。目前沒有良好例子,但像是 XUL Tutorial 這樣大型的文件,用 "/" 將不同章節的內容分開放在不同的頁面,應該很恰當。 | |
− | + | #* 使用 "xxx:abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 有高度相關的頁面,並且和 "xxx" 有從屬關係。和 "/" 的區別是,用 ":"表達的頁面之間不具有不可分割的特性,例如 FAQ 和 FAQ:Firefox 。 | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</xacid 的觀點> | </xacid 的觀點> | ||
+ | |||
+ | ===最後結論=== | ||
+ | 為避免混淆,我們仍決定先不要使用":",以免造成後續發展的困擾。 |
於 2005年10月23日 (日) 00:26 的最新修訂
我覺得之前 xacid 在談論 "/" 和 ":" 的使用時機時,有將那個區別點出來。 我分別從不同的角度來看:
從 mediawiki 的定義來看
所謂 "/" 用來表示 subpage, 我覺得更明白點的就是將 section 獨立到下一頁去,會有這樣的做法,可以說該類文件的 section 太多,因此會造成目錄和內容都擠在一起,所以將這些 section 獨立到一個頁面下,便於閱讀。最好的例子就是 XUL 那份文件。
所謂 ":" 在 mediawiki 裡的定義是 sisterproject ,這個字,我不知道該如何去翻譯,但是從字面上我們可以大致了解它所代表的函意,直接舉例: 例如: wiki 上的校園推廣專案 和 淡江大學是用 "校園推廣專案:淡江大學" 來表示其關係,我們可以清楚看到,校園推廣專案其實只是將那些專案集中起來,做個"分類"而已,但是他們並沒有"從屬關係",而 Moztw 專案 -> 文件專案 這是有"從屬關係"的,文件專案是歸類成 Moztw 專案的 "子專案",所以那個部份會使用 ":" 來表示。
從類別列表來看
我們做的各類頁面名稱,都會直接顯示在類別頁裡,可是,類別頁只做 "subcategory" 和 "按英文子母排序" 的動作而已。 因此在這個部分,如果適當使用 "/" 和 ":",我們將可以直接從類別頁看出不同文章的歸屬狀況。
":" 的例子: Category:推廣專案 這個部份如果校園推廣專案的學校更多的話,你就會看出 ":" 威力何在了,所有同一類的會排在一起,相當清楚。
"/"的例子: Category:文件專案 我只看到這個,Firefox 一分鐘教室也是不錯的分法。
目錄和內容分開
這是我們一直強調的頁面編排方式,所以,以上兩種方式都有助於我們做這樣的編排
從屬關係的緊密度
這就是 xacid 特別點出來的地方,我直接複製,避免扭曲文意
<xacid 的觀點> 我想 wiki 上頁面的命名是很重要的,下面是我在 talk:dken 上寫的一些想法:
- 用頁面的主旨做為頁面名稱,可以讓新頁面的內容一目瞭然。
- 頁面名稱適當使用 ":" 或 "/" 等符號,勿濫用:
- 使用 "xxx/abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 不可分割的頁面,並且和 "xxx" 有從屬關係。目前沒有良好例子,但像是 XUL Tutorial 這樣大型的文件,用 "/" 將不同章節的內容分開放在不同的頁面,應該很恰當。
- 使用 "xxx:abc" 的時機: "xxx" 頁面已經存在,要新增一個和 "xxx" 有高度相關的頁面,並且和 "xxx" 有從屬關係。和 "/" 的區別是,用 ":"表達的頁面之間不具有不可分割的特性,例如 FAQ 和 FAQ:Firefox 。
</xacid 的觀點>
最後結論
為避免混淆,我們仍決定先不要使用":",以免造成後續發展的困擾。