* Added Appendix B for A/B testing.

03-02-05-single.rst

@@ -27,8 +27,8 @@
 
     選擇單選題型
 
-往下拉找到「邏輯」展開，點按開啟「『其他：』必填的評論：」。答題選擇其
-他時，必須填上幾年級。
+往下拉找到「邏輯」展開，點按開啟「『其他：』必填的評論」。答題選擇其他
+時，必須填上幾年級。
 
 .. figure:: images/03-02-05-single-03.png
     :alt: 展開「邏輯」設定

03-03-01-number.rst

@@ -31,7 +31,7 @@
 
 往下拉找到「輸入」展開。每天最多24小時，最少0小時，為免填錯，可以限制
 輸入值的範圍。請在最小值填上0，最大值填上24。因為可能會有3.5小時，不開
-啟「只能整數」。最後按「儲存並關閉」。
+啟「只能整數」。最後回到右上角按「儲存」。
 
 .. figure:: images/03-03-01-number-03.png
     :alt: 展開「輸入」設定

apx-02-ab-testing.rst

@@ -0,0 +1,266 @@
+A/B卷測驗
+=========
+
+:index:`A/B卷測驗 <問卷; A/B卷>` ，是以兩份不同版本的題目，兩份題目之
+間有一個控制變數不同，來比較兩組填答者的回應。在統計上，是一種兩組樣本
+的假設檢定。A/B卷測驗常常用在行銷有效性研究上，讓兩組消費者觀看不同的
+廣告，來比較兩種廣告的效果；或是讓瀏覽者隨機看到兩種網站設計，再依據
+瀏覽者的反應，比較哪種網站設計較優。
+
+LimeSurvey可以用來製作A/B卷測驗：填答者隨機分組，填寫該組問卷。
+做法如下：
+
+1. 在問卷最前面，加上隱藏的第零題組別，由亂數隨機分配。
+2. 後續的問卷題目，依組別跳題，給填答者不同版本的問卷。
+
+
+建立隱藏的分組題
+################
+
+我們首先建立一份全新的空白問卷，標題填上「促銷文案效果測試問卷」。
+
+.. figure:: images/apx-02-01-groups-01.png
+    :alt: 建立全新的A/B卷測驗問卷
+    :scale: 60%
+
+    建立全新的A/B卷測驗問卷
+
+在新問卷上加上一個題組。題組標題填上「促銷文案效果測試問卷」。我們只
+需要一個題組。
+
+.. figure:: images/apx-02-01-groups-02.png
+    :alt: 加上問卷題組
+    :scale: 60%
+
+    加上問卷題組
+
+接下來在題組內，加上第零題組別。新增一題問題，在新增問卷問題的編輯
+頁面上，編號填上「group」，問題的主文填上「{rand(1,2)}」，題型選擇
+「其他類型問題」裏的「公式」。
+
+.. figure:: images/apx-02-01-groups-03.png
+    :alt: 第零題組別
+    :scale: 60%
+
+    第零題組別
+
+.. figure:: images/apx-02-01-groups-04.png
+    :alt: 選擇公式題型
+    :scale: 60%
+
+    選擇公式題型
+
+往下拉找到「顯示」展開，點按開啟「始終隱藏本題」。
+
+.. figure:: images/apx-02-01-groups-05.png
+    :alt: 展開「顯示」設定
+    :scale: 60%
+
+    展開「顯示」設定
+
+.. figure:: images/apx-02-01-groups-06.png
+    :alt: 開啟「始終隱藏本題」
+    :scale: 60%
+
+    開啟「始終隱藏本題」
+
+回到右上角按「儲存」。
+
+
+建立兩組各自的介紹文
+####################
+
+接下來我們按照組別，提供不同的介紹文，比較兩者的閱讀效果。
+
+新增第一組的介紹文。第一組是純文字的簡單介紹文。新增一題問題，在新增問
+卷問題的編輯頁面上，編號填上「text01」，問題的主文填上：
+
+    玻璃海岸位在宜蘭縣南方澳漁港及內埤海岸(俗稱：情人彎)之間。這片海灣，於民國72年前曾經被稱為「賊仔澳垃圾場」，那時候垃圾車把垃圾從15~20公尺高的懸崖上往下倒，而該垃圾中或多或少也參雜了許多不同顏色的玻璃瓶。經年累月，於環保意識抬頭及保護環境生態的情形之下，當年這些玻璃瓶隨著時間、隨著海浪沖洗，如今已被磨為迷你礫石大小的海玻璃，並與海砂混合在一起，如今也成為大自然的一部分。
+
+題型選擇「其他類型問題」裏的「文字顯示」。然後按「儲存」。
+
+.. figure:: images/apx-02-02-text-01.png
+    :alt: 第一組：格式單調的介紹文
+    :scale: 60%
+
+    第一組：格式單調的介紹文
+
+.. figure:: images/apx-02-02-text-02.png
+    :alt: 選擇文字顯示題型
+    :scale: 60%
+
+    選擇文字顯示題型
+
+接著按上方「Set conditions」設定問題的條件。在設定問題條件的頁面上，往
+下拉到頁面下方「增加條件」的地方，問題選剛剛的第零題組別
+「group: {rand(1,2)}」答案點右邊「常數」後，在下方填上「1」，然後按下
+「增加條件」。
+
+.. figure:: images/apx-02-02-text-03.png
+    :alt: 問題選擇第零題組別，答案切換到右邊的「常數」
+    :scale: 60%
+
+    問題選擇第零題組別，答案切換到右邊的「常數」
+
+.. figure:: images/apx-02-02-text-04.png
+    :alt: 答案填上「1」
+    :scale: 60%
+
+    答案填上「1」
+
+回到頁面上方，剛剛設的條件已經加上去了：
+
+    group: {rand(1,2)} 等於 1
+
+.. figure:: images/apx-02-02-text-05.png
+    :alt: 設好的第一組介紹文條件
+    :scale: 60%
+
+    設好的第一組介紹文條件
+
+我們按上方的「關閉」。
+
+接著新增第二組的介紹文。第二組是把關鍵字都用不同顏色標記起來，格式花俏
+的介紹文。新增一題問題，在新增問卷問題的編輯頁面上，編號填上「text02」
+，問題的主文填上和第一組一樣的文字：
+
+    玻璃海岸位在宜蘭縣南方澳漁港及內埤海岸(俗稱：情人彎)之間。這片海灣，於民國72年前曾經被稱為「賊仔澳垃圾場」，那時候垃圾車把垃圾從15~20公尺高的懸崖上往下倒，而該垃圾中或多或少也參雜了許多不同顏色的玻璃瓶。經年累月，於環保意識抬頭及保護環境生態的情形之下，當年這些玻璃瓶隨著時間、隨著海浪沖洗，如今已被磨為迷你礫石大小的海玻璃，並與海砂混合在一起，如今也成為大自然的一部分。
+
+然後利用問題主文的格式功能，在關鍵字上標記顏色。你也可以以原始碼編輯，
+貼上下列HTML原始碼：
+
+    <b><font color="#FF0000">玻璃海岸</font>位在<font color="#0000FF">宜蘭縣南方澳漁港</font>及<font>內埤海岸(俗稱：情人彎)</font>之間。這片海灣，於民國72年前曾經被稱為<font>「賊仔澳垃圾場」</font>，那時候垃圾車把垃圾從15~20公尺高的懸崖上往下倒，而該垃圾中或多或少也參雜了<font>許多不同顏色的玻璃瓶</font>。經年累月，於<font color="#FF0000">環保意識抬頭及保護環境生態</font>的情形之下，當年這些玻璃瓶<font>隨著時間</font>、<font>隨著海浪沖洗</font>，如今已被磨為<font>迷你礫石大小</font>的<font color="#0000FF">海玻璃</font>，並<font>與海砂混合</font>在一起，如今也成為大自然的一部分。</b>
+
+題型一樣選擇「其他類型問題」裏的「文字顯示」。然後按「儲存」。
+
+.. figure:: images/apx-02-02-text-06.png
+    :alt: 第二組介紹文的HTML原始碼
+    :scale: 60%
+
+    第二組介紹文的HTML原始碼
+
+.. figure:: images/apx-02-02-text-07.png
+    :alt: 第二組：顏色花俏的介紹文
+    :scale: 60%
+
+    第二組：顏色花俏的介紹文
+
+
+接著按上方「Set conditions」設定問題的條件。在設定問題條件的頁面上，往
+下拉到頁面下方「增加條件」的地方，問題選剛剛的第零題組別
+「group: {rand(1,2)}」答案點右邊「常數」後，在下方填上「2」，然後按下
+「增加條件」。
+
+.. figure:: images/apx-02-02-text-08.png
+    :alt: 問題選擇第零題組別，答案切換到右邊的「常數」，填上「2」
+    :scale: 60%
+
+    問題選擇第零題組別，答案切換到右邊的「常數」，填上「2」
+
+回到頁面上方，剛剛設的條件已經加上去了：
+
+    group: {rand(1,2)} 等於 2
+
+.. figure:: images/apx-02-02-text-09.png
+    :alt: 設好的第二組介紹文條件
+    :scale: 60%
+
+    設好的第二組介紹文條件
+
+我們按上方的「關閉」。
+
+
+建立問卷題目
+############
+
+接下來我們建立問卷題目。
+
+第一題詢問介紹文的易讀性。在新增問卷問題的編輯頁面上，編號填上
+「q01」，問題的主文填上
+「上述景點介紹讀起來好不好讀？（1：非常不好讀；2：不好讀；3：普通；4：好讀；5：非常好讀。）」，
+題型選擇「單選問題」裏的「5分選擇」，開啟「必須回應」，然後按右上角的
+「儲存」。
+
+.. figure:: images/apx-02-03-questions-01.png
+    :alt: 第一題：介紹文的易讀性
+    :scale: 60%
+
+    第一題：介紹文的易讀性
+
+.. figure:: images/apx-02-03-questions-02.png
+    :alt: 選擇5分選擇題型
+    :scale: 60%
+
+    選擇5分選擇題型
+
+第二題詢問介紹文吸引人的效果。在新增問卷問題的編輯頁面上，編號填上
+「q02」，問題的主文填上
+「讀完上述景點介紹後，你會想去該景點旅遊嗎？」，題型選擇
+「其他類型問題」裏的「是／否」，開啟「必須回應」，然後按右上角的
+「儲存」。
+
+.. figure:: images/apx-02-03-questions-03.png
+    :alt: 第二題：介紹文吸引人的效果
+    :scale: 60%
+
+    第二題：介紹文吸引人的效果
+
+第二題詢問填答者的年齡。在新增問卷問題的編輯頁面上，編號填上
+「q03」，問題的主文填上「請問您今年幾歲？」，題型選擇
+「其他類型問題」裏的「是／否」，開啟「必須回應」。
+
+.. figure:: images/apx-02-03-questions-03.png
+    :alt: 第三題：填答者的年齡
+    :scale: 60%
+
+    第三題：填答者的年齡
+
+往下拉找到「輸入」展開。年齡只能填寫整數，最小是1歲。在最小值填上1，
+開啟「只能整數」。
+
+.. figure:: images/apx-02-03-questions-05.png
+    :alt: 限制年齡填答範圍
+    :scale: 60%
+
+    限制年齡填答範圍
+
+最後回到右上角按「儲存」。
+
+第四題詢問填答者的性別。在新增問卷問題的編輯頁面上，編號填上
+「q04」，問題的主文填上「請問您的性別？」，題型選擇
+「其他類型問題」裏的「姓別」，開啟「必須回應」，然後按右上角的
+「儲存」。
+
+.. figure:: images/apx-02-03-questions-06.png
+    :alt: 第四題：填答者的性別
+    :scale: 60%
+
+    第四題：填答者的性別
+
+這樣一份簡單的A/B卷測驗問卷就完成了。
+
+
+施測
+####
+
+實際執行這份A/B卷測驗看看。從上方按下「預覽問卷」，開始模擬作答。
+
+如圖所示，模擬作答時，問卷系統提供了第一組問卷，格式單調的介紹文。
+
+.. figure:: images/apx-02-04-run-01.png
+    :alt: 第一組：格式單調的介紹文
+    :scale: 60%
+
+    第一組：格式單調的介紹文
+
+我們重做一次問卷。按右上角「離開並清除問卷」，再重新作答。這一次，
+問卷系統提供了第二組問卷，顏色花俏的介紹文。
+
+.. figure:: images/apx-02-04-run-02.png
+    :alt: 第二組：顏色花俏的介紹文
+    :scale: 60%
+
+    第二組：顏色花俏的介紹文
+
+分組是隨機分配的，執行的的結果可能有所不同。如果看不到另外一組問卷，
+可以多試幾次，按右上角「離開並清除問卷」，再重新作答。

