Advanced to version 2.5.

* Updated the links to the URLs of version 2 documents.

.gitignore

@@ -0,0 +1,3 @@
+build
+.idea
+make_all_sync

03-04-01-yesno.rst

@@ -1,21 +0,0 @@
-第八個問題：是／否
-##################
-
-第八個問題，要詢問答題者是否是本校學生。我們會用到
-:index:`「是／否」題型 <題型; 是／否>`。
-
-在新增問卷問題的編輯頁面上，編號填上「q08」，問題填上「8.您是不是台師
-大學生？」題型往下拉選「是／否」，題組選「參、其他」，開啟「必須
-回應」，然後按「儲存並關閉」。
-
-.. figure:: images/03-03-04-order-01.png
-    :alt: 問題七：排序題型
-    :scale: 60%
-
-    問題七：排序題型
-
-.. figure:: images/03-03-04-order-04.png
-    :alt: 排序題型預覽
-    :scale: 60%
-
-    排序題型預覽

LICENSE

@@ -0,0 +1,396 @@
+Attribution 4.0 International
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution 4.0 International Public License ("Public License"). To the
+extent this Public License may be interpreted as a contract, You are
+granted the Licensed Rights in consideration of Your acceptance of
+these terms and conditions, and the Licensor grants You such rights in
+consideration of benefits the Licensor receives from making the
+Licensed Material available under these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  d. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  e. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  f. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  g. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  h. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  i. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  j. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  k. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part; and
+
+            b. produce, reproduce, and Share Adapted Material.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+       4. If You Share Adapted Material You produce, the Adapter's
+          License You apply must not prevent recipients of the Adapted
+          Material from complying with this Public License.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material; and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
+

Makefile

@@ -1,240 +1,20 @@
-# Makefile for Sphinx documentation
+# Minimal makefile for Sphinx documentation
 #
 
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = _build
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
 
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-# My local extension
-PROJNAME		= learning-limesurvey
-PROJVER			= 2.2
-
-.PHONY: help
+# Put it first so that "make" without argument is like "make help".
 help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  applehelp  to make an Apple Help Book"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  epub3      to make an epub3"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-	@echo "  coverage   to run coverage check of the documentation (if enabled)"
