Skip to content

Commit 56e1620

Browse files
committed
intro_install rst --> md
1 parent 0193b85 commit 56e1620

4 files changed

Lines changed: 316 additions & 228 deletions

File tree

docs/_build/gettext/main/intro_install.pot

Lines changed: 42 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python \n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2022-07-26 21:56+0000\n"
11+
"POT-Creation-Date: 2022-07-29 07:03+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -19,22 +19,22 @@ msgstr ""
1919
msgid "GMT / PyGMT 簡介與安裝"
2020
msgstr ""
2121

22-
msgid "`GMT`_ 是什麼?"
22+
msgid "[GMT][GMT-link] 是什麼?"
2323
msgstr ""
2424

25-
msgid "`GMT`_ 的全名是 Generic Mapping Tools,為一套多功能的製圖工具。這套軟體始於 1988 年,由當時就讀於拉蒙特-杜赫第地球觀測站 (Lamont-Doherty Earth Observatory) 的 Pål (Paul) Wessel 和 Walter H. F. Smith 設計製作,並在 1991 年公開發表第一版。[1]_ 軟體釋出後即收到廣大迴響,這些稱讚與建議成了兩位作者 (與其後加入開發團隊的所有人員) 繼續更新的原動力。三十多年過去了,GMT 在 2019 年的 11 月已經更新到第 6 版 [2]_\\ ,在地理繪圖領域享有一席之地,更是許多領域,如地球物理學、海洋科學等等,一定會接觸到的軟體之一。"
25+
msgid "[GMT][GMT-link] 的全名是 Generic Mapping Tools,為一套多功能的製圖工具。這套軟體始於 1988 年,由當時就讀於拉蒙特-杜赫第地球觀測站 (Lamont-Doherty Earth Observatory) 的 Pål (Paul) Wessel 和 Walter H. F. Smith 設計製作,並在 1991 年公開發表第一版。[^1] 軟體釋出後即收到廣大迴響,這些稱讚與建議成了兩位作者 (與其後加入開發團隊的所有人員) 繼續更新的原動力。三十多年過去了,GMT 在 2019 年的 11 月已經更新到第 6 版 [^2],在地理繪圖領域享有一席之地,更是許多領域,如地球物理學、海洋科學等等,一定會接觸到的軟體之一。"
2626
msgstr ""
2727

2828
msgid "GMT 身為「通用」的製圖工具,當然可以進行一般性的科學繪圖,大部分你想得到的圖表種類,都可以利用 GMT 內附的指令來完成。但本軟體真正的強大之處,還是在於地理資料的處理與地圖的繪製。GMT 內建許多和地理資訊系統 (GIS) 有關的演算法,讓使用者可以輕鬆的藉由一個個指令,就完成精美且高解析度的地圖。輸出的圖檔支援多種格式,包括向量化的格式檔案如 EPS 或 PDF 等,非常容易進行更多的編修。"
2929
msgstr ""
3030

31-
msgid "那 `PyGMT`_ 呢?"
31+
msgid "[PyGMT][PyGMT-link] 呢?"
3232
msgstr ""
3333

34-
msgid "`PyGMT`_ 其實就是把 GMT 重新包裝,讓所有 GMT 內的工具都可以透過 Python 這個程式語言以模組的方式來使用。除了讓原本就熟悉 Python 的人快速上手 GMT 外,遠程目標是與 Python 的其他資料科學模組一同連動,構築以 Python 進行科學資料分析的豐富環境。目前 PyGMT 已經支援了 Numpy、Pandas 和 Xarray 專有的資料格式,並且也可透過 Jupyter 環境進行互動性資料繪圖。[3]_"
34+
msgid "[PyGMT][PyGMT-link] 其實就是把 GMT 重新包裝,讓所有 GMT 內的工具都可以透過 Python 這個程式語言以模組的方式來使用。除了讓原本就熟悉 Python 的人快速上手 GMT 外,遠程目標是與 Python 的其他資料科學模組一同連動,構築以 Python 進行科學資料分析的豐富環境。目前 PyGMT 已經支援了 Numpy、Pandas 和 Xarray 專有的資料格式,並且也可透過 Jupyter 環境進行互動性資料繪圖。[^3]"
3535
msgstr ""
3636

