:::

玉口香扁食園政大店

布丁布丁吃布丁

玉口香扁食園政大店

  • 店名:玉口香扁食園政大店
  • 位置:政大女生宿舍側門正對面
    image
  • 菜單:扁食、一主菜三副菜的飯類
  • 價位:45~85 NTD
  • 座位:舒適,高峰時期偶爾還等得到座位
  • 環保:提供非免洗的筷子與湯匙

玉口香扁食園簡介

IMAG0082

玉口香扁食園是很常見的連鎖店,相信不少人應該都在各地看過扁食園的招牌。就我所知,在木柵內就有3家扁食園,而現在介紹的則是位於政大側門對面的政大店,以夏都將此店簡稱為扁食園。

扁食園距離政大側門很近,而且是女生宿舍最近的外面店家之一,所以高峰期還不太容易找到座位。扁食園的店內環境乾淨舒適,座位大、桌椅穩固,坐起來是挺舒服的。店內提供付費購買的飲料,只是種類不多,幾乎都沒有我喜歡喝的飲料,所以就沒有特別去記。雖然我沒比較過價錢,但也不會貴得太誇張的樣子。

IMAG0083

菜單大致上可分成兩大類:扁食與其他飯麵類。

既然叫做扁食園,自然扁食是其重點。扁食就是餛飩,只是扁食園的餛飩非常大顆,份量大到可以當主食吃,接近於水餃的感覺。而且根據我吃過多家扁食餐點的經驗來說,玉口香扁食園政大店的扁食我個人覺得比起其他店來說更為飽滿、美味

扁食有四種:鮮蝦、鮮肉、蔬菜以及綜合。因為我不喜歡吃海鮮,所以我最常吃的是鮮肉類,扁食內包的是豬肉。而蔬菜扁食類不知道為什麼味道非常地嗆,而麵與湯也不太清淡,結果就是味道很重,個人並不推薦。

飯類整體來說普通,燒烤雞腿飯還算不錯吃。但除了部分可當正餐吃之外,大部分都是配餐等級的餐點。雖然不差但都只能說是普通。而且因為大部分餐點味道重、吃完都會口渴,也就是暗地裡鼓勵客人購買飲料的意思吧。


鮮肉扁食湯麵(65NTD)與紅油炒手麵(75NTD)

IMAG0084

鮮肉扁食湯麵65元,有八顆扁食、蔬菜與湯。麵是細的黃麵,量不多,可另外付10元加麵。湯的味道算是清淡,但直接喝完還是有點鹹。

IMAG0085

鮮肉紅油炒手麵 75元,一樣有八顆扁食(數量有點忘了)、乾麵、紅油海苔與醬料等調味。跟湯麵一樣,麵的份量就像是配餐一樣地不多,主角依然是扁食。紅油炒手可以選擇辣的程度:大辣、中辣、小辣及不辣。我個人不吃辣所以並不確定辣的等級在眾人心中的程度為何,但是紅油醬料搭配非常地提味、好吃!

IMAG0086

重點的扁食,不算厚的麵皮、豐滿的內餡,這大概是我要吃三口才吃得完的份量。可惜拍照時焦距怎樣都對不準,大概是手機的極限了吧。


結語

剛開始營業時,扁食園還有買十送一的活動,而這活動結束之後我也較少去吃了。畢竟扁食份量較少、味道也重鹹,而我常吃的這兩種餐點也算是中價位,所以都是心血來潮才會去吃。

(more...)

政大憩賢樓豆豆屋

布丁布丁吃布丁

政大憩賢樓豆豆屋

  • 店名:豆豆屋
  • 位置:政大校內山下校區
    image
  • 菜單:一主菜(雞、豬、牛、魚)三副菜的飯類、附湯
  • 價位:40~75 NTD
  • 座位:高峰時期不容易找到座位
  • 環保:提供非免洗的筷子與湯匙
  • 服務:要自行取餐與回收餐具

豆豆屋簡介

IMAG0075

政大位於校內的學生餐廳:憩賢樓,裡面有著許多餐廳店面,比起外面指南路上來說價位稍微便宜一點,而大量的桌椅、多台電視以及最重要的距離教室很近,都是憩賢樓用餐的優點。

IMAG0070

其中我很喜歡吃的是這家:豆豆屋

IMAG0071

販售菜單幾乎都是飯類,有雞、牛、豬、魚等主菜,再搭配三樣副菜,以及超大碗的白飯,此外還有湯。可加飯加湯。雖然有附湯,但是最近附湯只剩下便宜的紫菜蛋花湯,而且有時候還很難喝,實在不能說令人期待。

特色的是「牛排飯」是用煎的牛排。至於煎得好不好吃這點我不予置評,65元的餐點跟外面專業牛排館還是有很大一段差距,但至少便當店能看到牛排飯這種餐點的確是很少見的。

IMAG0072

點餐之後會拿到號碼牌,然後就可以回去座位,等待櫃檯叫號。因為憩賢樓人多吵雜,有時候叫號會被人聲掩蓋,要多多小心才是。希望未來憩賢樓可以在各家店上加裝號碼顯示器,這樣子會對客人來說好很多。


豆豆屋豬排飯 65NTD

IMAG0073

上圖是65元的豆豆屋黑胡椒豬排飯。豬排是用炸的,搭配三樣副菜:海帶、高麗菜、以及另一樣青菜,副菜很普通,最後淋上黑胡椒醬,下面則是一大碗的白飯。

IMAG0074

我很喜歡豆豆屋炸的豬排,有一定的厚度,炸的方式是我非常喜歡的種類(我也不太會形容這是什麼種類,但是炸排骨的種類很多,像是裹粉、炸的時間等就會有不同種類)。此外,骨頭也不多或吃不到骨頭。

黑胡椒醬雖然不濃,但是淋在飯上就非常下飯。搭配豬排的味道就很香很順口,是我喜歡這項餐點的第二關鍵。

如果運氣好的話,以前附湯還會出現玉米濃湯。早期還不錯喝,可惜近期就算出現玉米濃湯,味道也是乏善可陳。


結語

雖然憩賢樓看起來有在努力裝潢、活動時也都有對應的佈置,讓人覺得生氣蓬勃。但是看著豆豆屋從開業到現在的餐點轉變,我還是總覺得憩賢樓逐漸蕭條中。作為校內便宜餐點的學生餐廳來說,我還是很希望他能繼續營業下去。加油吧。

(more...)

從建立到現在,「布丁布丁吃?」blog的轉變

布丁布丁吃布丁

0 Comments

從建立到現在,「布丁布丁吃?」blog的轉變

因為之後有一個問題是在問內容架構分類,所以我想這個問題就從系統功能面開始聊起吧。


草創期:MSN Space與摸索

我一開始撰寫blog的時候是使用MSN密切結合的MSN Space。儘管撰寫一些簡單的文字還可以,也有人在為MSN Space開發一些小功能,但是整體來說MSN Space是非常不自由且功能貧乏的。不滿於MSN Space的我繼續找尋其他的blog服務提供者,最後找上了Blogger

當時臺灣最有名的blog服務提供者其實是無名小站,還有不少其他臺灣在地的服務,像是中華電信的Xuite日誌、後來出現的痞客邦,甚至我社團朋友許多人喜歡上擁有漂亮版型的日本blog提供者FC2

但這是這些blog提供者都有些共通的弊病,像是無名小站不遵守網頁語法標準(後來不知道有沒有改)、大部分都固定版型、功能,而無法自行設計。特別是像我喜歡在blog中寫些JavaScript程式,很多blog提供者就會強制擋掉。

因此過不久之後我就轉移平台到了Blogger。而MSN Space後來更名成為Windows Live Space,而且在最近2010年底默默地收掉了。

Blogger初期

相較於其他的blog提供者,Blogger在臺灣默默無名,而且至今我週遭朋友仍大多都不知道Blogger。其實這理由很簡單:因為它難用。

