SlideSword - 網頁格式的聖經經文投影片產出工具。
作者：DarkRanger (http://darkranger.no-ip.org)


版本歷史
================
Beta 0.2(20141128)
----------------
* 修正拖放（Drag & Drop）功能的程式碼。

Beta 0.1(20131226)
----------------
* 首次釋出。


原始碼授權許可
================
GNU General Public License.


鳴謝
================
SlideSword 包含由下列人士/社群所發佈的元件：

pysword - Kenneth Arnold
github.com/kcarnold/pyswor

The SWORD Project
www.crosswire.org


執行需求
================
Windows、Linux、Mac OS X 等平台若以 Python 原始碼的方式執行，安裝以下套件方能執行：
* Python 2.7.x (http://www.python.org/)
* PySide (http://www.pyside.org/)

Windows 平台可選擇直接使用獨立執行檔執行。


使用 SlideSword
================
(1)在依序安裝所需的套件後，執行 slidesword.py 即可啟動 SlideSword。或者直接執行專用於
   Widnows 版的 slidesword.exe
(2)選擇【舊約】或【新約】
(3)選擇書卷
(4)輸入欲產出的章節範圍
(5)選擇翻譯版本（預設為繁體中文和合本聖經）
(6)選擇網頁範本，檔案包內有一支基本的網頁檔（templates\test.htm）可供選擇
(7)點擊【產出網頁】後，SlideSword 會讀取網頁範本，在同一目錄下另存成一支加上日期時間的網頁檔。
   該網頁檔會以 JavaScript 程式碼的方式寫入聖經經文，同時也會將所需的 jQuery 複製到同一目錄裡。
(8)用網頁瀏覽器開啟新產出的網頁檔就可檢視聖經經文

如果是點擊【產出文字檔】則無須選擇網頁範本。產出的文字檔會以日期時間為檔名存放在 SlideSword 的目錄裡。


網頁投影片的按鍵操作
================
SlideSword 所產出的網頁檔使用 jQuery 模仿簡報軟體（例如 Microsoft PowerPoint）的播放按鍵，可用的按鍵如下所示：
滑鼠左鍵、Enter、空白鍵 - 下一張投影片
方向鍵、滑鼠滾輪、Page Up、Page Down - 投影片切換
Home - 第一張投影片
End - 最後一張投影片
數字鍵 + Enter - 切換至指定頁碼的投影片
W、B - 隱藏區塊（div）元素


撰寫網頁範本
================
自行設計的網頁範本需符合以下要求才能正確的被 SlideSword 使用：
(1)網頁編碼必須是 UTF-8
(2)<body></body> 及 <head></head> 必須存在，因為這是 SlideSword 用來判定插入 JavaScript 的位置
(3)需置入以下的區塊標籤，這些區塊會分別用 JavaScript 替換為「書卷名稱」、「經文」以及「頁碼」：
   <div id="book-chapter"></div>
   <div id="bible-verses"></div>
   <div id="page-number"></div>

實際範例可見檔案包所附的範例原始碼（templates\test.htm）。


新增聖經翻譯版本
================
聖經檔可至 http://www.crosswire.org/sword/modules/ModDisp.jsp?modType=Bibles 下載。下載後解壓縮將裡頭
「ztext」下的目錄複製到 SlideSword 目錄的 modules\texts\ztext 裡，再執行 SlideSword 就會有新的版本可選擇。


問題集
================
Q:產出的投影片沒有顯示任何文字？按鍵沒有效果？
A:請確認所需的 jQuery 已位於相同的目錄中，通常 SlideSword 會在產出時複製一份至目標目錄。

Q:SlideSword 無法跨不同章設定經節範圍？
A:是的，SlideSword 目前的設定介面不具有這樣的選取彈性。