37-
msgid "PyGMT 是由科學社群發起的專案計畫,目前的最新版 (版本號 0.3.1) 已於 20213 月釋出。各位如有興趣貢獻一己之力開發軟體,非常歡迎前往 PyGMT 的官方網站一探究竟。"
37+
msgid "PyGMT 是由科學社群發起的專案計畫,目前的最新版 (版本號 0.7.0) 已於 20227 月釋出。各位如有興趣貢獻一己之力開發軟體,非常歡迎前往 PyGMT 的官方網站一探究竟。"
3838
msgstr ""
3939

4040
msgid "我該使用 GMT 嗎?"
@@ -43,22 +43,22 @@ msgstr ""
4343
msgid "如果你有製作地圖的需求,不管是全球地圖還是自家附近的街道圖,都可以考慮使用 GMT 或 PyGMT。不過,GMT 特別適合用於科學製圖,這是因為指令化的操作方式,讓觀測或實驗數據變得很容易搭配地理資訊一同呈現。因此,筆者尤其推薦給具有以下任一種需求的人:"
4444
msgstr ""
4545

46-
msgid "**手邊有大量的地理數據需要呈現在地圖上。**\\ 例如:降雨量分佈、斷層與地震帶、海底地形圖、全世界火山分佈圖等等。"
46+
msgid "<b>手邊有大量的地理數據需要呈現在地圖上。</b>例如:降雨量分佈、斷層與地震帶、海底地形圖、全世界火山分佈圖等等。"
4747
msgstr ""
4848

49-
msgid "**時常繪製地圖,並且總是覺得使用 GIS 軟體效率太低。**\\ 學習指令列繪圖的技巧,一定能讓你的 GIS 繪圖效率大增。"
49+
msgid "<b>時常繪製地圖,並且總是覺得使用 GIS 軟體效率太低。</b>學習指令列繪圖的技巧,一定能讓你的 GIS 繪圖效率大增。"
5050
msgstr ""
5151

52-
msgid "**需要即時或互動性呈現地理資料分析的結果。**\\ 執行 GMT 或 PyGMT 的腳本,可以讓你把資料分析和繪圖輸出這兩件事一次完成。"
52+
msgid "<b>需要即時或互動性呈現地理資料分析的結果。</b>執行 GMT 或 PyGMT 的腳本,可以讓你把資料分析和繪圖輸出這兩件事一次完成。"
5353
msgstr ""
5454

55-
msgid "唯一的問題是,GMT 所有的功能都必須透過指令列操作,對於沒接觸過指令列程式的人而言,GMT 的上手曲線可能沒那麼平緩。幸好,GMT 自身的指令格式並不那麼困難,而且在大多數的情形下,我們也不需要使用 GMT 以外的指令操作資料,因此只要稍微熟稔一點操作介面的觀念,就可輕鬆上手。有關詳情可以參考「\\ :doc:`basic_concept`\\ 」。另外,如果你使用過或正在使用 Python 程式語言,那麼可以嘗試看看模組化的 PyGMT,加速學習的效率。"
55+
msgid "唯一的問題是,GMT 所有的功能都必須透過指令列操作,對於沒接觸過指令列程式的人而言,GMT 的上手曲線可能沒那麼平緩。幸好,GMT 自身的指令格式並不那麼困難,而且在大多數的情形下,我們也不需要使用 GMT 以外的指令操作資料,因此只要稍微熟稔一點操作介面的觀念,就可輕鬆上手。有關詳情可以參考「{doc}`basic_concept`」。另外,如果你使用過或正在使用 Python 程式語言,那麼可以嘗試看看模組化的 PyGMT,加速學習的效率。"
5656
msgstr ""
5757

5858
msgid "這本教學手冊"
5959
msgstr ""
6060

61-
msgid "`筆者`_\\ 目前為地球物理與行星科學領域的研究員,前前後後接觸 GMT 已約 10 年的時間。有感於網路上缺少 GMT 與 PyGMT 的簡明中文教學資料,導致包括筆者在內的許多人得花額外的時間熟悉各種工具的用法,因此決定試著紀錄一些使用心得與操作程序,並設計成教學手冊,讓新手們可以由淺入深學習 GMT,老鳥們也可以把本教學當成工具書一般的查看。"
61+
msgid "[筆者](https://whyjz.github.io/)目前為地球物理與行星科學領域的研究員,接觸 GMT 已超過 10 。有感於網路上缺少 GMT 與 PyGMT 的簡明教學資料,導致包括筆者在內的許多人得花額外的時間熟悉各種工具的用法,因此決定試著紀錄一些使用心得與操作程序,並設計成教學手冊,讓新手們可以由淺入深學習 GMT,老鳥們也可以把本教學當成工具書一般的查看。"
6262
msgstr ""
6363

