您在這裡

網站的 CSS 似乎改過了,手冊變清楚了!!

ddtet's 的頭像
ddtet 在 2007-05-08 (二) 13:41 發表

一大早習慣性的連進 Druapl Taiwan,結果得到 403 錯誤訊息,一度以為發生什麼事情。
後來忙其它的事情,就忘了這件事。中午吃完東西回到公司,上網發現我po的手冊標題變了。趕進去看看,發現 jimmy 幫忙作了一些修改。
而整個版面也變得清析,更容易閱讀。看來是CSS樣版有修改過,標題2變成粗體,且加上底線。
本來我還一直在想要怎麼讓文章更好閱讀一些(允許的標籤中,沒有 b 粗體這項)。

再次謝謝 jimmy 的修改標題和內容,讓它變得更清楚。個人所知的"專用名詞"不夠多,所以常常會詞窮想不到好標題。
也感謝修改CSS的人... 應該是站長吧!! (本來還以為是有特殊的標籤用法,特別跑到編輯畫面去找... XD )

另外要請教大家的意見,標題中,函數名稱的後面要不要加上簡單的功能說明??
有時候說明太長會讓人覺得很亂,但是有了說明,對於想找某功能函數的人來說,是一個很有用的幫助,不用一個一個函數去看。

在 jimmy 把 drupal_get_path 的"尾巴"去掉,看起來清爽後,讓我對於要不要放說明,想請教一下大家的看法...

Table of Content 又跑出來了,對於內文的 h2, h3(好像也可以) ,會列在文章的開頭,以便於瀏覽。
http://drupaltaiwan.org/forum/20061125/583

你講的說明不是在「描述」中就有嗎?已經足以瞭解該函數是做什麼用的。
或許大家有機會去用到這些函數時,回應的文章也會愈來愈多,實例也會增加。

呵呵,不是跑出來的
是花了1hr寫的~
用jquery的plug-in改的,還有很多問題
在ie上面仍有javascript的錯誤
/************************************************
* 你的回饋,讓Drupal越來越茁壯 * Drupal社群越茁壯,你就越有力量 *
************************************************/

--
from open mind to open source~

原來是有工具可以作到... 剛看到這樣的改變覺得滿"神奇"的... (網站看得不夠多... XD)

我的重點是指「在點入文章之前」所看到的東西。
就像是一本書目錄,當然只有主標題,讓人去翻到那個章節,還是可以知道這一章是講些什麼。
但是如果有一個次標題,在看這個章節之前,就可以大概知道這章在講什麼,是不是我想看的東西。如果不是,則跳過去找其它項目。
多少是可以淢少爬文的時間,不過會讓每一個函數的標題變長。主要的用途是讓人「快速瀏覽」,這就不是搜尋功能能完成取代的東西。
當然現在的函數很少,等到二, 三十個函數列在一起的時候,也許才看得出它的價值。

因為各有優缺點... 所以想聽聽別人的意見。
主要是不想之後去修改一大堆文章,雖然這種事情在之後應該會遇到,像是增加函數之間的連結。(a函數的範例用到b函數,就作一個到b函數的連結)
不過還是本著儘量一次就作到好,事後少改變的原則,多問幾次意見。

另外關於範例,我反而希望是利用共筆功能加進去,因為函數最後常常會跟上長長的程式碼。像我這種人沒必要不會去讀完它(因為看完不見得能搞懂...)。
所以放在回應裡反而會讓「沒拉到最下頭」的人看不到,有點可惜。

我只是一個撰碼員,靠寫程式過活。
自從 Drupal 在 4.7 版的時候知道他的存在,但是後來跳去其它程式語言很久沒回來。
變成 D5 比較熟,D6 知道一點,D7 還在學的狀況…

我個人認為,把標題名稱改短有很多好處,如果是全英文,會更好
因為可以用pathauto把函數裡的標題,都變成直接的網址
這樣以來,對於要直接進入頁面的人很方便

另一部份,book的block列出來時標題過長會很可怕,很容易找不到想要的東西
對於「查尋」的實用性,會打折扣
當然,這方面api.drupal.org已經做到了
看得懂英文的人也沒必要來這兒查詢啦

/************************************************
* 你的回饋,讓Drupal越來越茁壯 * Drupal社群越茁壯,你就越有力量 *
************************************************/

--
from open mind to open source~

感謝 jimmy 幫忙修改顯示的樣子。
我的確少考慮到 book 的 block 寬度有限的問題。那我在之後的文章就不在標題裡放入說明。

昨天太累... 沒有加新的文章... (騎車騎到眼睛快要閉起來了... = =)

另外問一下... 像是沒有開頭的函數... 如: t(), l()
它們的"章節"是不是叫「foo」就好??

