文章總列表

dokuwiki vol.2

先說一下怎麼在Windows平台架設dokuwiki
其實還真的滿簡單的 (笑)

首先到抓xampp來裝, 這個package包括apache & php
http://www.apachefriends.org/zh_tw/xampp.html

然後再到dokuwiki的官網抓原始檔
https://www.dokuwiki.org/dokuwiki

把dokuwiki解壓縮到 xampp/ htdocs/ wiki/ 裡面
第一次使用要先連 http://localhost/wiki/install.php, 設定一些必要的東西
試著開瀏覽器,  http://localhost/wiki/ 連看看
然後就可以移除install.php, 開始在自己電腦上使用WIKI

另外, 一般我會建議修改PHP的設定, 把上傳檔案大小限制調大
xampp目前的上下傳限制是2MB, 這可以在 PHP.ini 裡設定


----


我們目前使用的方式, 在這裡介紹一下

dokuwiki支援用"冒號"來分隔主題, 有點像是目錄的概念, 例如

    user1:schedule:2012_01

表示某個user1, 他裡面再開一個schedule的分類, 最後裡面再一頁2012_01
我們鼓勵每個user開自己的分頁, 格式不拘, 可以把WIKI當筆記本使用

    user2:topicA:implement_note

也可以開一個類似這樣的頁面, 把開發過程中, 相關的資訊整理在裡面
這樣一來, 文件就會以incremental的方式慢慢長出來
日後如果要交接, 或是回答問題, 這樣一個頁面就可以直接拿來用


----


如果是給團隊使用, 可以依照主題, 開立不同的頁面

    topicA:resource    給大家放網路上找到的資源
    topicA:discussion    討論頁, 如果有什麼問題可以放上去

WIKI強大的地方是, 可以很多人一起編輯某個頁面, 適合收集各種零散的資訊
比如某個疑難雜症某人解掉了, 可以順手貼上WIKI, 之後的人看到就可以直接用

我們對文件的概念是, 寫文件需要時間, 而文件的價值正比於被多少人讀過
文件放在WIKI上非常容易編輯, 有錯誤也可以直接更正


----


在我推廣WIKI的時候, 最大的困難還是來自使用者, 有幾個點

  • 不適應語法
    WIKI的語法說難不難, 只是要學新東西, 大家多少會有些抗拒
    還好常用的語法都有範例可以抄, 只要在某個頁面預先打好常用的語法
    剩下就只是複製貼上, 這個還算容易
  • 不習慣使用
    這個是更根本的問題, 每個人工作習慣不同, 不是每個人都能接受這種flow
    就像版本控制是好物, 但是實務上, 用 src_20120923也不是不能做事
一個可以突破的點是, 團隊發布消息, 或著討論的結果可以用WIKI發布
因為用WIKI發布, 很明顯比寄出email還優秀一點;
另外是討論的事項也可以使用WIKI來做, 有點像是用WIKI來共同編輯一份 Q&A


----




最後, 工具沒有絕對的好壞, 即使土炮的方法也可以運作得很好
WIKI可以做為文件管理系統的一個選項, 我是自己先來當筆記本用了一段時間
發現很好用, 才推出去讓其他人也用看看, 在團隊溝通上, 效果很好
如果不能接受, 那就留著當筆記本用, 也是可以增進個人效率



留言

這個網誌中的熱門文章

STM32 UART + DMA,使用HAL實作TX/RX,以及不定長度接收

幼犬書桌椅選擇心得 升降桌 兒童桌椅

CANON G3000 廢墨瓶改裝