我的小擴充套件說明

如何安裝
發揮軟體自由，修改「我的小擴充套件」，讓它更貼身

這個小擴充軟體可以讓你的火狐有更多的秘技，你也可以自行加入你想要的秘技。
現在有小圖提示秘技、備份秘技和延時秘技。功能分佈如下：

普遍通用功能	表情提示、延時
無名小站	表情提示(包括站內小圖和格式)、網誌備份、留言備份
Xanga	表情提示
香港新浪網誌MySinaBlog	表情提示
雅虎香港Yahoo!(R)Blog	網誌備份
樂多網誌	表情提示
phpBB(包括哈啦無名)	表情提示
Discuz!	表情提示

本軟體另一個特色就是它是自由軟體。自由軟體包括有四方面的自由：
* 任意使用的自由；
* 研究及修改以符合自己用途的自由；
* 拷貝給親朋好友的自由；
* 散布修改後的軟體的自由。

本程式所包括各種小圖：
* 洋蔥小圖作者為Ethan，採用

Creative Commons姓名標示─非商業性─禁止改作授權條款授權。
* 彎彎小圖的作者是彎彎，請勿自行加工修改或用於商業用途。
* 兔斯基的作者是王卯卯，請勿自行加工修改或用於商業用途。
* 輔大猴的作者是輔大猴，採用

Creative Commons姓名標示─非商業性─禁止改作授權條款授權。
* 滷蛋的作者是老吳，請勿自行加工修改或用於商業用途。
* SANA的作者是SANA，採用

Creative Commons姓名標示─非商業性─禁止改作授權條款授權。
* 薇薇兔的作者是薇薇兔，請勿自行加工修改或用於商業用途。
* Lamji的作者是Lamji，請勿自行加工修改或用於商業用途。
* 無名小圖是引用自無名小站，請只在無名小站使用。
除此以外的程式和檔案都是以GNU GPL授權。

如果想多點認識自由軟體，可以參考洪老師和藹可親的介紹文章阿 ^^
http://people.ofset.org/~ckhung/index.php(見「短文 [articles]」和「演講摘要 [slides]」)

