Revised the reStructuredText to be more readable.
This commit is contained in:
依瑪貓
parent
af35b16427
commit
0089c58df7
35
README.rst
35
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 <https://github.com/imacat/learning-limesurvey>`_.
|
||||
**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 <https://www.limesurvey.org/>`_ tutorial. It features `project-based learning (PBL) <https://en.wikipedia.org/wiki/Project-based_learning>`_: By creating a simple yet practical survey, it walks through the frequently-used features of LimeSurvey. It is written in `reStructuredText <https://docutils.sourceforge.io/rst.html>`_ with `Sphinx <https://www.sphinx-doc.org/>`_ 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 <imacat@ntnu.edu.tw>`_. Read the `tutorial (Chinese) <https://limesurvey.imacat.idv.tw/learning/v2/>`_ online, or check the `GitHub source project <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::
|
||||
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 <http://creativecommons.org/licenses/by/4.0/>`_.
|
||||
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
|
||||
|
||||
@ -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
|
||||
|
||||
與其他問卷調查平台比較
|
||||
----------------------
|
||||
|
||||
@ -58,10 +58,12 @@ CSV檔欄位如下：
|
||||
|
||||
選「建立」「CSV檔案」從CSV檔匯入填答者名單
|
||||
|
||||
可以參閱 `填答者CSV檔的範例 <https://limesurvey.imacat.idv.tw/learning/v2/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
|
||||
|
||||
@ -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
|
||||
|
||||
@ -6,40 +6,38 @@
|
||||
台師大問卷調查平台LimeSurvey學習手冊
|
||||
====================================
|
||||
|
||||
版權所有 |copy| 2017-2020 楊士青， 2017-2018 國立臺灣師範大學。。
|
||||
版權所有 |copy| 2017-2021 楊士青， 2017-2018 國立臺灣師範大學。。
|
||||
|
||||
「台師大問卷調查平台LimeSurvey學習手冊」由
|
||||
`楊士青 <imacat@ntnu.edu.tw>`_ 撰寫，採用
|
||||
`創用 CC 姓名標示 4.0 授權條款 <https://creativecommons.org/licenses/by/4.0/>`_
|
||||
授權。
|
||||
「台師大問卷調查平台LimeSurvey學習手冊」由 `楊士青`_ 撰寫，採用
|
||||
`創用 CC 姓名標示 4.0 授權條款`_ 授權。
|
||||
|
||||
**請注意：** 這是適用於舊版LimeSurvey 2的舊版學習手冊。
|
||||
最新版LimeSurvey 4，請參閱
|
||||
`新版LimeSurvey 4學習手冊 <https://limesurvey.imacat.idv.tw/learning/>`_ 。
|
||||
**請注意：** 這是適用於舊版LimeSurvey 2的舊版學習手冊。最新版LimeSurvey 4，
|
||||
請參閱 `新版LimeSurvey 4學習手冊`_ 。
|
||||
|
||||
本學習手冊以一個常用的教學研究範例，帶領學習者一步步操作，熟悉使用台師
|
||||
大問卷調查平台LimeSurvey的常用功能。全部研讀完畢約需兩小時。您也可以直
|
||||
接跳到您有興趣的章節，不需要依序閱讀。
|
||||
|
||||
本學習手冊有
|
||||
`線上版學習手冊 <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/index.php/161873>`_
|
||||
，歡迎參閱。
|
||||
本學習手冊有 `線上版學習手冊`_ ，也提供雙面印刷的 `PDF版學習手冊`_ ，及適合手
|
||||
機平板閱讀的 `EPUB學習手冊電子書`_ 可供下載，並有 `填答者名單CSV檔範例`_ 可下
|
||||
載參考。本學習手冊以 `Sphinx/reStructuredText`_ 撰寫，歡迎參閱
|
||||
`GitHub上的開源專案`_ ，或下載 `原始檔`_ 。台師大問卷調查平台上，有
|
||||
`本學習手冊上的範例問卷`_ ，歡迎參閱。
|
||||
|
||||
更多LimeSurvey的進階功能，請參閱
|
||||
`LimeSurvey官方線上說明 <https://manual.limesurvey.org/LimeSurvey_Manual>`_ 。
|
||||
更多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::
|
||||
|
||||
Loading…
Reference in New Issue
Block a user