diff --git a/README.rst b/README.rst index 945fae4..f500549 100644 --- a/README.rst +++ b/README.rst @@ -1,39 +1,39 @@ -台師大問卷調查平台LimeSurvey學習手冊 -==================================== +Learning LimeSurvey for the National Taiwan Normal University LimeSurvey Service +================================================================================ -版權所有 |copy| 2017-2020 楊士青, 2017-2018 國立臺灣師範大學。。 +**WARNING**: This is for LimeSurvey 2 and is outdated. Please check the `current version `_. -「台師大問卷調查平台LimeSurvey學習手冊」由 -`楊士青 `_ 撰寫,採用 -`創用 CC 姓名標示 4.0 授權條款 `_ -授權。 +*«Learning LimeSurvey for the National Taiwan Normal University LimeSurvey Service»* is a `LimeSurvey `_ tutorial written in Chinese. 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. -**請注意:** 這是適用於舊版LimeSurvey 2的舊版學習手冊。 -最新版LimeSurvey 4,請參閱 -`新版LimeSurvey 4學習手冊 `_ 。 +*«Learning LimeSurvey for the National Taiwan Normal University LimeSurvey Service»* is written by `imacat `_. Read the `tutorial (Chinese) `_ online, or check the `GitHub source project `_. -本學習手冊以一個常用的教學研究範例,帶領學習者一步步操作,熟悉使用台師 -大問卷調查平台LimeSurvey的常用功能。全部研讀完畢約需兩小時。您也可以直 -接跳到您有興趣的章節,不需要依序閱讀。 +HTML, PDF, and Other Formats +---------------------------- -本學習手冊有 -`線上版學習手冊 `_ -,也提供雙面印刷的 -`PDF版學習手冊 `_ -,及適合手機平板閱讀的 -`EPUB學習手冊電子書 `_ -可供下載,並有 -`填答者名單CSV檔範例 `_ -可下載參考。本學習手冊以 -`Sphinx/reStructuredText `_ -撰寫,歡迎參閱 -`GitHub上的開源專案 `_ ,或下載 -`原始檔 `_ -。台師大問卷調查平台上,有 -`本學習手冊上的範例問卷 `_ -,歡迎參閱。 +This tutorial can be converted into various formats. To do so, you need to install Sphinx first. On Debian/Ubuntu:: -更多LimeSurvey的進階功能,請參閱 -`LimeSurvey官方線上說明 `_ 。 + # 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-2020 imacat, 2017-2018 National Taiwan Normal University. This work is licensed under a `Creative Commons Attribution 4.0 International License `_. .. |copy| unicode:: 0xA9 .. copyright sign