6464
msgid "本教學的難度,是放在讓從沒操作過指令列程式的使用者也能理解的等級,並循序漸進到一些比較像程式碼的華麗繪圖流程。學習 GMT 最佳的方法,除了參考本手冊或其他線上說明外,實際動手做更是掌握此工具的不二法門,因此在本教學中所有的章節都會提供繪圖資料以供各位使用,或許你可以畫得出比章節的目標更漂亮的地圖!"
@@ -67,64 +67,73 @@ msgstr ""
6767
msgid "如何安裝"
6868
msgstr ""
6969

70-
msgid "GMT 和 PyGMT 有許多種安裝方式,以下是我個人推薦的方法:利用 ``conda`` 安裝 **GMT 6**。至於其他的方法,可前往 `GMT`_`PyGMT`_ 的網站查看。"
70+
msgid "GMT 和 PyGMT 有許多種安裝方式,我個人推薦利用 `conda` 套件管理器安裝。至於其他的方法,可前往 [GMT](https://github.com/GenericMappingTools/gmt/blob/master/INSTALL.md)[PyGMT](https://www.pygmt.org/latest/install.html) 的網站查看。"
7171
msgstr ""
7272

73-
msgid "首先\\ `安裝 Anaconda <https://www.anaconda.com/products/individual>`_。Anaconda 是個跨平台的套件管理軟體,尤其適合資料科學分析使用。你可以根據你的作業系統下載不同的檔案安裝。"
73+
msgid "Anaconda 會預裝很多常用的 Python 套件。如果只想要 Conda 而不想要其他的套件,也可以選擇安裝 [Miniconda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html)。"
7474
msgstr ""
7575

76-
msgid "開啟終端機 (Linux 或 Mac) 或是 Anaconda 的指令列 (Windows),建立 GMT 的安裝環境: (更多終端機的詳細說明請看「:doc:`basic_concept`」。這邊環境的名字 ``gmt6`` 可自由更改成您喜歡的字。)"
76+
msgid "首先[安裝 Anaconda](https://www.anaconda.com/products/individual)。Anaconda 是個跨平台的套件管理軟體,尤其適合資料科學分析使用。你可以根據你的作業系統下載不同的檔案安裝。安裝 Anaconda 時會一併安裝我們需要的 Conda 管理器。"
7777
msgstr ""
7878

79-
msgid "$ conda create --name gmt6\n"
80-
"$ conda activate gmt6"
79+
msgid "開啟終端機 (Linux 或 Mac) 或是 Anaconda 的指令列 (Windows),使用具有第三方套件的 conda-forge 頻道做為安裝來源。更多關於終端機的詳細說明請看「{doc}`basic_concept`」。"
8180
msgstr ""
8281

83-
msgid "安裝 GMT:"
82+
msgid "$ conda config --prepend channels conda-forge\n"
83+
""
8484
msgstr ""
8585

86-
msgid "$ conda config --prepend channels conda-forge\n"
87-
"$ conda install python=3.9 gmt"
86+
msgid "覺得 `conda` 太慢的話,可以裝 `mamba` 來加速安裝套件。請參閱 [Mamba 的說明文檔](https://mamba.readthedocs.io/en/latest/user_guide/mamba.html)以及 [PyGMT 的官方安裝示範](https://www.pygmt.org/latest/install.html)。"
87+
msgstr ""
88+
89+
msgid "建立 GMT 的安裝環境並安裝 GMT。這邊環境的名字 `mygmt` 可自由更改成您喜歡的字。)"
90+
msgstr ""
91+
92+
msgid "$ conda create --name mygmt python=3.9 gmt\n"
93+
""
8894
msgstr ""
8995

9096
msgid "或是你也可以直接安裝 PyGMT,這樣 GMT 會一併被安裝:"
9197
msgstr ""
9298

93-
msgid "$ conda config --prepend channels conda-forge\n"
94-
"$ conda install python=3.9 pygmt pip numpy pandas xarray netcdf4 packaging gmt pytest pytest-mpl"
99+
msgid "$ conda create --name mygmt python=3.9 numpy pandas xarray netcdf4 packaging pygmt\n"
100+
""
95101
msgstr ""
96102