儘管Blogger開放整個Blog樣板供使用者自行設定,但是懂得網頁語法的人少、要熟知Blogger專用語法的人更少,大部分的使用者並沒有能力去設定Blogger的版面。而且Blogger提供的版型不僅少到可憐,還一點也不能吸引年輕人使用。

事實上,從建立blog到現在,「布丁布丁吃?」的網站版型一直沒有做過大幅度變更。你現在所看到的就是Blogger初期提供的少數版型中,我覺得還可以看的其中一個版型。然後我再自行撰寫CSS跟JavaScript,微調版面、增加功能,最後才變成現在這個樣子。

儘管前面我提到MSN Space功能貧乏,但初期的Blogger真的一點也不輸他。沒有最新文章、沒有最新回應、沒有留言板、沒有統計功能,以及致命的沒有漂亮的版型跟有的沒得小玩意兒,這些缺點馬上讓一堆人打退堂鼓。

但是相反的,也是有人喜歡Blogger的自由度,於是撰寫了JavaScript程式來豐富Blogger的功能,而我也是其中的一員。現在你右邊看到的最新文章跟最新回應訪客留言板,都是我參考網路上的文章、修改加上去的手製功能。儘管撰寫程式的確不是很容易,但我真的很喜歡寫JavaScript程式來讓這個blog更豐富,就像是佈置自己的小窩……而且還是純手工的小窩!

每當我偶爾調整一下Blogger上的功能時,看著以前寫的生澀程式碼,就會覺得現在的自己稍有成長。這種在寫blog背後的經驗也令我回味無窮。

Blogger到現在

到現在為止,剛剛說的Blogger缺點,幾乎都已經改善。要最新文章有最新文章、要最新回應有最新回應、要統計功能有統計功能,還有匯入/匯出、手機專用版本等更為強大的功能。儘管版型變多了、更容易調整了,但還是非常西方人的風格,而不太能夠切中喜歡可愛、帥氣的我國民情。不過版型對我來說倒不是重點,所以至今「布丁布丁吃?」也幾乎沒有改過版型。

看著Blogger提供了那些當年自己努力了好久才寫出來的功能,多少會感到有點一代新人換舊人的失落感。不過Blogger的那些功能也不見得能完整符合我的需求,所以那些純手工的功能我仍保留在右方,也算是一種懷舊行為啦。

除了Blogger的功能之外,我在撰寫工具上也從Blogger網頁改用了Windows Live Writer,瑣碎記事改用Plurk記錄,撰寫方式也逐漸地有所轉換。原本我是希望用手機來寫blog,但後來發現手機難以讓我寫篇圖文並茂的文章,後來就放棄了,乖乖在桌上型電腦面前好好地把文章寫出來比較實在啦。


小結

這一篇簡單地敘述了「布丁布丁吃?」在系統功能上的轉換。儘管很多都是雞毛蒜皮不值一提的瑣碎事情,但是既然這幾篇都是記錄,那就多少寫一下,方便之後拿出來嘲笑吧。

下一問:

「布丁吃布丁?」文章的分類:blog發表的文章是否有特定架構或規則?例如以知識面跟生活面?這樣的架構或規則是有其意義嗎?

(more...)

為什麼會想建立「布丁布丁吃?」blog?

布丁布丁吃布丁

0 Comments

為什麼會想建立「布丁布丁吃?」blog?

最近因為種種緣故,有人來問我「布丁布丁吃?」blog經營的一些問題。但是因為我從來覺得我有在「經營」這個blog,看到問題時腦袋一片空白,完全不知道該如何回答。基於這個因緣,加上我最近又因為某些緣故所以不在這邊聊研究相關的東西,所以藉由這個機會,我就一邊整理這些問題的答案,一邊在這邊做個記錄。


這個blog的念法是「布丁布丁吃什麼」

大部分的讀者都不知道這個blog的念法,而直接稱之為「布丁布丁吃」。其實你們這樣念的時候也覺得很奇怪吧,為什麼「吃」後面沒有受詞,而是接一個疑問符號呢?這是因為我並沒有特定要吃「什麼」。

一開始可能吃點「Aquarian Age 水瓶世紀」、吃點「ACG圖片」,接下來吃點「大學時的報告」、「研究所時的報告」,然後吃點「網管筆記」、「研究方法」,現在則是吃「論文進度報告」。

接下來到底要吃什麼?我也不知道。就繼續讓他是一個問號,看到什麼就吃什麼吧。

 

建立「布丁布丁吃?」的動機

一開始是因為在大三時高錦雪老師的「讀者服務」期末報告寫了一篇「以部落格實作讀者服務工具初探──圖書館部落格運作實例分析」,於是我也跟著用用看blog這個服務。那個時間是2005年,第一篇文章是本blog的留言板,後來被我拿來改成右側那個訪客留言板用。

建立「布丁布丁吃?」的理念其實受到毛慶禎老師的影響很深。毛老師不斷跟學生倡導網際網路自由、永久流傳的真理,不管有價值、沒價值的東西,只要在網路上公開讓人使用,總有一天會有人需要他。所以我建立了「布丁布丁吃?」,而且寫了許多一般人不會想看的文字,因為我也跟毛老師一樣,相信總有一天會有人需要這些「孩子」

也許你會覺得這個理由看起來蠻冠冕堂皇的,但換個角度來說,其實也不過是亂無章法地把一些資訊投入網際網路而已。也因此,我並不會覺得這是什麼特別的想法。這種作法網路上大家都在做,我許多的知識也都是從網路上搜尋而來,而我也只是遵循那些我獲益的方式,而將這種精神繼續延續下去而已。

因為這個blog並沒有特定主題或方向,所以我甚至覺得訂閱這個blog也不見得會得到你想要的資訊。比起特地去分析這個blog整體在做些什麼,不如從中找到一兩篇你感興趣、你需要的資料,然後開心地拿去用,有空的話也打幾個字鼓勵一下,我才覺得這是「布丁布丁吃?」的真正用法。

簡單來說,使用「布丁布丁吃?」的最佳途徑,我認為是透過搜尋引擎找到你想要的資料,然後就那一篇資料能夠對你有幫助,這樣就夠了。

題外話:毛老師與網路標準

題外話,雖然離開輔大很久了,但毛老師講起網路精神時神采奕奕的樣子還是令我印象深刻,他真的是位非常有趣的老師。不過我必須說明一下,毛老師應該會非常厭惡打開這個blog,因為它擁有我許多基於個人而作的非標準、高門檻功能,而這對撥接速度、舊版本網路瀏覽器來說是非常難以閱讀的。

如果你也是有「為什麼每次打開布丁的blog,瀏覽器就像是要當掉一樣」的困擾,那我除了希望你趕快捨棄IE改用FirefoxChrome之外,也建議你改用手機版介面來讀取,速度會快很多。感謝Google團隊為Blogger添增的這個功能,我真的覺得他超棒的。


小結

建立跟動機差不多在這篇講完了,雖然很短,但這也是因為建立一個blog並不困難,一個簡單的想法就可以去做、去實行,然後繼續幫網際網路堆積垃圾文字

預定下一問:建立「布丁布丁吃?」的過程中有什麼轉變嗎?是什麼造成這樣的轉變?

(more...)

序列分析簡介 Sequential Analysis Introduction

序列分析簡介 Sequential Analysis Introduction

image

序列分析是一種行為分析的工具,國內研究者侯惠澤老師是應用序列分析數位學習行為的專家。最近聽老師演講受到他的啟發,我也去借了Bakeman跟Gottman(1986)的「Observing interaction : an introduction to sequential analysis」來看,了解序列分析是怎麼分析資料,順便將之整理成方便計算的小工具,供大家使用。

序列分析簡介

話說回來,序列分析到底是什麼呢?