我只是一個撰碼員,靠寫程式過活。
自從 Drupal 在 4.7 版的時候知道他的存在,但是後來跳去其它程式語言很久沒回來。
變成 D5 比較熟,D6 知道一點,D7 還在學的狀況…

這真是一個好問題啊...或許直接放在函數下面就好,不需要子分類吧
畢竟drupal會這樣子用的,大概只有幾個,你覺得呢?

函數庫 => drupal_foo
函數庫 => t
函數庫 => l
函數庫 => url

/************************************************
* 你的回饋,讓Drupal越來越茁壯 * Drupal社群越茁壯,你就越有力量 *
************************************************/

--
from open mind to open source~

只有幾個而已嗎?? 那列在外頭的確是一個可行的方案。
看來我在po這些函數的時候得在上面"加點重量"(weight),免得單一文章和"目錄"混在一起,造成閱讀的困難。

因為我是一面作目前模組開發的測試,一面去找會用到的函數,所以增加文章的方式會東一個西一個......
缺點當然是作者本身(也就是我)沒辦法看到函數的全貌,像是不知道這種函數的數量是不是很多。
優點可能是列出來的函數,如果有需要放入範例的話,手邊就有現成的例子可以用,因為我不得不先測試過才敢拿來用。

我只是一個撰碼員,靠寫程式過活。
自從 Drupal 在 4.7 版的時候知道他的存在,但是後來跳去其它程式語言很久沒回來。
變成 D5 比較熟,D6 知道一點,D7 還在學的狀況…

似乎是個好建議~ :P
我覺得主要的function,可以分幾個重點
1. drupal_foo,因為這個太常用到了,我看了一下,在bootstrap、common、path.inc、unicode裡頭較多
2. db_foo,database也更常用到,這個部份其實比第一部份重要
3. 常用的,如 l(), t(), variable_get ... 等等
4. form的API
5. module裡的,就可以考慮一下需不需要做手冊了,我個人覺得變化太大~弄手冊很容易失效

若有什麼使用心得,也可以在回應裡寫出來~

--
from open mind to open source~

就函數文章的部分,我覺得目前的格式就差不多了。只要範例的內容夠清楚,那這個函數庫就很有價值。
真的說要再加什麼東西補強的話,我覺得如果能加上插圖就更好。
如 joetsuihk 剛發表的 druapl_set_message,如果在例子中再有圖片會更讓人能夠了解,不然光是「綠色框」、「紅色框」,不容易直覺連想到那是什麼。
(我還沒試過能不能加圖... 當然加了圖片之後的排版問題我也還沒想過...)

至於標題的話... 我覺得「其它」改成「Others」... 全都英文可能看起來比較順眼... (other 也不是一個很難的單字)

其它部分的規劃,真的得交給其它人了。我真的還沒摸到那個地方。(正所謂有心無力啊~~~ )
form API 的部分的確滿複雜的,在原文站上看了文章,還是覺得有些地方不太清楚。
怎麼也感覺不出_validate和_submit的差異在哪,除了執行的先後順序之外,沒發現其它的不同。
另外稍早才找了好久原文站的文件,就是沒法弄懂 bootstrap 是啥碗糕.... (資料庫所有模組的 bootstrap 欄位全是 0, 沒得猜... = =a)

希望有人可以主持一下關於"基礎知識"的文件發表。
少了一些觀念,變成有些函數只能看懂其中的一部分功能,不懂得去改看不懂的參數去作其它變化。所以遇到有些函數就是缺了幾個參數看不懂,不知道要怎麼翻... = =a

form API 和模組觀念又是另一種模式了... 寫出來的東西應該會比函數庫來得複雜的多。
也許該另開個討論主題來談它吧!!

我只是一個撰碼員,靠寫程式過活。
自從 Drupal 在 4.7 版的時候知道他的存在,但是後來跳去其它程式語言很久沒回來。
變成 D5 比較熟,D6 知道一點,D7 還在學的狀況…

另外,我把行數都刪掉了
因為行數太容易變動,通常會是由系統自動產生的
/************************************************
* 你的回饋,讓Drupal越來越茁壯 * Drupal社群越茁壯,你就越有力量 *
************************************************/

--
from open mind to open source~

突然想到... charlesc 不是在寫一本關於 Drupal 的書嗎??
如果有需要,加上所有發表者的同意,應該是可以把函數庫的內容放到書裡面。(我個人是沒意見,也許可以幫 charlesc 多賺到頁數 & 槁費)

所以,我覺得 charlesc 也可以就放到書裡面去的角度,來對目前的函數庫文件格式提供一點意見。

我只是一個撰碼員,靠寫程式過活。
自從 Drupal 在 4.7 版的時候知道他的存在,但是後來跳去其它程式語言很久沒回來。
變成 D5 比較熟,D6 知道一點,D7 還在學的狀況…