97-
msgid "如果你計畫使用 PyGMT,推薦一併安裝 Jupyter 以進行互動式資料分析。"
103+
msgid "切換至 `mygmt` 環境即可開始使用 GMT/PyGMT。GMT 是在命令列介面 (Command-line interface, CLI) 下執行的工具,因此你可以在終端機中透過 `gmt` 這個指令使用 GMT 的所有功能。"
98104
msgstr ""
99105

100-
msgid "$ conda install jupyterlab"
106+
msgid "$ conda activate mygmt\n"
107+
"$ gmt help\n"
108+
""
101109
msgstr ""
102110

103-
msgid "要使用 GMT 時,切換至 GMT 的環境即可開始使用。"
111+
msgid "如要使用 PyGMT,在 Python 互動介面或腳本內匯入同名模組即可:"
104112
msgstr ""
105113

106-
msgid "$ conda activate gmt6\n"
107-
"$ gmt help"
114+
msgid "import pygmt \n"
115+
"pygmt.show_versions()\n"
116+
""
108117
msgstr ""
109118

110-
msgid "要使用 PyGMT 時,在 Python 內匯入同名模組即可:"
119+
msgid "如果你計畫使用 PyGMT,推薦一併安裝 JupyterLab 以進行互動式資料分析。"
111120
msgstr ""
112121

113-
msgid "import pygmt\n"
114-
"pygmt.show_versions()"
122+
msgid "$ conda install jupyterlab\n"
123+
""
115124
msgstr ""
116125

117126
msgid "使用者社群"
118127
msgstr ""
119128

120-
msgid "GMT 與 PyGMT 有著日益茁壯的社群。`官方的使用者論壇 (英文) <https://forum.generic-mapping-tools.org/>`_ 提供了使用者們交流、發問、參與開發的園地,也是軟體發布新版本時的公佈欄。"
129+
msgid "GMT 與 PyGMT 有著日益茁壯的社群。[官方的使用者論壇 (英文)](https://forum.generic-mapping-tools.org/) 提供了使用者們交流、發問、參與開發的園地,也是軟體發布新版本時的公佈欄。"
121130
msgstr ""
122131

123-
msgid "Wessel, P., and Smith, W. H. F. (1991). Free software helps map and display data, EOS Trans. AGU, 72(41), 445–446. `doi.org/10.1029/90EO00319 <http://doi.org/10.1029/90EO00319>`_."
132+
msgid "Wessel, P., and Smith, W. H. F. (1991). Free software helps map and display data, EOS Trans. AGU, 72(41), 445–446. <https://doi.org/10.1029/90EO00319>"
124133
msgstr ""
125134

126-
msgid "Wessel, P., Luis, J., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., and Tian, D. (2019). The Generic Mapping Tools Version 6. Geochemistry, Geophysics, Geosystems, 20. `doi.org/10.1029/2019GC008515 <http://doi.org/10.1029/2019GC008515>`_."
135+
msgid "Wessel, P., Luis, J., Uieda, L., Scharroo, R., Wobbe, F., Smith, W. H. F., and Tian, D. (2019). The Generic Mapping Tools Version 6. Geochemistry, Geophysics, Geosystems, 20. <http://doi.org/10.1029/2019GC008515>"
127136
msgstr ""
128137

129-
msgid "Uieda, L., Tian, D., Leong, W. J., Toney, L., Newton, T., and Wessel, P. (2020, November 14). PyGMT: A Python interface for the Generic Mapping Tools (Version v0.2.1). Zenodo. `doi.org/10.5281/zenodo.4253459 <http://doi.org/10.5281/zenodo.4253459>`_."
138+
msgid "Uieda, L., Tian, D., Leong, W. J., Jones, M., Schlitzer, W., Grund, M., Toney, L., Yao, J., Magen, Y., Materna, K., Fröhlich, Y., Belem, A., Newton, T., Anant, A., Ziebarth, M., Quinn, Ja., and Wessel, P. (2022). PyGMT: A Python interface for the Generic Mapping Tools (v0.7.0). Zenodo. <https://doi.org/10.5281/zenodo.6702566>"
130139
msgstr ""

0 commit comments

Comments
 (0)