在做研究記錄的時候,我們可以把各種「事件」進行「編碼」,然後依照時間順序排列,就可以得到一連串的事件序列觀察樣本。以一群分組合作的學生為例,研究者在觀察他們行為的時候,可以將「各做各的」編碼為「A」、「討論作業」編碼為「B」、「創新意見」編碼為「C」、「聊天」編碼為「D」,於是可以得到「ABDCACDABACADCB」這樣子的資料。從這邊我們可以探討學生行為轉換究竟哪一種比較明顯的議題,最後可能會發現「討論作業」轉換到「創新意見」有顯著高的頻率,那麼我們就可以說學生在「討論作業」時比較容易進入到「創新意見」,並畫出本頁開頭的那張圖。

附帶一提,其實頁首的那張圖是序列分析工具範本觀察樣本算出來的結果。從範本觀察樣本輸入的「ABBDCCAABCBDBCBBBBCDDBCBCBCBBDBCDB……」可以變成這樣的轉換示意圖,你就可以知道序列分析多麼有用了。

進行序列分析研究需要幾種知識:

  1. 觀察記錄
  2. 行為編碼
  3. 序列分析
  4. 解釋資料

其中1跟2是許多質性研究內容分析法都會探討的議題,而在序列分析裡面更傾向於行為事件的編碼。3跟4則是利用機率統計z分數二項式檢定的顯著性來描述、解釋資料的作法,這就是序列分析需要學習的關鍵。

介紹投影片

為了跟大家解釋怎麼去找出「ABDCACDABACADCB」的關連、並計算其顯著性,我做了一個簡單的投影片供大家參考:(SkyDrive備份)

如果你覺得計算序列分析很麻煩,也可以用用看我寫的序列分析工具,應該有助於你快速分析出資料的規則。至於要怎麼觀察、編碼,那就不是我的領域了,請努力進行文獻探討跟身體力行吧!

參考文獻

  • Bakeman, R. (1986). Observing interaction : an introduction to sequential analysis. Cambridge ;New York: Cambridge University Press.
  • Hou, H. T.,* Chang, K. E., & Sung, Y. T. (2010). Applying lag sequential analysis to detect visual behavioral patterns of online learning activities. British Journal of Educational Technology, 41, 2, e25-27.
(more...)

序列分析工具 Sequential Analysis Tool

序列分析工具 Sequential Analysis Tool


(more...)

你覺得論文要做到什麼程度呢?

布丁布丁吃布丁

0 Comments

你覺得論文要做到什麼程度呢?

image

今天來談談一些論文週遭的事情。你覺得,作為一個研究生,論文要寫到什麼程度才算是可以呢?

學弟說:「老師都留你這麼久了,應該是可以畢業了吧。」

另一位老師說:「你這樣就可以了啦,趕快邁入下一個階段吧。」

我的老師也覺得這個系統做到這樣就差不多了。

可是,我卻覺得還差得很遠。系統的完成度、實驗規劃、分析的方法、撰寫論文的能力,我都還差得很遠很遠。


作研究與系統完成度的矛盾

一個基本的概念是說,我做的這個系統,跟論文本身並沒有直接的關係。很多時候我比較是傾向於讓使用者用得更順利、更容易上手的方向去做,然而這跟論文的核心是沒有關連的。即使用了一整天的時間只為了防止標註時位置跳走的問題,在論文上依然不會為此寫上任何一個字。

研究者是對使用者很殘忍的一種角色,我常常會有這種感覺,特別是做與人相關的研究,而這也是個事實。研究者只是為了利益(實驗的結果)而榨取使用者,儘管這不是很能夠上手的東西,使用者也不見得會喜歡,但是為了實驗、為了寫論文、為了發表,就將就地配合來做吧。

我並不是說為了研究而給使用者作的系統一定很難用,但是為了研究考量,總是會希望能以最少的成本獲得最大的利益,這也是合乎常理的想法。用簡單地架構把論文核心相關的概念用上去,並且快速地實作出來,作實驗,分析,寫論文,這是最快的方式。

事實上,出去工作之後,應該也是一樣的道理。只要能賣錢,系統越快完成越好。

只是,你覺得論文做到這樣的程度就夠了嗎?


人生的下一個階段到底是什麼呢?

不知道大家是不是都是經過社會化的洗禮,很多老師都會跟我講一樣的話:

 

「你要趕快邁入人生的下一個階段。」

 

只是很遺憾的,我資質駑頓,至今仍不知道人生的下一個階段要幹嘛好,

我是一個沒什麼欲望的人。每天能三餐溫飽、晚上睡個好覺,平時有還算順口的白開水可以喝,最好是能喝到一條7元的沖泡咖啡,再來找些事情作一作,這樣我的一天就非常滿足。

現在如此,我想之後也會是如此。

人生是還有很多要學的東西,也是有很多需要去努力的東西,這些我都知道。不過那到底是不是人生的下一個階段,這我就不是很清楚。

我只知道,如果我在這階段作的事情,通常是不太會帶到下一個階段去繼續做。舉例來說,論文寫到什麼程度,大概都跟我以後找工作作的事情沒什麼關係。儘管自身擁有的技術跟知識是可以帶著走的,但我也不認為真的遇得到可以把這些都派上用場的工作。即使是繼續進修,我覺得我學的東西大概也跟現在在做的東西又是全然不同的事物,這種事情俯拾即是。

如果每次這樣子切換到下一個階段時,都會如此地將自己重置,那麼為什麼大家要如此追求人生下一個階段呢?


那麼,預計要什麼時候畢業?

雖然之前還會排行程表來規劃時程,但是後來發現自己能力太差,需要學習與鑽研的東西與預計行程有好大的一段差異,所以之後就不太參考那張表,只是努力地做下去。

老實說,這並不是一件好事,就工作能力來說。

但是,這卻是一件愜意的事情。

當學弟問我預計要何時畢業的時候,我只能回答「不知道,我只想著怎樣把這系統寫好、實驗做好」的時候,某方面來說是很令人感到愉悅的事情。

我只是個資質駑頓的人,一次只能做一件事情。所以我只關注在一件事情上,然後把這件事情做好,這樣就很滿足。

從另一個角度來說,大概就是我覺得滿意了,我就會想要去畢業了吧,這種感覺。

儘管人生事事難如意,也不會有真的做到滿意的這種情況發生,也許這只是心智不成熟的我想要的小小任性而已。


論文不寫、系統不做地寫這種東西,我也覺得現在的我是在耍任性。

我果然是個死小孩啊XD

(more...)

論文進度報告(2010/11/27):KALS!標註工具說明

布丁布丁吃布丁

論文進度報告(2010/11/27):KALS!標註工具說明

image

主要功能差不多算是完成了,雖然還有一些bug,但總算是具有可以拿出來見人的程度。儘管我認為如果要讓使用者很開心地使用KALS!標註工具的話,仍有許多需要調整的地方,不過進度有點迫在眉睫了。

以下是KALS!標註工具的說明內容,有興趣的讀者可以從說明一窺KALS!的介面與功能,也算是論文進度到一個段落的報告吧!


什麼是KALS!標註工具?

KALS!標註工具是一種附掛在HTML網頁上的標註工具。他可以剖析、調整HTML的內文,將原本靜態的網頁加上「標註」的功能。

使用者可以透過KALS!標註工具為網頁上的文字新增標註並填寫補充的筆記,也可以瀏覽其他人的標註針對其他人的標註進行討論,或是將其他人的標註加入「喜愛清單」,給予他一個鼓勵。

KALS!標註工具會在網頁上將重要性較高的範圍文字標示為紅色的文字,並根據使用者的標註行為,適時地提供閱讀技巧的「建議」與「推薦標註」,進而提昇使用者的閱讀能力。


操作介面介紹

KALS!操作介面

kals_interface

