一大早習慣性的連進 Druapl Taiwan，結果得到 403 錯誤訊息，一度以為發生什麼事情。
後來忙其它的事情，就忘了這件事。中午吃完東西回到公司，上網發現我po的手冊標題變了。趕進去看看，發現 jimmy 幫忙作了一些修改。
而整個版面也變得清析，更容易閱讀。看來是CSS樣版有修改過，標題2變成粗體，且加上底線。
本來我還一直在想要怎麼讓文章更好閱讀一些(允許的標籤中，沒有 b 粗體這項)。
再次謝謝 jimmy 的修改標題和內容，讓它變得更清楚。個人所知的"專用名詞"不夠多，所以常常會詞窮想不到好標題。
也感謝修改CSS的人... 應該是站長吧!! (本來還以為是有特殊的標籤用法，特別跑到編輯畫面去找... XD )
另外要請教大家的意見，標題中，函數名稱的後面要不要加上簡單的功能說明??
有時候說明太長會讓人覺得很亂，但是有了說明，對於想找某功能函數的人來說，是一個很有用的幫助，不用一個一個函數去看。
在 jimmy 把 drupal_get_path 的"尾巴"去掉，看起來清爽後，讓我對於要不要放說明，想請教一下大家的看法...
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
Table of Content 又跑出來了，對於內文的 h2, h3(好像也可以) ，會列在文章的開頭，以便於瀏覽。
http://drupaltaiwan.org/forum/20061125/583
你講的說明不是在「描述」中就有嗎？已經足以瞭解該函數是做什麼用的。
或許大家有機會去用到這些函數時，回應的文章也會愈來愈多，實例也會增加。
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
呵呵，不是跑出來的
是花了1hr寫的～
用jquery的plug-in改的，還有很多問題
在ie上面仍有javascript的錯誤
/************************************************
* 你的回饋，讓Drupal越來越茁壯 * Drupal社群越茁壯，你就越有力量 *
************************************************/
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
是這個error嗎？
An HTTP error 404 occured.
/activemenu/book
如果是這個bug的話我也遇過,在mac下面也是一樣會遇到
查了一下issue發現是跟devel衝,可以找patch檔解決
但我之前用的patch沒辦法完全patch,但patch後卻可以,實在很奇怪
你可以試試看
http://drupal.org/node/131320
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
原來是有工具可以作到... 剛看到這樣的改變覺得滿"神奇"的... (網站看得不夠多... XD)
我的重點是指「在點入文章之前」所看到的東西。
就像是一本書目錄，當然只有主標題，讓人去翻到那個章節，還是可以知道這一章是講些什麼。
但是如果有一個次標題，在看這個章節之前，就可以大概知道這章在講什麼，是不是我想看的東西。如果不是，則跳過去找其它項目。
多少是可以淢少爬文的時間，不過會讓每一個函數的標題變長。主要的用途是讓人「快速瀏覽」，這就不是搜尋功能能完成取代的東西。
當然現在的函數很少，等到二, 三十個函數列在一起的時候，也許才看得出它的價值。
因為各有優缺點... 所以想聽聽別人的意見。
主要是不想之後去修改一大堆文章，雖然這種事情在之後應該會遇到，像是增加函數之間的連結。(a函數的範例用到b函數，就作一個到b函數的連結)
不過還是本著儘量一次就作到好，事後少改變的原則，多問幾次意見。
另外關於範例，我反而希望是利用共筆功能加進去，因為函數最後常常會跟上長長的程式碼。像我這種人沒必要不會去讀完它(因為看完不見得能搞懂...)。
所以放在回應裡反而會讓「沒拉到最下頭」的人看不到，有點可惜。
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
我個人認為，把標題名稱改短有很多好處，如果是全英文，會更好
因為可以用pathauto把函數裡的標題，都變成直接的網址
這樣以來，對於要直接進入頁面的人很方便
另一部份，book的block列出來時標題過長會很可怕，很容易找不到想要的東西
對於「查尋」的實用性，會打折扣
當然，這方面api.drupal.org已經做到了
看得懂英文的人也沒必要來這兒查詢啦
/************************************************
* 你的回饋，讓Drupal越來越茁壯 * Drupal社群越茁壯，你就越有力量 *
************************************************/
Re:
感謝 jimmy 幫忙修改顯示的樣子。
我的確少考慮到 book 的 block 寬度有限的問題。那我在之後的文章就不在標題裡放入說明。
昨天太累... 沒有加新的文章... (騎車騎到眼睛快要閉起來了... = =)
另外問一下... 像是沒有開頭的函數... 如： t(), l()
它們的"章節"是不是叫「foo」就好??
Re:
這真是一個好問題啊...或許直接放在函數下面就好，不需要子分類吧
畢竟drupal會這樣子用的，大概只有幾個，你覺得呢？
函數庫 => drupal_foo
函數庫 => t
函數庫 => l
函數庫 => url
/************************************************
* 你的回饋，讓Drupal越來越茁壯 * Drupal社群越茁壯，你就越有力量 *
************************************************/
Re:
只有幾個而已嗎?? 那列在外頭的確是一個可行的方案。
看來我在po這些函數的時候得在上面"加點重量"(weight)，免得單一文章和"目錄"混在一起，造成閱讀的困難。
因為我是一面作目前模組開發的測試，一面去找會用到的函數，所以增加文章的方式會東一個西一個......
缺點當然是作者本身(也就是我)沒辦法看到函數的全貌，像是不知道這種函數的數量是不是很多。
優點可能是列出來的函數，如果有需要放入範例的話，手邊就有現成的例子可以用，因為我不得不先測試過才敢拿來用。
Re:
還有variable_set variable_get variable delete
其實還不少的
分一個類好一點
"其他"如何?
Joetsui's blog
Re:
似乎是個好建議～ :P
我覺得主要的function，可以分幾個重點
1. drupal_foo，因為這個太常用到了，我看了一下，在bootstrap、common、path.inc、unicode裡頭較多
2. db_foo，database也更常用到，這個部份其實比第一部份重要
3. 常用的，如 l(), t(), variable_get ... 等等
4. form的API
5. module裡的，就可以考慮一下需不需要做手冊了，我個人覺得變化太大～弄手冊很容易失效
若有什麼使用心得，也可以在回應裡寫出來～
Re:
同意
module 應該用比較概念上的文章說明
附簡單的例子（如官網，我覺做得不錯）
但個人覺得form API 比 db_foo 重要很多很多
也複雜很多（概念上）
我還是先待納格髄約定下一個格式
穩定才寫文吧
Joetsui's blog
Re:
就函數文章的部分，我覺得目前的格式就差不多了。只要範例的內容夠清楚，那這個函數庫就很有價值。
真的說要再加什麼東西補強的話，我覺得如果能加上插圖就更好。
如 joetsuihk 剛發表的 druapl_set_message，如果在例子中再有圖片會更讓人能夠了解，不然光是「綠色框」、「紅色框」，不容易直覺連想到那是什麼。
(我還沒試過能不能加圖... 當然加了圖片之後的排版問題我也還沒想過...)
至於標題的話... 我覺得「其它」改成「Others」... 全都英文可能看起來比較順眼... (other 也不是一個很難的單字)
其它部分的規劃，真的得交給其它人了。我真的還沒摸到那個地方。(正所謂有心無力啊~~~ )
form API 的部分的確滿複雜的，在原文站上看了文章，還是覺得有些地方不太清楚。
怎麼也感覺不出_validate和_submit的差異在哪，除了執行的先後順序之外，沒發現其它的不同。
另外稍早才找了好久原文站的文件，就是沒法弄懂 bootstrap 是啥碗糕.... (資料庫所有模組的 bootstrap 欄位全是 0, 沒得猜... = =a)
希望有人可以主持一下關於"基礎知識"的文件發表。
少了一些觀念，變成有些函數只能看懂其中的一部分功能，不懂得去改看不懂的參數去作其它變化。所以遇到有些函數就是缺了幾個參數看不懂，不知道要怎麼翻... = =a
form API 和模組觀念又是另一種模式了... 寫出來的東西應該會比函數庫來得複雜的多。
也許該另開個討論主題來談它吧!!
Re:
另外，我把行數都刪掉了
因為行數太容易變動，通常會是由系統自動產生的
/************************************************
* 你的回饋，讓Drupal越來越茁壯 * Drupal社群越茁壯，你就越有力量 *
************************************************/
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
突然想到... charlesc 不是在寫一本關於 Drupal 的書嗎??
如果有需要，加上所有發表者的同意，應該是可以把函數庫的內容放到書裡面。(我個人是沒意見，也許可以幫 charlesc 多賺到頁數 & 槁費)
所以，我覺得 charlesc 也可以就放到書裡面去的角度，來對目前的函數庫文件格式提供一點意見。
Re: 網站的 CSS 似乎改過了，手冊變清楚了!!
嗯，我這書比較簡單，不會用到模組開發。
以後有機會換人來寫 :)