-	@echo "  dummy      to check syntax errors of document sources"
-	@echo "  dist		to create a document source distribution"
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: clean
-clean:
-	rm -rf $(BUILDDIR)/*
+.PHONY: help Makefile
 
-.PHONY: html
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-.PHONY: dirhtml
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-.PHONY: singlehtml
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-.PHONY: pickle
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-.PHONY: json
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-.PHONY: htmlhelp
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-.PHONY: qthelp
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/LimeSurvey.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/LimeSurvey.qhc"
-
-.PHONY: applehelp
-applehelp:
-	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
-	@echo
-	@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
-	@echo "N.B. You won't be able to view it unless you put it in" \
-	      "~/Library/Documentation/Help or install it in your application" \
-	      "bundle."
-
-.PHONY: devhelp
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/LimeSurvey"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/LimeSurvey"
-	@echo "# devhelp"
-
-.PHONY: epub
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-.PHONY: epub3
-epub3:
-	$(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3
-	@echo
-	@echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3."
-
-.PHONY: latex
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	patch -p 1 < $(PROJNAME).tex.patch
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-.PHONY: latexpdf
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	patch -p 1 < $(PROJNAME).tex.patch
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: latexpdfja
-latexpdfja:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through platex and dvipdfmx..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: text
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-.PHONY: man
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-.PHONY: texinfo
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-.PHONY: info
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-.PHONY: gettext
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-.PHONY: changes
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-.PHONY: linkcheck
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-.PHONY: doctest
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
-.PHONY: coverage
-coverage:
-	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
-	@echo "Testing of coverage in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/coverage/python.txt."
-
-.PHONY: xml
-xml:
-	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
-	@echo
-	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-.PHONY: pseudoxml
-pseudoxml:
-	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
-	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
-
-.PHONY: dummy
-dummy:
-	$(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy
-	@echo
-	@echo "Build finished. Dummy builder generates no files."
-
-dist:
-	rm -rf $(BUILDDIR)/dist
-	mkdir $(BUILDDIR)/dist $(BUILDDIR)/dist/$(PROJNAME)-$(PROJVER)
-	cp -fpR *.rst images Makefile make.bat conf.py $(PROJNAME).tex.patch participants-example.csv $(BUILDDIR)/dist/$(PROJNAME)-$(PROJVER)/
-	cd $(BUILDDIR)/dist && zip -r $(PROJNAME)-$(PROJVER).zip $(PROJNAME)-$(PROJVER) && cd ../..
-	@echo
-	@echo "Build finished. The distribution is in _build/dist."
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

README.rst

@@ -0,0 +1,62 @@
+Learning LimeSurvey — The Survey Service in National Taiwan Normal University
+==============================================================================
+
+**WARNING**: This is for LimeSurvey 2 and is outdated.  Please check
+the `current version`_.
+
+*«Learning LimeSurvey — The Survey Service in National Taiwan Normal
+University»* is a Chinese LimeSurvey_ tutorial.  It features
+`project-based learning`_:  By creating a simple yet practical survey,
+it walks through the frequently-used features of LimeSurvey.  It is
+written in reStructuredText_ with Sphinx_ extension.
+
+*«Learning LimeSurvey — The Survey Service in National Taiwan Normal
+University»* is written by imacat_.  Read the tutorial_ (Chinese)
+online, or check the `GitHub source documents`_.
+
+.. _current version: https://github.com/imacat/learning-limesurvey
+.. _LimeSurvey: https://www.limesurvey.org
+.. _project-based learning: https://en.wikipedia.org/wiki/Project-based_learning
+.. _reStructuredText: https://docutils.sourceforge.io/rst.html
+.. _Sphinx: https://www.sphinx-doc.org
+.. _imacat: imacat@ntnu.edu.tw
+.. _tutorial: https://limesurvey.imacat.idv.tw/learning/v2/
+.. _GitHub source documents: https://github.com/imacat/learning-limesurvey
+
+
+HTML, PDF, and Other Formats
+----------------------------
+
+This tutorial can be converted into various formats.  To do so, you
+need to install Sphinx first.  On Debian/Ubuntu::
+
+  # sudo apt install python-sphinx
+
+Or, on Red Hat/Fedora/CentOS::
+
+  # sudo yum install python-sphinx
+
+Or use ``pip``::
+
+  # pip install sphinx
+
+After installation, run::
+
+  # make help
+
+to see the available conversion commands.  For example, to generate
+HTML, PDF, ePUB, manpage, and Texinfo documents respectively::
+
+  # make html
+  # make latexpdf
+  # make epub
+  # make man
+  # make texinfo
+
+Copyright |copy| 2017-2021 imacat, 2017-2018 National Taiwan Normal
+University.  This work is licensed under a
+`Creative Commons Attribution 4.0 International License`_.
+
+.. _Creative Commons Attribution 4.0 International License: http://creativecommons.org/licenses/by/4.0/
+
+.. |copy| unicode:: 0xA9 .. copyright sign

conf.py

@@ -1,430 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# 台師大問卷調查平台LimeSurvey學習手冊 documentation build configuration file, created by
-# sphinx-quickstart on Wed Nov 15 15:39:50 2017.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = []
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
-
-# The encoding of source files.
-#
-# source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'台師大問卷調查平台LimeSurvey學習手冊'
-copyright = u'2017, 楊士青'
-author = u'楊士青 <imacat@ntnu.edu.tw>'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = u'2.2'
-# The full version, including alpha/beta/rc tags.
-release = u'2.2'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = 'zh_TW'
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#
-# today = ''
-#
-# Else, today_fmt is used as the format for a strftime call.
-#
-# today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
-
-# The reST default role (used for this markup: `text`) to use for all
-# documents.
-#
-# default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#
-# add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#
-# add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#
-# show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-# modindex_common_prefix = []
-
-# If true, keep warnings as "system message" paragraphs in the built documents.
-# keep_warnings = False
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = False
-
-
-# -- Options for HTML output ----------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = 'alabaster'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#
-# html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-# html_theme_path = []
-
-# The name for this set of Sphinx documents.
-# "<project> v<release> documentation" by default.
-#
-# html_title = u'台師大問卷調查平台LimeSurvey學習手冊 v2.2'
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#
-# html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#
-# html_logo = None
-
-# The name of an image file (relative to this directory) to use as a favicon of
-# the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#
-# html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# Add any extra paths that contain custom files (such as robots.txt or
-# .htaccess) here, relative to this directory. These files are copied
-# directly to the root of the documentation.
-#
-# html_extra_path = []
-
-# If not None, a 'Last updated on:' timestamp is inserted at every page
-# bottom, using the given strftime format.
-# The empty string is equivalent to '%b %d, %Y'.
-#
-# html_last_updated_fmt = None
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#
-# html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#
-# html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#
-# html_additional_pages = {}
-
-# If false, no module index is generated.
-#
-# html_domain_indices = True
-
-# If false, no index is generated.
-#
-# html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#
-# html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#
-html_show_sourcelink = False
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#
-# html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#
-# html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#
-# html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-# html_file_suffix = None
-
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
-#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr', 'zh'
-#
-# html_search_language = 'en'
-
-# A dictionary with options for the search language support, empty by default.
-# 'ja' uses this config value.
-# 'zh' user can custom change `jieba` dictionary path.
-#
-# html_search_options = {'type': 'default'}
-
-# The name of a javascript file (relative to the configuration directory) that
-# implements a search results scorer. If empty, the default will be used.
-#
-# html_search_scorer = 'scorer.js'
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'LimeSurveydoc'
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-     # The paper size ('letterpaper' or 'a4paper').
-     #
-     # 'papersize': 'letterpaper',
-
-     # The font size ('10pt', '11pt' or '12pt').
-     #
-     # 'pointsize': '10pt',
-
-     # Additional stuff for the LaTeX preamble.
-     #
-     # 'preamble': '',
-     'preamble':u"""
-\\usepackage{xeCJK}
-\\setCJKmainfont{AR PL UMing TW}
-\\setCJKsansfont{AR PL UKai TW}
-""",
-
-     # Latex figure (float) alignment
-     #
-     # 'figure_align': 'htbp',
-     'figure_align': 'H',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (master_doc, 'learning-limesurvey.tex', u'台師大問卷調查平台LimeSurvey學習手冊',
-     u'楊士青', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#
-# latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#
-# latex_use_parts = False
-
-# If true, show page references after internal links.
-#
-# latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#
-# latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#
-latex_appendices = ['apx-01-copy']
-
-# It false, will not define \strong, \code, 	itleref, \crossref ... but only
-# \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added
-# packages.
-#
-# latex_keep_old_macro_names = True
-
-# If false, no module index is generated.
-#
-# latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'learning-limesurvey', u'台師大問卷調查平台LimeSurvey學習手冊',
-     [author], 1)
-]
-
-# If true, show URL addresses after external links.
-#
-# man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, 'learning-limesurvey', u'台師大問卷調查平台LimeSurvey學習手冊',
-     author, 'Learning LimeSurvey', u'台師大問卷調查平台LimeSurvey學習手冊',
-     'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#
-# texinfo_appendices = []
-
-# If false, no module index is generated.
-#
-# texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#
-# texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-#
-# texinfo_no_detailmenu = False
-
-
-# -- Options for Epub output ----------------------------------------------
-
-# Bibliographic Dublin Core info.
-epub_title = project
-epub_author = author
-epub_publisher = author
-epub_copyright = copyright
-
-# The basename for the epub file. It defaults to the project name.
-# epub_basename = project
-epub_basename = 'learning-limesurvey'
-
-# The HTML theme for the epub output. Since the default themes are not
-# optimized for small screen space, using the same theme for HTML and epub
-# output is usually not wise. This defaults to 'epub', a theme designed to save
-# visual space.
-#
-# epub_theme = 'epub'
-
-# The language of the text. It defaults to the language option
-# or 'en' if the language is not set.
-#
-# epub_language = ''
-
-# The scheme of the identifier. Typical schemes are ISBN or URL.
-# epub_scheme = ''
-
-# The unique identifier of the text. This can be a ISBN number
-# or the project homepage.
-#
-# epub_identifier = ''
-
-# A unique identification for the text.
-#
-# epub_uid = ''
-
-# A tuple containing the cover image and cover page html template filenames.
-#
-# epub_cover = ()
-
-# A sequence of (type, uri, title) tuples for the guide element of content.opf.
-#
-# epub_guide = ()
-
-# HTML files that should be inserted before the pages created by sphinx.
-# The format is a list of tuples containing the path and title.
-#
-# epub_pre_files = []
-
-# HTML files that should be inserted after the pages created by sphinx.
-# The format is a list of tuples containing the path and title.
-#
-# epub_post_files = []
-
-# A list of files that should not be packed into the epub file.
-epub_exclude_files = ['search.html']
-
-# The depth of the table of contents in toc.ncx.
-#
-# epub_tocdepth = 3
-
-# Allow duplicate toc entries.
-#
-# epub_tocdup = True
-
-# Choose between 'default' and 'includehidden'.
-#
-# epub_tocscope = 'default'
-
-# Fix unsupported image types using the Pillow.
-#
-# epub_fix_images = False
-
-# Scale large images.
-#
-# epub_max_image_width = 0
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#
-# epub_show_urls = 'inline'
-
-# If false, no index is generated.
-#
-# epub_use_index = True

index.rst

@@ -1,63 +0,0 @@
-.. 台師大問卷調查平台LimeSurvey學習手冊 documentation master file, created by
-   sphinx-quickstart on Wed Nov 15 15:39:50 2017.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-台師大問卷調查平台LimeSurvey學習手冊
-====================================
-
-版權所有 |copy| 2017 楊士青。
-
-「台師大問卷調查平台LimeSurvey學習手冊」由
-`楊士青 <imacat@ntnu.edu.tw>`_ 撰寫，採用
-`創用 CC 姓名標示 3.0 Unported 授權條款 <https://creativecommons.org/licenses/by/3.0/>`_
-授權。
-
-本學習手冊以一個常用的教學研究範例，帶領學習者一步步操作，熟悉使用台師
-大問卷調查平台LimeSurvey的常用功能。全部研讀完畢約需兩小時。您也可以直
-接跳到您有興趣的章節，不需要依序閱讀。
-
-本學習手冊有
-`線上版學習手冊 <http://limesurvey.iro.ntnu.edu.tw/learning/>`_
-，也提供雙面印刷的
-`PDF版學習手冊 <http://limesurvey.iro.ntnu.edu.tw/learning/learning-limesurvey.pdf>`_
-，及適合手機平板閱讀的
-`EPUB學習手冊電子書 <http://limesurvey.iro.ntnu.edu.tw/learning/learning-limesurvey.epub>`_
-可供下載，並有
-`填答者名單CSV檔範例 <http://limesurvey.iro.ntnu.edu.tw/learning/participants-example.csv>`_
-可下載參考，亦歡迎下載參閱
-`學習手冊的Sphinx/reStructuredText原始檔 <http://limesurvey.iro.ntnu.edu.tw/learning/learning-limesurvey-2.2.zip>`_
-。台師大問卷調查平台上，有
-`本學習手冊上的範例問卷 <http://limesurvey.iro.ntnu.edu.tw/index.php/161873>`_
-，歡迎參閱。
-
-更多LimeSurvey的進階功能，請參閱
-`LimeSurvey官方線上說明 <https://manual.limesurvey.org/LimeSurvey_Manual>`_ 。
-
-
-.. toctree::
-    :caption: 目錄
-    :maxdepth: 3
-
-    01-intro
-    02-enter
-    03-create
-    04-run
-    05-result
-
-.. |copy| unicode:: 0xA9 .. copyright sign
-
-
-.. only:: html
-
-	.. toctree::
-		:caption: 附錄
-		
-		apx-01-copy
-		apx-02-ab-testing
-	
-    索引
-    ====
-    
-    * :ref:`genindex`
-    * :ref:`search`

learning-limesurvey.tex.patch

@@ -1,31 +0,0 @@
-diff -r -u a/_build/latex/learning-limesurvey.tex b/_build/latex/learning-limesurvey.tex
---- a/_build/latex/learning-limesurvey.tex	2017-11-22 10:38:01.965578637 +0800
-+++ b/_build/latex/learning-limesurvey.tex	2017-11-22 10:39:03.497580780 +0800
-@@ -41,7 +41,7 @@
- \release{2.2}
- \author{楊士青}
- \newcommand{\sphinxlogo}{}
--\renewcommand{\releasename}{釋出}
-+\renewcommand{\releasename}{版本}
- \makeindex
- 
- \makeatletter
-@@ -148,7 +148,9 @@
- 
- \begin{document}
- 
-+\title{\huge 台師大問卷調查平台LimeSurvey學習手冊}
- \maketitle
-+\title{台師大問卷調查平台LimeSurvey學習手冊}
- \tableofcontents
- \phantomsection\label{index::doc}
- 
-@@ -200,7 +202,7 @@
- 
- \begin{threeparttable}
- \capstart\caption{問卷調查平台比較}\label{01-intro:id5}
--\noindent\begin{tabulary}{\linewidth}{|L|L|L|L|L|L|}
-+\noindent\begin{tabulary}{\linewidth}{|m{0.14\linewidth}|m{0.14\linewidth}|m{0.14\linewidth}|m{0.14\linewidth}|m{0.14\linewidth}|m{0.14\linewidth}|}
- \hline
- \textsf{\relax \unskip}\relax &\textsf{\relax 
- LimeSurvey

make.bat

@@ -1,64 +1,18 @@
 @ECHO OFF
 
+pushd %~dp0
+
 REM Command file for Sphinx documentation
 
 if "%SPHINXBUILD%" == "" (
 	set SPHINXBUILD=sphinx-build
 )
-set BUILDDIR=_build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
+set SOURCEDIR=source
+set BUILDDIR=build
 
 if "%1" == "" goto help
 
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  epub3      to make an epub3
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  xml        to make Docutils-native XML files
-	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	echo.  coverage   to run coverage check of the documentation if enabled
-	echo.  dummy      to check syntax errors of document sources
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-
-REM Check if sphinx-build is available and fallback to Python version if any
-%SPHINXBUILD% 1>NUL 2>NUL
-if errorlevel 9009 goto sphinx_python
-goto sphinx_ok
-
-:sphinx_python
-
-set SPHINXBUILD=python -m sphinx.__init__
-%SPHINXBUILD% 2> nul
+%SPHINXBUILD% >NUL 2>NUL
 if errorlevel 9009 (
 	echo.
 	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
@@ -71,211 +25,11 @@ if errorlevel 9009 (
 	exit /b 1
 )
 
-:sphinx_ok
-
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
 goto end
-)
 
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\LimeSurvey.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\LimeSurvey.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "epub3" (
-	%SPHINXBUILD% -b epub3 %ALLSPHINXOPTS% %BUILDDIR%/epub3
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub3 file is in %BUILDDIR%/epub3.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdf" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdfja" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf-ja
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-if "%1" == "coverage" (
-	%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of coverage in the sources finished, look at the ^
-results in %BUILDDIR%/coverage/python.txt.
-	goto end
-)
-
-if "%1" == "xml" (
-	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The XML files are in %BUILDDIR%/xml.
-	goto end
-)
-
-if "%1" == "pseudoxml" (
-	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
-	goto end
-)
-
-if "%1" == "dummy" (
-	%SPHINXBUILD% -b dummy %ALLSPHINXOPTS% %BUILDDIR%/dummy
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. Dummy builder generates no files.
-	goto end
-)
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
 
 :end
+popd

participants-example.csv

@@ -1,101 +0,0 @@
-firstname,lastname,email,token
-姜,馨文,b199356726@example.com,B199356726
-胡,克人,a193244511@example.com,A193244511
-陳,彥儒,c298114432@example.com,C298114432
-鄭,幸年,a195796303@example.com,A195796303
-吳,峻豪,a298838551@example.com,A298838551
-徐,伯胤,c197082135@example.com,C197082135
-林,珍瑋,d197531885@example.com,D197531885
-張,怡君,e192748470@example.com,E192748470
-卓,淑婷,c193386409@example.com,C193386409
-黃,姿愛,f194252889@example.com,F194252889
-鐘,秀青,e194020868@example.com,E194020868
-張,志彬,f198995527@example.com,F198995527
-陳,毓希,g294601054@example.com,G294601054
-王,鳳花,a293885934@example.com,A293885934
-呂,登珠,c193399522@example.com,C193399522
-屠,允珮,g299857574@example.com,G299857574
-簡,佩玲,c193950150@example.com,C193950150
-林,明茂,c197930421@example.com,C197930421
-陳,宏芸,d198841228@example.com,D198841228
-葉,蓉蓁,b191782831@example.com,B191782831
-夏,夙倫,e197865172@example.com,E197865172
-林,家瑋,g199982007@example.com,G199982007
-韓,佩蓉,g291831694@example.com,G291831694
-張,國偉,c196129586@example.com,C196129586
-林,佳容,b199169134@example.com,B199169134
-陳,怡如,b191321918@example.com,B191321918
-葉,裕哲,a296654753@example.com,A296654753
-楊,吟苓,f299376975@example.com,F299376975
-張,建宇,g197340592@example.com,G197340592
-陳,沛水,g192637625@example.com,G192637625
-駱,舒婷,c191920136@example.com,C191920136
-吳,香君,h297136500@example.com,H297136500
-錢,欣怡,e196988381@example.com,E196988381
-李,國華,a296068051@example.com,A296068051
-璩,以書,h192844489@example.com,H192844489
-童,家豪,g297285543@example.com,G297285543
-顏,懿珮,g297757928@example.com,G297757928
-禹,添旭,g198650971@example.com,G198650971
-陳,秀孜,f192401884@example.com,F192401884
-唐,雅婷,g197750963@example.com,G197750963
-時,芝信,a194868051@example.com,A194868051
-賴,俊豪,e293309871@example.com,E293309871
-李,怡宇,a295122501@example.com,A295122501
-詹,雅禾,b295191052@example.com,B295191052
-許,振瑋,b293102020@example.com,B293102020
-蘇,馨樂,d294844636@example.com,D294844636
-曾,鈺貞,b191260750@example.com,B191260750
-黃,政儒,d191469559@example.com,D191469559
-徐,莉雯,h295665428@example.com,H295665428
-蔡,友璇,h194462592@example.com,H194462592
-賈,冠勳,b195499391@example.com,B195499391
-吳,柏鈞,a199494417@example.com,A199494417
-林,季弘,a197391324@example.com,A197391324
-吳,昌蘭,g196228551@example.com,G196228551
-蔡,惠雯,e293086471@example.com,E293086471
-胥,樂城,a296759584@example.com,A296759584
-崔,淑貞,h199715169@example.com,H199715169
-李,依為,c295346245@example.com,C295346245
-林,惠仁,d296031093@example.com,D296031093
-張,協旺,c297809549@example.com,C297809549
-蔡,政宜,c295463394@example.com,C295463394
-彭,佑霖,h297406007@example.com,H297406007
-陳,立如,g197667776@example.com,G197667776
-潘,千合,d294164857@example.com,D294164857
-楊,雅友,d196468436@example.com,D196468436
-郭,韻儀,b195254650@example.com,B195254650
-於,秉虹,e199455094@example.com,E199455094
-周,茜意,h192719098@example.com,H192719098
-王,湖華,e194271543@example.com,E194271543
-張,健豪,d199888172@example.com,D199888172
-袁,育儒,e194630113@example.com,E194630113
-蔡,明卿,a193432379@example.com,A193432379
-林,潔亨,c297281345@example.com,C297281345
-徐,恆茜,d299644010@example.com,D299644010
-李,姿盛,b192920737@example.com,B192920737
-李,美惠,e293856053@example.com,E293856053
-葉,忠伸,e299368276@example.com,E299368276
-張,康青,h299498745@example.com,H299498745
-林,宗穎,c292479587@example.com,C292479587
-王,心州,e197906794@example.com,E197906794
-藍,宗翰,e194423298@example.com,E194423298
-楊,俊凱,c291883658@example.com,C291883658
-劉,美正,g295924190@example.com,G295924190
-陳,正雲,a298262486@example.com,A298262486
-朱,英傑,a199611249@example.com,A199611249
-陳,仁豪,c196267885@example.com,C196267885
-陳,俊安,h293527818@example.com,H293527818
-楊,依婷,g294577062@example.com,G294577062
-曹,智翔,b195992299@example.com,B195992299
-黃,淑友,a196690999@example.com,A196690999
-李,佳珊,c294963564@example.com,C294963564
-林,良霞,b297114660@example.com,B297114660
-陳,弘愛,d199188846@example.com,D199188846
-林,立琦,c192960152@example.com,C192960152
-王,玟士,b196395945@example.com,B196395945
-林,家銘,e297338949@example.com,E297338949
-王,雅芬,e298249110@example.com,E298249110
-賴,淑萍,c296441409@example.com,C296441409
-鄭,雪珠,d294349261@example.com,D294349261
-周,家祥,c194001549@example.com,C194001549

source/01-intro.rst

@@ -5,13 +5,13 @@ LimeSurvey簡介
 LimeSurvey簡介
 --------------
 
-台師大校園公用問卷調查平台，由校務研究辦公室採用開源自由軟體
-`LimeSurvey <https://www.limesurvey.org/>`_ 建置，供全校教職員生使用，
-便利全校師生快速建立專業的問卷。
+台師大校園公用問卷調查平台，由校務研究辦公室採用開源自由軟體 LimeSurvey_ 建置
+，供全校教職員生使用，便利全校師生快速建立專業的問卷。
 
-LimeSurvey自2003年初版至今，歷經14年82個語言的全球使用者開發使用，安全
-穩定，是最受歡迎的開源問卷調查系統。
+LimeSurvey自2003年初版至今，歷經14年82個語言的全球使用者開發使用，安全穩定，
+是最受歡迎的開源問卷調查系統。
 
+.. _LimeSurvey: https://www.limesurvey.org
 
 與其他問卷調查平台比較
 ----------------------

source/03-02-03-gender.rst

@@ -33,7 +33,7 @@
     問題的編號
 
 在「問題」欄位，填上實際的問卷題目。第一題我們先問填答者的性別，請填
-上「1.請選擇您的性別」。
+上「1.請選擇您的性別。」。
 
 .. figure:: images/03-02-03-gender-03-02.png
     :alt: 問題的內容

source/03-02-04-date.rst

@@ -3,9 +3,10 @@
 
 接著要問填答者的出生年月日。
 
-在新增問卷問題的編輯頁面上，編號填上「q02」，問題填上「2.請選擇您的出
-生年月日。」題型往下拉選「 :index:`日期時間 <題型; 日期>` 」，開啟
-「必須回應」，然後按「儲存並離開」。
+在新增問卷問題的編輯頁面上，編號填上「q02」，問題填上
+「2.請選擇您的出生年月日。」題型往下拉選
+「 :index:`日期時間 <題型; 日期>` 」，開啟「必須回應」，然後按
+「儲存並離開」。
 
 .. figure:: images/03-02-04-date-01.png
     :alt: 問題二：日期題型

source/03-02-05-single.rst

@@ -11,8 +11,9 @@
 大九。我們提供大一到大四，四個選項，並且多一個「其他」選項讓使用者自己
 填寫。
 
-在新增問卷問題的編輯頁面上，編號填上「q03」，問題填上「3.請選擇您的年
-級。」題型往下拉選「列表（單選）」，開啟「選項『其他』」和「必須回應」。
+在新增問卷問題的編輯頁面上，編號填上「q03」，問題填上
+「3.請選擇您的年級。」題型往下拉選「列表（單選）」，開啟
+「選項『其他』」和「必須回應」。
 
 .. figure:: images/03-02-05-single-01.png
     :alt: 問題三：單選題型
@@ -20,8 +21,8 @@
 
     問題三：單選題型
 
-按進階設定「Advanced settings」進去，往下拉找到「邏輯」下的「『其他：』
-必填的評論：」點按開啟。答題選擇其他時，必須填上幾年級。
+按進階設定「Advanced settings」進去，往下拉找到「邏輯」下的
+「『其他：』必填的評論」點按開啟。答題選擇其他時，必須填上幾年級。
 
 按右上角「儲存並關閉」。
 
@@ -37,9 +38,10 @@
 
     單選題型的『其他：』必填的評論
 
-建好問題後，會提醒你還沒輸入選項：「You need to add answer options to
-this question」。可以直接點選「You need to add answer options to this
-question」進入，也可由上方「編輯答案選項」進入，輸入選項。
+建好問題後，會提醒你還沒輸入選項：
+「You need to add answer options to this question」。可以直接點選
+「You need to add answer options to this question」進入，也可由上方
+「編輯答案選項」進入，輸入選項。
 
 .. figure:: images/03-02-05-single-04.png
     :alt: 建好單選題型後，輸入選項

source/03-03-01-number.rst

@@ -13,9 +13,9 @@
 我們也可以用0–24共25個選項的單選欄位。不過有人會有3.5、2.25小時等等非
 整數，所以我們還是使用數值欄位。
 
-在新增問卷問題的編輯頁面上，編號填上「q04」，問題填上「4.請問您每天放
-學後唸書幾個小時？」題型往下拉選「數值輸入」，題組選「貳、課後評量」，
-開啟「必須回應」，然後按下「Advanced settings」。
+在新增問卷問題的編輯頁面上，編號填上「q04」，問題填上
+「4.請問您每天放學後唸書幾個小時？」題型往下拉選「數值輸入」，題組選
+「貳、課後評量」，開啟「必須回應」，然後按下「Advanced settings」。
 
 .. figure:: images/03-03-01-number-01.png
     :alt: 問題四：數值題型
@@ -25,7 +25,7 @@
 
 接著往下拉到「輸入」。每天最多24小時，最少0小時，為避免填錯，可以限制
 輸入值的範圍。請在最小值填上0，最大值填上24。因為可能會有3.5小時，不開
-啟「只能整數」。最後按「儲存並關閉」。
+啟「只能整數」。最後回到右上角按「儲存並關閉」。
 
 .. figure:: images/03-03-01-number-02.png
     :alt: 限制數值填答範圍

source/03-03-02-multi-numbers.rst

@@ -9,9 +9,9 @@
 
 每天的上網時間最少0小時，最多24小時，同樣可以容許小數點。
 
-在新增問卷問題的編輯頁面上，編號填上「q05」，問題填上「5.過去七天每天
-上網幾小時？」題型往下拉選「多重數值輸入」，題組選「貳、課後評量」，
-開啟「必須回應」，然後按下「Advanced settings」。
+在新增問卷問題的編輯頁面上，編號填上「q05」，問題填上
+「5.過去七天每天上網幾小時？」題型往下拉選「多重數值輸入」，題組選
+「貳、課後評量」，開啟「必須回應」，然後按下「Advanced settings」。
 
 .. figure:: images/03-03-02-multi-numbers-01.png
     :alt: 問題五：多重數值題型
@@ -28,9 +28,10 @@
 
     限制數值填答範圍
 
-建好問題後，會提醒你還沒輸入子問題：「You need to add subquestions to
-this question」。可以直接點選「You need to add subquestions to this
-question」進入，也可由上方「編輯子問題」進入，輸入子問題。
+建好問題後，會提醒你還沒輸入子問題：
+「You need to add subquestions to this question」。可以直接點選
+「You need to add subquestions to this question」進入，也可由上方
+「編輯子問題」進入，輸入子問題。
 
 .. figure:: images/03-03-02-multi-numbers-03.png
     :alt: 建好多重數值題型後，輸入子問題

source/03-03-03-likert.rst

@@ -4,14 +4,15 @@
 接下來我們想瞭解學生對課程各方面的滿意度。
 
 :index:`李克特氏五點量表 (Likert scale) <題型; 李克特氏五點量表>` 是常
-見的問題型式，常用於態度問卷、滿意度調查等等。
+見的問題型式，常用於態度問卷、滿意度調查、指標設計…等等。
 
-因為選項上的文字無法調整，所以我們在題目上寫清楚「（1表最不滿意，5表最
-滿意）」。
+因為選項上的文字無法調整，所以我們在題目上寫清楚
+「（1表最不滿意，5表最滿意）」。
 
-在新增問卷問題的編輯頁面上，編號填上「q06」，問題填上「6.課程滿意度
-（1表最不滿意，5表最滿意）：」題型往下拉選「陣列（五分選擇）」，題組選
-「貳、課後評量」，開啟「必須回應」，然後按「儲存並關閉」。
+在新增問卷問題的編輯頁面上，編號填上「q06」，問題填上
+「6.課程滿意度（1表最不滿意，5表最滿意）：」題型往下拉選
+「陣列（五分選擇）」，題組選「貳、課後評量」，開啟「必須回應」，然後按
+「儲存並關閉」。
 
 .. figure:: images/03-03-03-likert-01.png
     :alt: 問題六：李克特氏五點量表題型

source/03-03-04-order.rst

@@ -6,9 +6,9 @@
 :index:`排序欄位 <題型; 排序>` 有很多種用途，可以用來詢問態度喜好的順
 序，也可用在社會網路分析中，詢問人際親疏的順序。
 
-在新增問卷問題的編輯頁面上，編號填上「q07」，問題填上「7.請依序選擇您
-喜歡的單元。」題型往下拉選「排序」，題組選「貳、課後評量」，開啟「必須
-回應」，然後按「儲存並關閉」。
+在新增問卷問題的編輯頁面上，編號填上「q07」，問題填上
+「7.請依序選擇您喜歡的單元。」題型往下拉選「排序」，題組選
+「貳、課後評量」，開啟「必須回應」，然後按「儲存並關閉」。
 
 .. figure:: images/03-03-04-order-01.png
     :alt: 問題七：排序題型

source/03-04-01-yesno.rst

@@ -0,0 +1,21 @@
+第八個問題：是／否
+##################
+
+第八個問題，要詢問答題者是否是本校學生。我們會用到
+:index:`「是／否」題型 <題型; 是／否>`。
+
+在新增問卷問題的編輯頁面上，編號填上「q08」，問題填上
+「8.您是不是台師大學生？」題型往下拉選「是／否」，題組選「參、其他」，
+開啟「必須回應」，然後按「儲存並關閉」。
+
+.. figure:: images/03-04-01-yesno-01.png
+    :alt: 問題八：是否題型
+    :scale: 60%
+
+    問題八：是否題型
+
+.. figure:: images/03-04-01-yesno-02.png
+    :alt: 是否題型預覽
+    :scale: 60%
+
+    是否題型預覽

source/03-04-02-id.rst

@@ -3,9 +3,10 @@
 
 如果是台師大的學生，請同學填上學號。
 
-在新增問卷問題的編輯頁面上，編號填上「q09」，問題填上「9.請填上您的學
-號。」題型往下拉選「 :index:`自由短文 <題型; 單行文字>` 」，題組選
-「參、其他」，開啟「必須回應」，然後按「儲存並關閉」。
+在新增問卷問題的編輯頁面上，編號填上「q09」，問題填上
+「9.請填上您的學號。」題型往下拉選
+「 :index:`自由短文 <題型; 單行文字>` 」，題組選「參、其他」，開啟
+「必須回應」，然後按「儲存並關閉」。
 
 .. figure:: images/03-04-02-id-01.png
     :alt: 問題九：本校生的學號
@@ -21,8 +22,8 @@
 
     按上方「Set conditions」設定問題條件。
 
-接著往下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題「q08: 8.您
-是不是台師大學生？」答案選「Y(是)」，然後按下「增加條件」。
+接著往下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題
+「q08: 8.您是不是台師大學生？」答案選「Y(是)」，然後按下「增加條件」。
 
 .. figure:: images/03-04-02-id-03.png
     :alt: 加上問題的條件

source/03-04-03-school.rst

@@ -3,9 +3,10 @@
 
 如果是外校生，請同學填上學校和科系。
 
-在新增問卷問題的編輯頁面上，編號填上「q10」，問題填上「10.請填上您就讀
-的學校。」題型往下拉選「 :index:`自由短文 <題型; 單行文字>` 」，題組選
-「參、其他」，開啟「必須回應」，然後按「儲存並關閉」。
+在新增問卷問題的編輯頁面上，編號填上「q10」，問題填上
+「10.請填上您就讀的學校。」題型往下拉選
+「 :index:`自由短文 <題型; 單行文字>` 」，題組選「參、其他」，開啟
+「必須回應」，然後按「儲存並關閉」。
 
 .. figure:: images/03-04-03-school-01.png
     :alt: 問題十：外校生的就讀學校
@@ -14,8 +15,8 @@
     問題十：外校生的就讀學校
 
 接著按上方「Set conditions」設定問題的條件。在設定問題條件的頁面上，往
-下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題「q08: 8.您是不是
-台師大學生？」答案選「N(否)」，然後按下「增加條件」。
+下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題
+「q08: 8.您是不是台師大學生？」答案選「N(否)」，然後按下「增加條件」。
 
 .. figure:: images/03-04-03-school-02.png
     :alt: 加上外校生就讀學校問題的條件
@@ -35,9 +36,10 @@
 
     設好的外校生就讀學校問題條件
 
-再一次，在新增問卷問題的編輯頁面上，編號填上「q11」，問題填上「11.請填
-上您就讀的科系。」題型往下拉選「 :index:`自由短文 <題型; 單行文字>` 」
-，題組選「參、其他」，開啟「必須回應」，然後按「儲存並關閉」。
+再一次，在新增問卷問題的編輯頁面上，編號填上「q11」，問題填上
+「11.請填上您就讀的科系。」題型往下拉選
+「 :index:`自由短文 <題型; 單行文字>` 」，題組選「參、其他」，開啟
+「必須回應」，然後按「儲存並關閉」。
 
 .. figure:: images/03-04-03-school-04.png
     :alt: 問題十一：外校生的就讀科系
@@ -46,8 +48,8 @@
     問題十一：外校生的就讀科系
 
 接著按上方「Set conditions」設定問題的條件。在設定問題條件的頁面上，往
-下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題「q08: 8.您是不是
-台師大學生？」答案選「N(否)」，然後按下「增加條件」。
+下拉到頁面下方「增加條件」的地方，問題選剛剛的第八題
+「q08: 8.您是不是台師大學生？」答案選「N(否)」，然後按下「增加條件」。
 
 .. figure:: images/03-04-03-school-05.png
     :alt: 加上外校生就讀科系問題的條件

source/03-04-04-comment.rst

@@ -4,11 +4,11 @@
 問卷最後我們請填答者給我們課程的建議，告訴我們問卷沒有問到的感想。
 
 課程建議題型使用「 :index:`自由長答 <題型; 多行文字>` 」。填答者不一定
-非給建議不可，不需要開啟「不須回應」。自由長答的內文可以做質性分析。
+非給建議不可，不是必答。自由長答的內文可以做質性分析。
 
-在新增問卷問題的編輯頁面上，編號填上「q12」，問題填上「12.您若有對課程
-的任何建議，請告訴我們。」題型往下拉選「自由長答」，題組選「參、其他」
-，不要開啟「必須回應」，然後按「儲存並關閉」。
+在新增問卷問題的編輯頁面上，編號填上「q12」，問題填上
+「12.您若有對課程的任何建議，請告訴我們。」題型往下拉選「自由長答」，
+題組選「參、其他」，不要開啟「必須回應」，然後按「儲存並關閉」。
 
 .. figure:: images/03-04-04-comment.png
     :alt: 問題十二：自由長答

source/04-02-open.rst

@@ -31,7 +31,8 @@
 
     選擇開放式問卷
 
-問卷頁面中間的Survey URL，即為問卷網址。將問卷網址複製下來散發（Email、Facebook、LINE或紙本），連上網址的人，即可填答。
+問卷頁面中間的Survey URL，即為問卷網址。將問卷網址複製下來散發
+（Email、Facebook、LINE或紙本），連上網址的人，即可填答。
 
 .. figure:: images/04-02-open-02.png
     :alt: 開放式問卷的網址

source/04-03-01-participants.rst

@@ -18,7 +18,7 @@
 
     點選「建立」加上新的填答者
 
-點「加入參與者」，就可以一筆一筆輸入填答者資料。
+選「加入參與者」，就可以一筆一筆輸入填答者資料。
 
 .. figure:: images/04-03-01-participants-03.png
     :alt: 選「建立」「加入參與者」輸入填答者資料
@@ -26,9 +26,10 @@
 
     選「建立」「加入參與者」輸入填答者資料
 
-填上First name（姓）、Last name（名）和Email郵件信箱，按右上角「儲存」
+填上First name（名）、Last name（姓）和Email郵件信箱，按右上角「儲存」
 即可。Token（ :index:`邀請碼 <邀請碼; 填寫>` ）可留白，系統自動產生亂
-數邀請碼。也可以使用身份證字號、學號等對方容易記憶的邀請碼，只要不重複即可。
+數邀請碼。也可以使用身份證字號、學號等對方容易記憶的邀請碼，
+只要不重複即可。
 
 .. figure:: images/04-03-01-participants-04.png
     :alt: 輸入填答者資料
@@ -36,7 +37,7 @@
 
     輸入填答者資料
 
-點「CSV檔案」，可從CSV檔整批匯入填答者名單。
+選「CSV檔案」，可從CSV檔整批匯入填答者名單。
 
 .. figure:: images/04-03-01-participants-05.png
     :alt: 選「建立」「CSV檔案」從CSV檔匯入填答者名單
@@ -46,8 +47,8 @@
 
 CSV檔欄位如下：
 
-- firstname（姓）
-- lastname（名）
+- firstname（名）
+- lastname（姓）
 - email（郵件信箱）
 - （選填）token（邀請碼）
 
@@ -57,10 +58,12 @@ CSV檔欄位如下：
 
     選「建立」「CSV檔案」從CSV檔匯入填答者名單
 
-可以參閱 `填答者CSV檔的範例 <http://limesurvey.iro.ntnu.edu.tw/learning/participants-example.csv>`_ 。
+可以參閱 `填答者CSV檔的範例`_ 。
 
 .. figure:: images/04-03-01-participants-07.png
     :alt: 填答者CSV檔範例
     :scale: 60%
 
     填答者CSV檔範例
+
+.. _填答者CSV檔的範例: https://limesurvey.imacat.idv.tw/learning/v2/participants-example.csv

source/04-03-closed.rst

@@ -12,8 +12,8 @@
 封閉式問卷需要額外設定填答者名單。名單上的填答者，需有
 :index:`邀請碼 <邀請碼>` 才可填答。每個填答者的邀請碼各自不同。
 
-啟用問卷後，詢問是否要封閉式問卷時，按左下角的「切換至封閉問卷模式」即
-可。
+啟用問卷後，詢問是否要封閉式問卷時，按左下角的「切換至封閉問卷模式」
+即可。
 
 .. figure:: images/04-03-close-01.png
     :alt: 選擇封閉式問卷
@@ -21,14 +21,14 @@
 
     選擇封閉式問卷
 
-詢問是否要建立填答者名單表時，請點選左下角「Initialise participant
-table」。
+詢問是否要建立空白填答者名單表時，請點選左下角
+「Initialise participant table」。
 
 .. figure:: images/04-03-close-02.png
-    :alt: 初始化填答者名單
+    :alt: 建立空白填答者名單表
     :scale: 60%
 
-    初始化填答者名單
+    建立空白填答者名單表
 
 
 .. toctree::

source/conf.py

@@ -0,0 +1,96 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = '台師大問卷調查平台LimeSurvey學習手冊'
+copyright = '2017-2021, 楊士青, 2017-2018, 國立臺灣師範大學'
+author = '楊士青, 國立臺灣師範大學'
+
+# The full version, including alpha/beta/rc tags
+release = '2.5'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = 'zh_TW'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'alabaster'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+
+##################
+# Local settings #
+##################
+version = release
+master_doc = 'index'
+target_name = 'learning-limesurvey'
+
+latex_elements = {
+     'preamble': """
+\\setCJKmainfont{AR PL UMing TW}
+\\setCJKsansfont{AR PL UKai TW}
+""",
+}
+
+latex_documents = [
+    (master_doc, F'{target_name}.tex', project,
+     author, 'manual'),
+]
+latex_appendices = ['apx-01-copy']
+
+man_pages = [
+    (master_doc, target_name, project,
+     [author], 1)
+]
+
+texinfo_documents = [
+    (master_doc, target_name, project,
+     author, 'Learning LimeSurvey', project,
+     'Miscellaneous'),
+]
+
+epub_basename = target_name