diff --git a/README.rst b/README.rst index 5d7f14f..0709806 100644 --- a/README.rst +++ b/README.rst @@ -1,16 +1,34 @@ Learning LimeSurvey — The Survey Service in National Taiwan Normal University ============================================================================== -**WARNING**: This is for LimeSurvey 2 and is outdated. Please check the `current version `_. +**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 (PBL) `_: 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 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 -*«Learning LimeSurvey — The Survey Service in National Taiwan Normal University»* is written by `imacat `_. Read the `tutorial (Chinese) `_ online, or check the `GitHub source project `_. 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:: +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 @@ -26,7 +44,8 @@ After installation, run:: # make help -to see the available conversion commands. For example, to generate HTML, PDF, ePUB, manpage, and Texinfo documents respectively:: +to see the available conversion commands. For example, to generate +HTML, PDF, ePUB, manpage, and Texinfo documents respectively:: # make html # make latexpdf @@ -34,6 +53,10 @@ to see the available conversion commands. For example, to generate HTML, PDF, e # make man # make texinfo -Copyright |copy| 2017-2020 imacat, 2017-2018 National Taiwan Normal University. This work is licensed under a `Creative Commons Attribution 4.0 International License `_. +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 diff --git a/source/01-intro.rst b/source/01-intro.rst index 4791d37..ca8fbc9 100644 --- a/source/01-intro.rst +++ b/source/01-intro.rst @@ -5,13 +5,13 @@ LimeSurvey簡介 LimeSurvey簡介 -------------- -台師大校園公用問卷調查平台，由校務研究辦公室採用開源自由軟體 -`LimeSurvey `_ 建置，供全校教職員生使用， -便利全校師生快速建立專業的問卷。 +台師大校園公用問卷調查平台，由校務研究辦公室採用開源自由軟體 LimeSurvey_ 建置 +，供全校教職員生使用，便利全校師生快速建立專業的問卷。 -LimeSurvey自2003年初版至今，歷經14年82個語言的全球使用者開發使用，安全 -穩定，是最受歡迎的開源問卷調查系統。 +LimeSurvey自2003年初版至今，歷經14年82個語言的全球使用者開發使用，安全穩定， +是最受歡迎的開源問卷調查系統。 +.. _LimeSurvey: https://www.limesurvey.org 與其他問卷調查平台比較 ---------------------- diff --git a/source/04-03-01-participants.rst b/source/04-03-01-participants.rst index b2fb055..e7ccc7c 100644 --- a/source/04-03-01-participants.rst +++ b/source/04-03-01-participants.rst @@ -58,10 +58,12 @@ CSV檔欄位如下： 選「建立」「CSV檔案」從CSV檔匯入填答者名單 -可以參閱 `填答者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 diff --git a/source/conf.py b/source/conf.py index 44faf17..ff06f2b 100644 --- a/source/conf.py +++ b/source/conf.py @@ -18,7 +18,7 @@ # -- Project information ----------------------------------------------------- project = '台師大問卷調查平台LimeSurvey學習手冊' -copyright = '2017-2020, 楊士青, 2017-2018, 國立臺灣師範大學' +copyright = '2017-2021, 楊士青, 2017-2018, 國立臺灣師範大學' author = '楊士青, 國立臺灣師範大學' # The full version, including alpha/beta/rc tags diff --git a/source/index.rst b/source/index.rst index 6f70952..f2b6029 100644 --- a/source/index.rst +++ b/source/index.rst @@ -6,40 +6,38 @@ 台師大問卷調查平台LimeSurvey學習手冊 ==================================== -版權所有 |copy| 2017-2020 楊士青， 2017-2018 國立臺灣師範大學。。 +版權所有 |copy| 2017-2021 楊士青， 2017-2018 國立臺灣師範大學。。 -「台師大問卷調查平台LimeSurvey學習手冊」由 -`楊士青 `_ 撰寫，採用 -`創用 CC 姓名標示 4.0 授權條款 `_ -授權。 +「台師大問卷調查平台LimeSurvey學習手冊」由 `楊士青`_ 撰寫，採用 +`創用 CC 姓名標示 4.0 授權條款`_ 授權。 -**請注意：** 這是適用於舊版LimeSurvey 2的舊版學習手冊。 -最新版LimeSurvey 4，請參閱 -`新版LimeSurvey 4學習手冊 `_ 。 +**請注意：** 這是適用於舊版LimeSurvey 2的舊版學習手冊。最新版LimeSurvey 4， +請參閱 `新版LimeSurvey 4學習手冊`_ 。 本學習手冊以一個常用的教學研究範例，帶領學習者一步步操作，熟悉使用台師 大問卷調查平台LimeSurvey的常用功能。全部研讀完畢約需兩小時。您也可以直 接跳到您有興趣的章節，不需要依序閱讀。 -本學習手冊有 -`線上版學習手冊 `_ -，也提供雙面印刷的 -`PDF版學習手冊 `_ -，及適合手機平板閱讀的 -`EPUB學習手冊電子書 `_ -可供下載，並有 -`填答者名單CSV檔範例 `_ -可下載參考。本學習手冊以 -`Sphinx/reStructuredText `_ -撰寫，歡迎參閱 -`GitHub上的開源專案 `_ ，或下載 -`原始檔 `_ -。台師大問卷調查平台上，有 -`本學習手冊上的範例問卷 `_ -，歡迎參閱。 +本學習手冊有 `線上版學習手冊`_ ，也提供雙面印刷的 `PDF版學習手冊`_ ，及適合手 +機平板閱讀的 `EPUB學習手冊電子書`_ 可供下載，並有 `填答者名單CSV檔範例`_ 可下 +載參考。本學習手冊以 `Sphinx/reStructuredText`_ 撰寫，歡迎參閱 +`GitHub上的開源專案`_ ，或下載 `原始檔`_ 。台師大問卷調查平台上，有 +`本學習手冊上的範例問卷`_ ，歡迎參閱。 -更多LimeSurvey的進階功能，請參閱 -`LimeSurvey官方線上說明 `_ 。 +更多LimeSurvey的進階功能，請參閱 `LimeSurvey官方線上說明`_ 。 + +.. _楊士青: imacat@ntnu.edu.tw +.. _創用 CC 姓名標示 4.0 授權條款: https://creativecommons.org/licenses/by/4.0/ +.. _新版LimeSurvey 4學習手冊: https://limesurvey.imacat.idv.tw/learning/ +.. _線上版學習手冊: https://limesurvey.imacat.idv.tw/learning/v2/ +.. _PDF版學習手冊: https://limesurvey.imacat.idv.tw/learning/v2/learning-limesurvey.pdf +.. _EPUB學習手冊電子書: https://limesurvey.imacat.idv.tw/learning/v2/learning-limesurvey.epub +.. _填答者名單CSV檔範例: https://limesurvey.imacat.idv.tw/learning/v2/participants-example.csv +.. _Sphinx/reStructuredText: https://www.sphinx-doc.org +.. _GitHub上的開源專案: https://github.com/imacat/learning-limesurvey +.. _原始檔: https://limesurvey.imacat.idv.tw/learning/v2/learning-limesurvey-2.4.zip +.. _本學習手冊上的範例問卷: https://limesurvey.imacat.idv.tw/161873 +.. _LimeSurvey官方線上說明: https://manual.limesurvey.org/LimeSurvey_Manual .. toctree::