KALS!操作介面

  1. 工具列:畫面最上方會顯示工具列,您可以在工具列中進行「登入」、「註冊」、「登出」、設定「帳號資料」 與「標註顯示」,或是查閱「說明」。
  2. 標註顯示:使用KALS!標註工具的網頁文字上會顯示標註的狀況。畫底線的文字表示是現在登入帳號的標註,也就是您標註過的部分;紅色的文字是KALS!的指示,表示比較重要的部份。此外,在選取標註範圍、顯示標註範圍、顯示推薦標註飯範圍時,皆會有不同的字體顏色與框線。以下介紹到各工具時會一併說明。
  3. 選取提示:當您滑鼠移到網頁文字上時就會顯示選取提示,如果您要選取這個文字,請點選這個選取提示以確定。您也可以直接點選網頁文字來選取。
  4. 標註工具:新增、管理、瀏覽標註的主要工具。選擇標註範圍之後就會顯示標註工具。
  5. 建議工具:顯示建議、推薦標註的工具。在新增標註之後,或是瀏覽標註時點下建議圖示就會顯示。
工具列

kals_toolbar_fig1

工具列介面:未登入的狀態

使用KALS!標註工具的網頁上方會固定顯示工具列。工具列在未登入之前的顯示狀態如上圖,左方是KALS!標題,右邊則是可以使用的功能,包括「登入」、「註冊」、「標註顯示」與「說明」。請以滑鼠點選各功能開啟。

  • 登入:以您註冊過的電子信箱地址與密碼來登入KALS!。登入之後才能進行新增標註及更多的動作。
  • 註冊:用電子信箱地址與密碼來建立一個新的帳號。
  • 標註顯示:設定網頁上顯示的標註,包括您的標註與推薦的標註。
  • 說明:開啟KALS!的說明視窗。

kals_toolbar_fig2

工具列介面:登入之後的狀態

當您登入或註冊之後,工具列會隨著您的帳號而改變。左方是KALS!標題,右邊則是會顯示您的「名字」,以及其他可以使用的功能,包括「帳號資料」、「登出」、「標註顯示」、「說明」。

  • 帳號資料:設定此帳號的名字、性別及變更密碼。
  • 登出:將目前登入的帳號登出。
標註顯示

filter_fig1

網頁文字上的標註顯示

KALS!會依照您的登入狀況而在網頁上呈現不同的標註顯示。各種標註顯示如下:

  1. 畫底線的文字:表示自己的標註,不同顏色的底線表示不同的標註類型。當您在重複的位置標註,並使用不同的標註類型時,KALS!只會顯示您最新的標註。
  2. 紅色的文字:表示KALS!推薦的標註,可能是很重要的部分喔。
  3. 藍色框線的文字:表示您目前選取的範圍
  4. 藍色的文字:表示您目前瀏覽的標註的範圍。詳細介紹請見標註工具的說明。

filter_fig2

建議工具的標註顯示

在使用建議工具時,則會顯示需要建議的標註與推薦標註的範圍。

  1. 綠色框線的文字:表示您需要建議的標註的範圍
  2. 綠色的文字:表示推薦給您的標註的範圍
標註工具

annotation_tool

標註工具介面

當您在網頁上選取要標註或瀏覽的範圍之後,標註工具便會自動顯示在您選取範圍的附近。

標註工具的功能包括:

  1. 標註工具標頭:標頭有「移動」跟「關閉」功能。您可以在「移動」上拖曳標註工具,或是點選「關閉」以關閉標註工具。
  2. 標註編輯器:您可以在此新增、編輯標註。詳細介紹請見標註編輯器的說明。
  3. 編輯器顯示切換開關
  4. 標註列表:列出您標註範圍重疊的所有標註,以您的標註、您喜愛清單的標註以及其他標註的順序條列。詳細介紹請見標註列表的說明。
標註編輯器

annotation_editor_fig1

標註編輯器介面

您能透過標註編輯器新增、編輯標註。標註編輯器的功能包括:

  1. 顯示作者的名字,也就是您的名字。
  2. 標註類型選擇。
  3. 編輯筆記。
  4. 遞交標註的「新增」。如果是編輯標註中,則可以「更新」完成編輯,或是「取消」編輯。

annotation_editor_fig2

標註編輯器的標註類型選單

點下標註類型(預設是顯示「重要」),右邊就會帶出標註類型選單。每個標註類型都表示不同的標註策略,目前有五種標註類型:

  • 重要:標示文章中重要的段落。要熟知這篇文章,就必須要熟讀的部份。
  • 困惑:標示您對文章內文產生困惑的地方。
  • 質疑:標示您質疑文章內文是否正確的地方。
  • 舉例:記錄或補充與文章內容的相關資料、舉例。
  • 摘要:用自己的話來歸納文章的摘要內容,像是註明原因、影響、特色等等。

annotation_editor_fig3

標註編輯器的筆記編輯器

您可以利用筆記編輯器補充標註的內容。筆記編輯器具備所見即得的功能,您可以為您的筆記添加格式,像是字體粗細、大小、顏色。

annotation_editor_fig4

全螢幕的筆記編輯器

點選筆記編輯器左上角的「annotation_editor_maximum 最大化」按鈕,就可以放大筆記編輯器的編輯空間。除此之外,筆記編輯器也會顯示完整的工具列。放大的筆記編輯器中還可以插入表格、圖片、甚至是YouTube的影片。

標註列表

annotation_list_fig1

標註工具中的標註列表與標註選單

標註列表是條列您選擇範圍之下重疊的所有標註。條列的規則為:

  1. 您的標註:依照更新日期由新到舊排序。
  2. 您喜愛清單的標註。
  3. 其他標註:依照重要性由高到低排序。

annotation_list_fig2

標註列表介面

標註列表的介面中包含以下功能:

  1. 標註顯示藍色的文字:將滑鼠移至標註列表的標註中的時候,網頁文字上會以「藍色的文字」來標示。
  2. 作者的名字。如果作者是您現在登入的帳號,那麼名字會加上底線
  3. 標註類型
  4. set-is-liked 加入/set-is-not-liked 移出喜愛清單:您只能對不是您的標註進行加入/移出喜愛清單的動作。當您將該標註加入喜愛清單之後,這個功能就會變成移出喜愛清單。
  5. 喜愛人數:當有人將此標註加入喜愛清單之後,此處會顯示已經加入喜愛清單的人數。
  6. has-recommend 觀看建議提示:如果標註上有顯示建議提示的圖示,表示有建議要給這篇標註。請點選此圖示來開啟建議工具,觀看建議的內容吧。
  7. #標註編號:引言討論的時候可以參考用。
  8. 筆記:該篇標註的筆記。
  9. 討論列表:每個標註底下會列出頭五篇回應他的討論,您可以看到其他人對於這篇的回應。討論列表會縮排,用來跟非討論列表的標註作為區隔。
  10. 標註選單:可以進行標註列的管理。

annotation_list_fig3_1

標註選單介面之您自己的標註

annotation_list_fig3_2

標註選單介面之別人的標註

當滑鼠移至標註列表的標註上時,標註旁邊會顯示標註選單。標註選單會依照標註的狀況而有不同的功能,包括:

  1. 顯示此標註更新到距離現在的時間。
  2. 如果是您的標註,則可以進行「編輯」、「刪除」的動作。
  3. 如果是別人的標註,則可以進行「回應」的動作。
  4. 用「瀏覽討論」來開啟該標註的標註討論視窗。
標註討論視窗

annotation_view

標註討論視窗介面

當您在標註列標中要「回應」某個標註、或是點選「瀏覽討論」時,就會開啟標註討論視窗。標註討論視窗的功能包含:

  1. 錨點文字預覽:顯示該標註範圍的網頁文字,以藍色框線與藍色文字標示的位置就是這個標註所指定的範圍。
  2. 標註列表:以一個主題標註及其討論標註為主的標註列表,功能與標註工具中的標註列表相同。
  3. 編輯器顯示切換開關
  4. 標註編輯器:與標註工具中的標註編輯器相同。當您指定要回應哪篇標註時,編輯器會註明該篇標註的名字與標註編號。