apx-02-ab-testing.rst.draft

@@ -1,18 +0,0 @@
-A/B卷測驗
-=========
-
-在某些研究實驗的要求中，填答者要依隨機亂數分到不同的組別，填寫不同的問
-卷，以比較兩份問卷的結果。嚴格的盲測時，施測者不參與分組，由系統在填答
-者不知情的情況下，隨機為填答者直接提供任一份問卷。我們叫做
-「 :index:`A/B卷測驗` 」。
-
-LimeSurvey提供簡單又強大的方法，來製作A/B卷測驗。在問卷的最前面，建立
-一題隱藏公式題，題目內容為亂數值。後面的問卷，就可以引用這一題的亂數值
-，來設定跳題規則。
-
-在新建的問卷上，加上第零題。在新增問卷問題的編輯頁面上，編號填上
-「group」，問題填上「{rand(1,2)}」題型往下拉選「公式」，然後按下
-「Advanced settings」。
-
-接著往下拉到「顯示」，開啟「始終隱藏本題」。
-

conf.py

@@ -289,7 +289,7 @@ latex_documents = [
 
 # Documents to append as an appendix to all manuals.
 #
-latex_appendices = ['apx-01-copy']
+latex_appendices = ['apx-01-copy', 'apx-02-ab-testing']
 
 # It false, will not define \strong, \code, 	itleref, \crossref ... but only
 # \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added

index.rst

@@ -56,7 +56,7 @@
 		:caption: 附錄
 		
 		apx-01-copy
-..		apx-02-ab-testing
+		apx-02-ab-testing
 	
     索引
     ====