程式的開發網站在中研院資訊所的自由軟體鑄造場。 (http://rt.openfoundry.org/Foundry/Project/?Queue=617)
更新的紀錄和相關討論在moztw那兒。(http://forum.moztw.org/viewtopic.php?t=14870)
也可以去作者小兔黑黑的網誌去找他。(http://littleblackrabit.mysinablog.com/)

創作本套件起初的動機，是我看見Firefox火狐越來越多人用，而且也有很多有趣的套件，於是我也來學一下創作套件。

手上有兩個想要的功能，第一個是延時功能、第二個無名網誌提示。延時功能是玩flash小遊戲時可以減低難度，之前是用HTML中的Frame分頁來做的。有了套件，就可以更方便在任何網頁中加入延時。另一個就是在無名網誌加入小圖是十分麻煩的，於是我製作了個「無名網誌表情符號對照表」，有不少朋友拿來參考。這個對照表可以變成套照，可以直接加入網誌中。這就是0.1版。

在0.2版，加入了Ethan的洋蔥小圖和彎彎小圖。跟著讀了李怡志談Creative Commons和彎彎的文章，發覺小圖其實可以成為一個宣傳作者的媒介。一般小圖的姓名標示其實比較弱，我相信有些在MSN上用洋蔥頭的人也不會知道Ethan是誰。所以在0.3版中加入「小圖出處」的資料，幫助作者宣傳。

在0.4版又加入無名網誌和留言備份。之前曾用Python寫過網誌備份，因為不想分開兩個程序來維護，就把之前的程序移植過來。除了無名有提示，又多支援了新浪網誌、樂多網誌和phpBB。

在0.5版，加入了Discuz、Xanga和一個普遍通用的小圖提示，因為針對個別網站去編程很花時間。另一方面，又加入了三組小圖，包括王卯卯的兔斯基、輔大猴和老吳的尪仔標。

展望將來，希望可以支援多國語言。

如何安裝

(圖片來自http://www.limo.fumi2kick.com/fbbs/lmwiki.rhtml?topic=FireFox-Tan)

1. 大家先要去http://moztw.org/下載可愛又好用的Firefox「火狐」瀏覽器。
2. 安裝了Firefox「火狐」之後，下載最新版本的我的小擴充套件至桌面上。
3. 把桌面上的檔案拖放到Firefox「火狐」中。

(上面只是示範，little0.1已經很舊了，請下載最新版本。)
4. 安裝完成。

你也可以放一個自訂的圖示在火狐上端的工具列。先到工具列上按滑鼠右鍵，然後選「自訂」。

普遍通用功能

延時

利用這個功能，可以減慢如flash小遊戲等的速度，令遊戲變得更易。
用戶在有關網頁按右下角的「小」字，選擇「延時」，延時功能就會開始。用右面的捲軸控制延時的多少。

表情提示

擴充套件可以提供表情提示，可以選擇HTML、內含HTML的BBCode和不含HTML的BBCode。選擇表情後，可以按「抄」把小圖的代碼抄玩，然後可以隨意貼在有關的地方。不要忘記貼上小圖出處阿！

無名小站

網誌備份
特點：
* 不論是金銀或免費會員，功能一樣，一樣可以備份。
* 已登入的會員可以連隱藏的網誌也備份，沒登入者可以備份公開的網誌。
* 連引用的圖片也可備份。
* 用普通瀏覽器可以離線讀取備份檔。

用法：
1. 網誌的首頁按右下角的「小」字，選「網誌備份」。
2. 等候分析網誌，製作網誌條目，分析完畢會顯示條目數量。
3. 可以配合shift和ctrl鍵選擇網誌條目，然後按下「選擇下載」或「選擇不下載」去控制下載哪些網誌。
4. 按「瀏覽」，輸入備份路徑。
5. 按「備份」開始備份。
小提示：
* 如果有很多篇網誌，可以分開幾次下載。
* 如果在網誌上掛了太多東西，備份檔可能會不完備，煩請備份完畢後檢查一下檔案大小。有問的可以重新下載一次。

留言備份

跟網誌備份大同小異，在留言頁按右下角的「小」字，選「留言備份」即可啟用。

網誌提示

當編輯無名網誌時(一般編輯器)，擴充套件可以提供字體、格式和表情等的提示。這個功能可以用快速鍵ctrl-alt-L呼叫。

小圖的作者花上了不少心思，所以在版面上有注明作者和網站，把小圖貼在網誌時也會包括作者的資料和出處，也希望大家使用小圖時遵守使用條件。

Xanga

當編輯Xanga時(不要使用Edit HTML)，擴充套件可以提供表情提示。

香港新浪網誌MySinaBlog

當編輯新浪網誌時，擴充套件可以提供表情提示。

小圖的作者花上了不少心思，所以在版面上有注明作者和網站，把小圖貼在網誌時也會包括作者的資料和出處，也希望大家使用小圖時遵守使用條件。

雅虎香港Yahoo!(R)Blog

網誌備份
特點：
* 已登入的會員可以連隱藏的內容也備份，沒登入者可以備份公開的網誌。
* 連引用的圖片也可備份。

樂多網誌

當編輯新浪網誌時(使用普通文章編輯器)，擴充套件可以提供表情提示。

小圖的作者花上了不少心思，所以在版面上有注明作者和網站，把小圖貼在網誌時也會包括作者的資料和出處，也希望大家使用小圖時遵守使用條件。

phpBB(包括哈啦無名)

當在phpBB上發表，擴充套件可以提供表情提示。又可以配合站上的設定，選擇使用或不使用HTML語法。

Discuz!

當在Discuz!上發表，擴充套件可以提供表情提示。又可以配合站上的設定，選擇使用或不使用HTML語法。

小圖的作者花上了不少心思，所以在版面上有注明作者和網站，把小圖貼在文章中也會包括作者的資料和出處，也希望大家使用小圖時遵守使用條件。

發揮軟體自由，修改「我的小擴充套件」，讓它更貼身

這個小小的軟體除了可以讓你用它，你也可以隨意去修改它。它是以XUL和Javascript技術開發，如果你對HTML、CSS等咚咚有一點點認識，很容易就可以學會。你需要一個跟UTF-8和BOM兼容的檔案修改程式(如Windows中的Notepad記事本)。每次安裝新版本會完全蓋過你的修改，請時常備份，也可用如Subversion的版本控制程式。

火狐的特別設定

如果你使用Windows，請安裝IETab擴充套件。可在http://ietab.mozdev.org/安裝IETab擴充套件。這個擴充套件是在台灣陽明大學醫學系的PCMan寫的，在國內外廣受好評喔。

修改一下profile中的user.js，可以令開發更順手。

先看看這頁的url路徑。如果你是用Windows，路徑大概會是：
file:///C:/Documents%20and%20Settings/用戶名字/Application%20Data/Mozilla/Firefox/Profiles/???.??/extensions/Little@black.rabbit/chrome/help/help.htm

Profile的路徑就是：
file:///C:/Documents%20and%20Settings/用戶名字/Application%20Data/Mozilla/Firefox/Profiles/???.??/

你用這個Profile的路徑來開一個新的分頁，就可以看到Profile裡面的檔案。如果你是用Windows，可以按右下角的火狐小圖，就會變成用Windows來做檔案管理。打開user.js，加入以下幾句：

// Log errors in chrome file to the Javascript Console
user_pref( "javascript.options.showInConsole", true);
// Disable XUL cache, so chrome changes do not require a restart
user_pref( "nglayout.debug.disable_xul_cache", true);
// dump() function outputs to console if application started with -console flag
user_pref( "browser.dom.window.dump.enabled", true);
// Enable strict javascript warnings, to produce clean extensions
user_pref( "javascript.options.strict", true);

得到擴充套件在電腦中的路徑

先看看這頁的url路徑。如果你是用Windows，路徑大概會是：
file:///C:/Documents%20and%20Settings/用戶名字/Application%20Data/Mozilla/Firefox/Profiles/???.??/extensions/Little@black.rabbit/chrome/help/help.htm

擴充套件的路徑就是：
file:///C:/Documents%20and%20Settings/用戶名字/Application%20Data/Mozilla/Firefox/Profiles/???.??/extensions/Little@black.rabbit/

你用這個擴充套件的路徑來開一個新的分頁，就可以看到擴充套件裡面的檔案。

如果你是用Windows，可以按右下角的火狐小圖，就會變成用Windows來做檔案管理。

增加普通功能

普通功能的相關路徑和檔案：
擴充套件的路徑/chrome/default
XUL表現架構 a_popup.xul
程式 a_popup.js

增加其他網站的特有功能

例如你想為aaa.com寫一個特有功能，你先打開擴充套件路徑/chrome/，在現有的目錄如default、phpbb或roodo等找個作範例，把它拷貝，名為aaa目錄。然後在little.js中的little_toolbar_popup函數加入新的條件：

  if (locstr.indexOf("www.wretch.cc/blog/modify.php")!=-1) {
    var a_popup = getCurWW().openWindow(null,
      "chrome://little/content/wretch/a_popup.xul", "a_popup", 
      "chrome,left="+popupleft+",top="+popuptop, null);
  }else if (locstr.indexOf("aaa.com")!=-1) {
    var a_popup = getCurWW().openWindow(null,
      "chrome://little/content/aaa/a_popup.xul", "a_popup", 
      "chrome,left="+popupleft+",top="+popuptop, null);
  }else{
    var a_popup = getCurWW().openWindow(null,
      "chrome://little/content/default/a_popup.xul", "a_popup", 
      "chrome,left="+popupleft+",top="+popuptop, null);
  }

當你在aaa.com啟動我的小擴充套件，擴充套件路徑/chrome/aaa/a_popup.xul就會被呼叫出來了。

鳴謝

中研院資訊所自由軟體鑄造場
無名小站
彎彎～用漫畫寫日誌
☆毛媽媽?隋手札記☆
洋蔥酷樂部
【自得其樂】
因為我是輔大猴
老吳的尪仔標
Sana的漫畫網誌
薇薇兔的無聊日誌
Lamji的塗鴉日誌

我的小擴充套件 說明