建議工具

recommend_tooltip

建議工具介面

當您新增標註之後,KALS!會在適當的時機提供您標註的建議。您也可以在標註工具的標註列表中點選has-recommend 觀看建議提示,以顯示該標註的建議。建議工具的功能包括:

  1. 需要建議的位置:網頁上以綠框標示的範圍是KALS!給您需要建議的標註的位置。
  2. 推薦標註的位置:網頁上以綠色文字標示的範圍是KALS!給您的推薦標註的位置。當標註工具沒有推薦標註時,則不會顯示推薦標註的位置。
  3. 建議工具標頭:標頭有「移動」跟「關閉」功能。您可以在「移動」上拖曳標註工具,或是點選「關閉」以關閉建議工具。
  4. 需要建議的標註:這是KALS!認為您需要建議的標註。
  5. 建議:KALS!會依據您的標註資料提供建議。
  6. 推薦標註:KALS!會找尋合適的標註並推薦給您。如果您覺得不錯的話,別忘記將他加入喜愛清單喔!如果KALS!找不到合適的標註,則不會顯示推薦標註。
  7. 建議回饋:請您參考以上的建議與推薦並選擇回饋的動作,送出回饋之後,此建議就會隱藏起來。回饋分成「贊成」與「不贊成」,不贊成的情況下會保留您的標註,贊成的情況下,如果有推薦標註,則會把您的標註移動到推薦標註的位置,如果沒有建議標註,則會刪除您的標註,請您重新撰寫標註。

帳號操作步驟介紹

如何登入?

要使用KALS!撰寫標註的話,一定要先登入才行喔!

how_to_login_original

登入視窗介面

  1. 工具列上找到「登入」選項,點選開啟登入視窗。
  2. 輸入電子信箱地址(或是您的帳號)與密碼,再點選「登入」,就完成登入動作。
如何登出?

如果您要切換帳號的話,請使用登出功能。

how_to_logout

登出視窗介面

  1. 工具列上找到「登出」選項,點選開啟登出視窗。
  2. 點選「登出」,就完成登出動作。
如何修改名字?

您帳號的名字會顯示在標註上,預設是使用電子信箱地址中帳號的名字,您也可以自訂您的名字。

how_to_change_name

帳號資料視窗介面

  1. 如果您沒有登入的話,請先進行登入動作
  2. 工具列上找到「帳號資料」選項,點選開啟帳號資料視窗。
  3. 請在「名字」欄位填寫您想要設定的名字,然後按下「儲存」按鈕就完成修改名字的動作。
如何修改密碼?

how_to_change_password_fig1

帳號資料視窗中的開啟密碼變更視窗連結

how_to_change_password_fig2

密碼變更視窗介面

  1. 如果您沒有登入的話,請先進行登入動作
  2. 工具列上找到「帳號資料」選項,點選開啟帳號資料視窗。
  3. 請點選「開啟密碼變更視窗」。
  4. 請輸入您新的密碼,並再輸入第二次密碼,確認無誤之後按下「儲存」按鈕,就完成密碼變更的動作。

標註操作步驟介紹

如何選取標註範圍?

KALS!標註操作相關的所有動作,都是從選取標註範圍開始。

how_to_select

選取提示介面

  1. 選取範圍開頭: 請將滑鼠移至您要選取範圍的網頁文字上,KALS!會在該文字旁顯示「選取提示」。如果您確定要選擇此文字為範圍開頭,請點選「選取提示」。
  2. 選取範圍結尾:跟選取範圍開頭一樣的動作。您也可以點選跟開頭一樣的文字,表示您選取的只有一個字。
  3. 顯示標註工具,完成選取標註範圍的動作。

附帶一提,英文文字會依據空格斷開成為一個一個的字,標點符號也是可以選取的喔。

如何其他人的瀏覽標註?

選取標註範圍之後,便可以在標註工具標註列表中瀏覽跟此範圍重疊的標註,而標註列表下方則是會顯示其他人的標註。

當您在撰寫標註時,別忘了看一下這段範圍有誰標註過。如果您覺得別人的標註寫得很不錯,您可以把他set-is-liked 加入「喜愛清單」。下次顯示標註列表時,他的標註就會排在更上方。

KALS!只會將推薦的標註顯示在網頁文字上,而不是顯示所有人的標註。因此一般來說是不容易知道別人的標註在哪邊。這是為了避免大量標註造成使用者的混亂而作的過濾。

如何新增標註?
  1. 選取標註範圍。由於新增標註之後就不能修改範圍,請務必慎選您的標註範圍。
  2. 標註工具中的標註編輯器撰寫您的標註內容,包括選擇標註類型、撰寫筆記,完成後按下「新增」按鈕遞交。
  3. 完成標註。
  4. 如果KALS!沒有建議,則標註編輯器會切換成編輯模式,您可以調整您新增的標註內容。
  5. 如果KALS!有建議,則會顯示建議工具
如何編輯您的標註?
  1. 選取您標註的範圍
  2. 標註工具中的標註列表找到您的標註。
  3. 請將滑鼠移到該標註上,標註旁邊會顯示標註選單,請點選「編輯」功能。
  4. 標註工具的標註編輯器會切換成編輯模式,請在此編輯您的標註。
  5. 完成之後,請按下標註編輯器的「更新」按鈕,完成編輯動作。
  6. 如果您想要取消編輯,則請按下「取消」按鈕即可。

已經新增的標註範圍是無法編輯的,所以在新增標註的時候要慎選標註範圍,否則就只能刪除重寫囉。

如何刪除您的標註?
  1. 選取您標註的範圍
  2. 標註工具中的標註列表找到您的標註。
  3. 請將滑鼠移到該標註上,標註旁邊會顯示標註選單,請點選「刪除」功能。
  4. 看到您的標註消失,就完成了刪除動作。
如何回應別人的標註?
  1. 選取標註範圍
  2. 標註工具中的標註列表找到您想回應的標註。
  3. 請將滑鼠移到該標註上,標註旁邊會顯示標註選單,請點選「回應」功能,接著會開啟「標註討論視窗」。
  4. 標註討論視窗標註編輯器裡撰寫您要回應的內容。
  5. 完成之後,請按下標註編輯器的「新增」按鈕,即可完成回應動作。
標註列表上的is-liked 愛心圖示的用處是?

愛心的意思是set-is-liked 加入或set-is-not-liked 移出喜愛清單。加入喜愛清單,表示您對他的標註的認同。

您可以對別人的標註進行加入/移出喜愛清單的動作。當您將該標註加入喜愛清單之後,這個功能就會變成移出喜愛清單。

標註列表上的has-recommend 對話與筆圖示的用處是?

對話與筆的意思是has-recommend 建議提示。如果標註上有顯示建議提示的圖示,表示有建議要給這篇標註。如果您要查看給您的標註的建議,請點選此圖示來開啟建議工具並觀看建議的內容吧。

一定要贊成建議與推薦嗎?

建議與推薦只是供您參考,並不是強制性的規則,您也可以選擇不贊成,並隱藏建議。

不過,無論您是贊成或是不贊成,都請盡量選擇建議回饋的其中之一。您的建議回饋會改善KALS!的建議與推薦的方式,讓之後的建議與推薦更為準確。

建議的內容與實際情況不符合,這樣正常嗎?例如我選擇名詞來標註,KALS!卻建議我標註名詞,發生這樣的矛盾情況。

由於電腦技術無法完美地剖析中文語法,因此難以避免的是會發生誤判的情況。如果您遇到了類似的建議錯誤,請回報給系統管理者以求得改善。

