User:Wini:wiki

From TestingMediawiki
Jump to navigation Jump to search

Title

winiwiki 是個人所思想的一種 wiki 概念,並沒有任何成品出來過,不用找了。(汗)

簡單說明 winiwiki 的概念,就是透過簡單的客製化 custom 的設定,來讓 wiki 變得比較易於書寫,並藉著將樣式當成與內文不相關的額外資訊,來將內文與樣式分開,避免書寫者過度重視樣式而忘了內文的重要性,並將樣式的處理交由其他有能之士來書寫。

總之這是避免讓書寫者一開始就得為樣式而煩惱結果導致其創作進度遲緩,並且提供 style 的定義 CSS 樣式用的屬性,讓書寫者可以有自行選擇向上提升自我的機會。

Main

winiwiki 的設定及使用步驟很簡單。依序如下。

  1. 客製開始及結束標籤的格式
  2. 記住基本的書寫架構及系統保留的標籤
  3. 學習如何書寫關於自己想使用的樣式並注意其樣式所涵蓋的範圍應該有始有終
  4. 利用備註標籤來對文件加以說明任何該說明的事項比如說你的任何客製化資訊

以下由前言開始說起,最後會附上一個我個人自訂的範例供各位參考。

introduce

前言:
如何讓文字創作者將自己的文字加上樣式的第一步就是讓任何人都知道你的原稿要怎麼閱讀並轉換成你所希望的表現格式及外貌樣式。

亦即是遵守極少的規則,並加上詳細說明著你所自訂的格式的置頂說明,然後你就可以將關於想展現的樣式附在文章中,讓別人來幫你處理成正確的語法了。不過自己做出的「原始稿」跟別人所加製的「修改稿」一定要分開來存放,這是伺服端來設定的,不必用戶端操心倒是。

set your stylish tag

設定開始及結束標籤的格式:
為何要有開始及結束標籤呢?那是為了方便辦識該對哪一個地方下樣式定義。如果你只定義了粗體字的開始標籤,卻沒有給它結束標籤的話,在它之後的就全都是粗體字了,不過你可能事實上只希望幾個字是粗體字而已。

你可以用任何自訂的字來表示開始標籤 start tag 及結束標籤 end tag ,只要你覺得你不會搞混就好,例如說以下四種。

  1. /=/粗體字的開始標籤/內文/-/粗體字的結束標籤/
  2. /=粗體字的開始標籤/內文/-粗體字的結束標籤/
  3. (s粗體字;內文(e;
  4. /keywordS:粗體字的開始標籤/內文/keywordE:粗體字的結束標籤/

fixed tag

系統內定的標籤以及建議的書寫格式。
為了避免各位不知如何下手,所以準備了基本的幾個標籤元件跟推薦的書寫格式。

內定的標籤如下。請注意不要在客製化開始結束標籤時跟這些衝到。

  • h |- 大綱標題,在 h 的後方緊接著 1 到 7 的數字,則代表其為第一層至第七層的大綱標題,一般來說文件第一個大綱標題用 h1 比較好。
  • p |- 段落,想要將一段文章當做一個段落以跟其它文章分段時,可以使用這個標籤,或是直接跟前後段保留一行空行也行。
  • br |- 強制斷行,這個元件比較特別,它沒有與開始相成對的結束標籤,所以可以不必打結束標籤,或是在 br 其後緊接著結束標籤也可以。
  • table |- 表格,這個的使用比較特別,容我後述。
  • ol |- 物件列表,這個的使用比較特別,容我後述。
  • ul |- 無物件列表,這個的使用比較特別,容我後述。
  • 特殊說明:超連結和圖片、以及其超連結文字和替代文字 |- 超連結需要有超連結文字才會顯示出來,不然就只是個單純指向某目標的隱藏元件而已。而圖片則是需要有替代文字才不會在圖片無法顯示時,冒出些無意義的資訊。使用的方法很簡單。「[指向某目的地或是圖片的url 超連結文字或是替代文字]」,簡單說用 [ 和 ] 包起來,中間用一個半形空格分開來就行了。
  • 特殊說明:分隔線 |- 分隔線不必用得太長太花俏,只要用四個連續的橫線減號「----」,獨立在一行中表示就好了。

基本的推薦書寫格式,便是只用上述標籤元件來寫就足夠了。

h1
p
p
h2
p
ol
h2
table

example

輸出成什麼格式的文件?html或?

Navigation

您的位置: ACnowiki >> Wini >> 個人各項筆記: winiwiki