如何關閉標註顯示?

如果您覺得網頁文字上的標註顯示太過雜亂,您也可以關閉標註顯示。

how_to_hide_annotation

標註顯示視窗介面

  1. 工具列上找到「標註選項」選項,點選開啟標註顯示視窗。
  2. 標註顯示中可以設定顯示您自己的標註或是KALS的推薦標註,請取消勾選您不想要顯示的標註顯示,再按下「確定」按鈕即可。

歡迎大家多多提供建議喔!

(more...)

CKEditor設定超連結的目標預設為「_blank」的方法

布丁布丁吃布丁

CKEditor設定超連結的目標預設為「_blank」的方法

image

利用CKEditor作為所見即得編輯器的討論區會遇到一種情況,允許使用者在自己文章中加入超連結,但是因為預設的超連結目標(target屬性)是自己網頁,所以當其他使用者點下超連結時就會將從討論區網頁跳到其他網站去。

為了避免這個問題,簡單的作法是修改CKEditor中超連結預設的目標選項。根據「Set link default target to _blank」討論區中的指示,主要要修改檔案中的設定即可。

  1. 找尋檔案[CKEditor存放路徑]/plugins/link/dialogs/link.js
  2. 搜尋設定:
    label:a.lang.common.target,'default':'notSet'
    並將之改成
    label:a.lang.common.target,'default':'_blank'
  3. 搜尋設定:
    label:a.lang.link.targetFrameName,'default':''
    並將之改成
    label:a.lang.link.targetFrameName,'default':'_blank'

image

由於預設的程式碼是經過壓縮的,一開始打開的時候可能會覺得程式碼都擠在一起很難閱讀,但仔細找一下還是可以找到的。

我將改完之後的檔案上傳供大家使用:link.js。請解壓縮後放置在[CKEditor存放路徑]/plugins/link/dialogs/link.js即可。來源是CKEditor 3.4.1

(more...)

CSSDOC標籤參考表

布丁布丁吃布丁

CSSDOC標籤參考表

image

繼上一篇介紹CSSDOC之後,這一篇則是更詳細地將CSSDOC推薦的32種標籤(tag)做一個翻譯整理。原本CSSDOC的標籤只有寫在草案的PDF中(SkyDrive備份),查詢起來不是很方便,所以我想寫一個方便自己查閱的網頁版。

原文草案中標籤的編排是以英文字母順序排列,但是這在使用上並不方便,我用個人的看法重新為他排列,並分成檔案註解標籤、區段註解標籤、參考資訊標籤、檢測標籤、錯誤修正與迴避標籤、其他標籤六類。希望這種編排能夠更容易使用CSSDOC的標籤。

標籤內會用到原文草案的附錄與內文,我將比較複雜的標籤值與瀏覽器翻譯整理之後附在文後的附錄中,供大家方便查閱。

凡例

標題

為了方便索引與使用,標題的格式將會包含「標籤名稱」、「簡稱」與「用法」等三種資訊。以下是其中一個例子:

@affected 影響瀏覽器:用於錯誤修正(bugfix)或隱藏錯誤(workaround)時指定目標瀏覽器與版本。
  • 標籤名稱@affected
  • 簡稱:影響瀏覽器
  • 用法:用於錯誤修正(bugfix)或隱藏錯誤(workaround)時指定目標瀏覽器與版本。

標籤敘述

標籤敘述是以標籤名稱、位置、狀態、用法、標籤值、備註、參見、範例所組成。

  • 標籤名稱:以「@」開頭與英文組合成的名稱,後面接著是我個人對他的簡稱。
  • 位置:此標籤可以使用的位置,包含檔案註解(File Comment)、區段註解(Section Comment)與標準CSS註解(Standard CSS Comment)三種。
  • 狀態:此標籤在CSSDOC中的制訂現況,可能是不穩定、即將被捨棄,或是有一些特殊的用法。
  • 用法:此標籤的適用情況與使用方法。
  • 標籤值:應該接續在此標籤後面的資料。部分標籤值有規範格式,請參見底下的附錄:標籤值列表。
  • 參見:與此標籤相關連的其他標籤。
  • 範例:此標籤的用法舉例。

標籤分類

我將CSSDOC分成六類,這並非CSSDOC制訂的類別,只是我覺得這樣方便自己查閱的分類法而已。這六類為:

  • 檔案標註標籤:有些標籤是描述整個檔案的資訊,在其他文件工具也很常見,例如「@author」(作者)、「@copyright」(版權聲明);
  • 區段標註標籤:有些是CSSDOC用來規範檔案架構的區段標籤,例如「@section」(區段名稱)、「@subsection」(子區段名稱);
  • 參考資訊標籤:有些是註明參考資訊的標籤,例如「@see」(參見)、「@since」(參見版本);
  • 檢測標籤:有些是標示檢測狀況的標籤,例如「@tested」(通過測試)、「@valid」(有效);
  • 錯誤修正、迴避標籤:有些是CSS語法特有的相容性、錯誤修正、替代方案說明,例如「@bugfix」(錯誤修正)、「@css-for」(這段CSS語法是為了目標瀏覽器而寫);
  • 其他標籤:有些是為了CSSDOC分析器而設計,例如「@cssdoc」(CSSDOC版本、分析器控制)。

檔案註解標籤

@author 作者:顯示作者的名字。
標籤名稱 @author 作者
位置 檔案註解
用法 顯示作者的名字。
標籤值 標明這個CSS檔案的作者。通常會附上email電子郵件位址。在多作者的情況則使用多個@author標籤,一個標籤註明一個作者。
備註 為了防止廣告機器人(spambot)分析CSS檔案找尋電子郵件地址,在公開CSS檔案的時候要考慮移除作者的電子郵件地址。
範例
/**
 * 我的CSS檔案
 *
 * @author  Mina Margin <mm@example.com>
 * @version 1
 */
@creator CSS建立工具:生產應用程式或工具可以利用此標籤留下記錄。
標籤名稱 @creator 建立工具
位置 檔案註解
用法 CSS生產應用程式或工具可以利用此標籤留下記錄。
標籤值 應用程式或工具的名稱
參見 @author
範例
/**
 * [...]
 * @creator  HTML Plus 2 Reflexive CSS (WIN 3.1)
 * [...]
 */
@copyright  檔案的版權資訊。
標籤名稱 @copyright 版權資訊
位置 檔案註解
用法 檔案的版權資訊。
標籤值 版權字串。
範例
/**
 * [...]
 * @copyright Copyright(c) 1992, 2006-2007
 *            by My Little Big Corp Inc.
 * [...]
 */
@licence 授權條款:指定CSS檔案發佈時遵守的授權條款。
標籤名稱 @license 授權條款
位置 檔案註解
用法 指定CSS檔案發佈時遵守的授權條款。
標籤值 為了確保該授權條款可辨識,通常是包含人類可以閱讀的敘述以及URL網址。
範例
/**
 * [...]
 * @license Create Commons Attribution 2.0 License
 *          http://creativecommons.org/licenses/by2.0/
 * [...]
 */
@link 參考連結:檔案參考來源的超連結。
標籤名稱 @link 參考連結
位置 檔案註解
用法 檔案參考來源的超連結。例如:如果這是某個主題的一部分,那麼可以填入該主題的網站網址。
標籤值 為了確保該授權條款可辨識,通常是包含人類可以閱讀的敘述以及URL網址。
範例
/**
 * [...]
 * @license Create Commons Attribution 2.0 License
 *          http://creativecommons.org/licenses/by/2.0/
 * [...]
 */
@date 建立日期:註明文件建立日期。
標籤名稱 @date 建立日期
位置 檔案註解
用法 註明文件建立日期。
標籤值 日期(標籤值)
參見 CSSDOC文件中的2.3.6 Parser and Control Tags章節
範例1
/**
 * [...]
 * @cssdoc version 1.0-pre
 * [...]
 */
範例2
/* @cssdoc parsing off */

[...]

/* @cssdoc parsing on */
@lastmodified 最後修改:註明最後修改的時間。
標籤名稱 @lastmodified 最後修改
位置 檔案註解
用法 註明最後修改的時間。
標籤值 最後修改的時間戳記(標籤值)
參見 @date
範例
/**
 * [...]
 * @lastmodified 2007-07-24 12:34
 * [...]
 */
@package 套裝名稱:關聯一個或多個檔案到同一個套裝程式中。
標籤名稱 @package 套裝名稱
位置 檔案註解
用法 關聯一個或多個檔案到同一個套裝程式中。
標籤值 套裝程式名稱
參見 @version@subpackage
範例
/**
 * [...]
 * @package    xhtml-css
 * @subpackage css
 * [...]
 */
@subpackage 子套裝名稱:分類套裝程式用。
標籤名稱 @subpackage 子套裝名稱
位置 檔案註解
用法 分類套裝程式用。
標籤值 子套裝程式名稱
參見 @package
範例
/**
 * [...]
 * @package    xhtml-css
 * @subpackage css
 * [...]
 */
@style 樣式:這個樣式的命名,或是這個樣式檔案所屬類別。
標籤名稱 @style 樣式
位置 檔案註解
用法 這個樣式的命名,或是這個樣式檔案所屬類別。
標籤值 文字(標籤值)
參見 @project
範例
/**
 * [...]
 * @style     couleurs de l'été
 * [...]
 */
@version 版本:標示檔案版本。
標籤名稱 @version 版本
位置 檔案註解
用法 標示檔案版本。
標籤值 版本號碼
參見 @revision
範例
/**
 * [...]
 * @version   1.2
 * [...]
 */
@revision 修訂次數:註明檔案的修訂次數。
標籤名稱 @revision 修訂次數
位置 檔案註解
用法 註明檔案的修訂次數。用於SVN或類似的原始碼管理系統。
狀態 這是不穩定的標籤,也許會列入廢棄標籤。由於@version標籤已經可以相容此功能,而@revision在標準的版本控制系統中沒有用處。
標籤值 修訂次數
參見 @version
範例
/**
 * [...]
 * @version  0.2.8
 * @revision 193
 * [...]
 */
@site 網站名稱:這個CSS檔案套用的網站名稱。
標籤名稱 @site 網站名稱
位置 檔案註解
用法 這個CSS檔案套用的網站名稱。
標籤值 文字(標籤值)
參見 @project@link@package
備註 @package可能也會是選項之一。
範例
/**
 * couleurs de l'été
 *
 * MyWebsite Style for Summer 2008
 *
 * @site     mywebsite
 * [...]
 */
@media 套用載體:敘述該檔案套用的目標載體類型。
標籤名稱 @media 套用載體
位置 檔案註解
用法 敘述該檔案套用的目標載體類型。例如print、screen。詳細的
標籤值 CSS載體敘述,例如print、screen。請參考W3C的Media types說明
備註 跟CSS選取器是同樣的文字。
範例
/**
 * [...]
 * @license Create Commons Attribution 2.0 License
 *          http://creativecommons.org/licenses/by2.0/
 * [...]
 */
@colordef 定義顏色。
標籤名稱 @colordef 顏色定義
位置 檔案註解
用法 定義顏色。
標籤值 顏色定義字串包含了標準的CSS顏色值、作者自訂的顏色名稱。如果有使用的話,可以在最後用括號註明該顏色的用處。
其他資訊 @colordef標籤是讓CSS作者能夠有系統地定義使用的顏色。如果確實使用@colordef,就能利用程式或工具快速地確認顏色並且方便地變換整體色調(Palette)。
參見 @affected@css-for@workaround
範例1
/**
[...]
 *
 * @colordef #7b633a; Bronze (Border)
 * @colordef rgb(24,56,68); Dark Satin (Lter Shadow)
 * @colordef rgb(12,47,56); Darker Satin (Shadow)
 * @colordef red; Red
 */
範例2
/**
[...]
 * @colordef rgb(45,71,108);   Camou d'accord (activeBackground)
 * @colordef rgb(142,155,161); Rhyme Dump Down (activeBlend)
 * @colordef rgb(251,251,231); Sellout Gay Gray (activeForeground)
 * @colordef rgb(142,155,161); Less Red* (activeTitleBtnBg)
 * @colordef rgb(242,242,223); Snowflash (alternateBackground)
 * @colordef rgb(240,240,214); Pay for Grey (background)
 * @colordef rgb(230,230,205); Silver Snow Boots (buttonBackground)
 * @colordef rgb(0,0,0);       Black (buttonForeground)
 * @colordef rgb(0,0,0);       Black (foreground)
 * @colordef rgb(157,168,169); Tripple Sec Dry Grey (frame)
 * @colordef rgb(157,168,169); Tripple Sec Dry Grey (handle)
 * @colordef rgb(95,114,135); Minor Mist (inactiveBackground)
 * @note     glad-beige-colors
 * @see      http://www.kde-look.org/content/show.php?content=75982
 */
@forntdef 定義字型。
標籤名稱 @fontdef 字型定義
位置 檔案註解
用法 定義字型。
標籤值 字型定義(標籤值)。但是CSSDOC草案中這部份還尚未確定。
參見 @colordef
範例
/**
 * [...]
 * @fontdef freesans, arial, sans-serif, sans;
 *          serifenlose classique (headlines)
 * [...]
 */

區段註解標籤

@section 區段名稱:開啟一個新的區段並命名。
標籤名稱 @section 區段名稱
位置 區段註解
用法 開啟一個新的區段並命名。
標籤值 區段名稱
參見 @subsection@see
範例
/**
 * 重置區塊
 *
 * 重置到預設狀況。
 * 
 * @section reset
 * @see     YUI Reset CSS,
 *          http://developer.yahoo.com/yui/reset/
 */
@subsection 子區段名稱:增加CSS檔案的結構。
標籤名稱 @subsection 子區段名稱
位置 區段註解
用法 增加CSS檔案的結構。
標籤值 子區段名稱

參見 @section@subsubsection
範例
/**
 * [...]
 * @section    reset
 * [...]
 */
[...]
/**
 * [...]
 * @subsection forms
 * [...]
 */
@subsubsection 次子區段名稱:增加CSS檔案的結構。
標籤名稱 @subsection 次子區段名稱
位置 區段註解
用法 增加CSS檔案的結構。
標籤值 次子區段名稱
參見 @section@subsection
範例
/**
 * [...]
 * @subsection    forms
 * [...]
 */
[...]
/**
 * [...]
 * @subsubsection labels
 * [...]
 */

參考資訊標籤

@see 參見:檔案或區塊的參考資訊。
標籤名稱 @see 參見
位置 檔案註解、區段註解
用法 檔案或區塊的參考資訊。
標籤值 文字、URL
參見 @section@link
範例
/**
 * 重置區塊
 *
 * 重置到預設狀況。
 * 
 * @section reset
 * @see     YUI Reset CSS,
 *          http://developer.yahoo.com/yui/reset/
 */
@since 參見版本:標註參考來源或檔案的版本。
標籤名稱 @since 來原本本
位置 檔案註解、區段註解
用法 標註參考來源或檔案的版本。
標籤值 版本數字
參見 @version
範例
/**
 * 重置
 *
 * 重置到本身的預設狀態。
 * 
 * @section reset
 * @see     YUI Reset CSS,
 *          http://developer.yahoo.com/yui/reset/
 * @since   0.2.8
 */
@since-revision 參見修訂次數:標註參考來源或檔案的修訂次數。
標籤名稱 @since-revision 參見修訂次數
位置 檔案註解、區段註解
用法 標註參考來源或檔案的修訂次數。
標籤值 修訂次數
參見 @since@revision
範例
/**
 * [...]
 * @since          0.2.8
 * @since-revision 193
 */

檢測標籤

@tested 通過測試:標註該檔案或該區段已經通過測試的瀏覽器。
標籤名稱 @tested 通過測試
位置 檔案註解、區段註解
用法 標註該檔案或該區段已經通過測試的瀏覽器。
標籤值 通過測試的瀏覽器列表
備註 如果有需要排序的話,可以使用多個@tested標籤,每個標籤使用一種使用者代理(user agent)。另一個方法也可以使用逗點分隔「,」,或是同時使用。
範例
/**
 * 我的CSS隱藏錯誤測試系列
 * 
 * @workaround 邊框顯示錯誤
 * @affected   opera3-6.1 win
 * @tested     ie4, ie5, ie6, ie7
 * @tested     opera3-6.1 win
 * @tested     moz7
 */
@valid [F][S] 有效驗證:標示CSS語法是否有效。
標籤名稱 @valid 有效驗證
位置 檔案註解、區段註解
用法 標示CSS語法是否有效。
標籤值 布林值(標籤值)
備註 如果有段落或是已知錯誤修正會讓CSS語法無法生效,這就可以標示@valid標籤。注意這並不會影響分析器的開關切換。
範例
/**
 * [...]
 * @valid   false
 * [...]
 */

錯誤修正、迴避標籤

@bugfix 錯誤修正:標示這段CSS語法是一個錯誤修正。
標籤名稱 @bugfix 錯誤修正
位置 檔案註解、區段註解 、標準CSS註解
用法 標示這段CSS語法是一個錯誤修正。
標籤值 無。
備註 錯誤修正是利用CSS去修正(而非迴避)特定瀏覽器在顯示或是編譯時會出現的錯誤。
參見 @affected@css-for@workaround
範例1
/**
 * 重複文繞圖外欄(Float-Margin)的錯誤
 *
 * @see  http://...
 *
 * @bugfix
 * @affected   ie5 win, ie6
 * @css-for    all browsers
 * @valid      yes
 */
範例2
/**
 * 避免在#col3在列印時會發生換頁(page break)情況。
 *
 * @bugfix
 * @affected  ie7
 * @css-for   ie5.x win, ie6, ie7
 * @valid     yes
 */
#col3 { height: 1% }
@workaround 隱藏錯誤:標示這是一個隱藏錯誤。
標籤名稱 @workaround 隱藏錯誤
位置 檔案註解、區段註解
用法 標示這是一個隱藏錯誤。隱藏錯誤並不是錯誤修補,只是迴避錯誤發生的一個折衷方案。請看Wikipedia的解釋
標籤值 沒有資料,或是對於這個錯誤的簡單敘述。
備註 隱藏錯誤(workaround)是一種CSS用法,用來迴避(而不是修正、或甚至是無法修正)某些瀏覽器顯示或是編譯的錯誤。
參見 @bugfix
範例
/**
 * 3像素突出錯誤
 * 
 * @workaround 3像素突出錯誤
 * @affected   ie5.x, ie6
 * @css-for    ie5.x, ie6
 */
@affected 影響瀏覽器:用於錯誤修正(bugfix)或隱藏錯誤(workaround)時指定目標瀏覽器與版本。
標籤名稱 @affected 影響瀏覽器
位置 檔案註解、區段註解
用法 用於錯誤修正(bugfix)或隱藏錯誤(workaround)時指定目標瀏覽器與版本。
標籤值 瀏覽器以及版本,或是使用者代理(useragent)的群組。關於使用者代理的介紹,可以參考UserAgent的历史变迁這篇。
備註 應該只能跟@bugfix或@workaround一起使用。
參見 @bugfix@workaround附件:瀏覽器列表
範例1
/**
 * 我的CSS隱藏錯誤
 *
 * @workaround 修正錯誤的框線顯示
 * @affected   opera3-6.1 win
 */
範例2
/**
 * 避免在#col3在列印時會發生換頁(page break)情況。
 *
 * @bugfix
 * @affected  ie7
 * @css-for   ie5.x win, ie6, ie7
 * @valid     yes
 */
#col3 { height: 1% }
@css-for 套用瀏覽器:註明此段CSS語法是為了目標瀏覽器而撰寫。
標籤名稱 @css-for 套用瀏覽器

位置 檔案註解、區段註解

用法 註明此段CSS語法是為了目標瀏覽器而撰寫。

標籤值 要修正的瀏覽器名稱。

參見 @bugfix@workaround附錄:瀏覽器列表

範例
/**
 * [...]
 * @css-for IE 6 Win32.
 * [...]
 */

其他標籤

@cssdoc 控制與告知CSSDOC分析器。
標籤名稱 @cssdoc

位置 檔案註解、區段註解

用法 控制與告知CSSDOC分析器。

標籤值 CSSDOC指令(標籤值)

參見 CSSDOC文件中的2.3.6 Parser and Control Tags章節

範例1
/**
 * [...]
 * @cssdoc version 1.0-pre
 * [...]
 */
範例2
/* @cssdoc parsing off */

[...]

/* @cssdoc parsing on */
@note 筆記
標籤名稱 @note 筆記
位置 檔案註解、區段註解
用法 留下筆記。
標籤值 文字(標籤值)
參見 @todo
範例
/**
 * [...]
 * @note this is not for production use.
 * [...]
 */
@todo 待辦事項:建立待辦事項列表。
標籤名稱 @todo 待辦事項
位置 檔案註解、區段註解
用法 建立待辦事項列表。
標籤值 文字(標籤值)
備註 有些軟體可以利用todo標籤以及標籤值來建立檔案或專案的待辦事項列表。
範例
/**
 * [...]
 * @todo   修正嵌套表單(nested list)的游標停留(hover)問題
 * [...]
 */
@group 暫定標籤
標籤名稱 @group
位置 檔案註解、區段註解、標準CSS註解
狀態 暫定標籤;第三方標籤,用於CSSEdit
備註 到目前為止這個標籤並沒有明確的用法,這是來自於相關廠商的建議。

附錄

標籤值列表
  • 文字 (Text):簡單的文字,可能會橫跨多行。
  • 布林值 (Yes/No):一種很基本的資料型態,CSS支援布林語句或是yes/no,它可以是「0」或「1」、「yes」或「no」、「true」或「false」。
  • 日期 (Date):有些標籤需要指定日期值,撰寫日期的格式應該參考ISO 8601。如果日期太大或是跨國的計畫,則推薦使用世界標準時間(Coordinated Universal Time,簡稱UTC)
  • 時間戳記 (Timestamp):CSSDOC草案尚未確定。
  • 參考來源 (Reference):CSSDOC草案尚未確定。
  • CSSDOC指令 (CSSDOC command):CSSDOC指令是從既定指令中選擇一個。有些指令擁有自己的參數與語法。以下是CSSDOC的指令:
    • parsing on
    • parsing off
    • version

  • 區段名稱:CSSDOC草案尚未確定。
瀏覽器列表

CSS的作者也許不知道該如何為瀏覽器統一命名,CSSDOC也在處理瀏覽器的表示法。現在市面上盛行著許多不同的網頁瀏覽器,不可能用一種表示法來統一制定。以下是CSSDOC建議的部分瀏覽器表示法,但這並不是強制規則,僅作為參考而已。

表示法 瀏覽器 版本 作業系統
Fx 2 nix Firefox 2 Linux/Unix
  Icab    
Ie 6 win Internet Explorer 6 Windows
Ie 3.2 os9 Internet Explorer 3.2 Apple OS9
  Konqueror    
lynx Lynx 所有版本 所有平台
Moz 1 osx Mozilla 1 Apple OSX
  Netscape    
Opera 6.5 win Opera 6.5 Windows
  Safari    
(more...)