Skip to content

Commit 4ab6ede

Browse files
seismanseisman
committed
updates
1 parent c8a7bbc commit 4ab6ede

File tree

12 files changed

+78
-76
lines changed

12 files changed

+78
-76
lines changed

‎source/basics.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
绘图基础
22
########
33

4-
这一章介绍GMT中所有程序通用的基础知识，这些知识点在GMT中会经常使用，因而需要全面掌握。
4+
这一章介绍GMT中所有程序通用的基础知识。
55

66
.. toctree::
77

‎source/index.rst‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ GMT 参考手册
1818

1919
欢迎来到 `GMT <http://gmt.soest.hawaii.edu>`_ （Generic Mapping Tools）的世界。
2020

21-
本项目是GMT中文社区维护的GMT中文手册，既可以作为入门读物，也可以作为日常参考。
22-
希望通过阅读本手册，能够让用户尽快掌握GMT的用法。
21+
本项目是 `GMT中文社区 <http://gmt-china.org>`_ 维护的GMT中文参考手册，既可以作为
22+
入门读物，也可以作为日常参考。希望通过阅读本手册，能够让用户尽快掌握GMT的用法。
2323

2424
**相关链接：**
2525

@@ -37,14 +37,14 @@ GMT 参考手册
3737
:hidden:
3838

3939
preface
40-
introductions
40+
intro
4141
install
4242
tutorial
4343
basics
4444
io
4545
options
4646
configurations
47-
projections
47+
proj
4848
style
4949
api
5050
appendix

‎source/install/directory-tree.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
目录树
2-
======
1+
目录结构
2+
========
33

44
本文用 ``$GMTHOME`` 表示GMT的安装路径，在Linux下一般是 :file:`/usr/local/GMT5`
55
或 :file:`/opt/GMT5` ，在Windows下一般是 ``C:\programs\gmt5`` 。

source/introductions.rst renamed to source/intro.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@
66
.. toctree::
77
:maxdepth: 2
88

9-
intro/intro-gmt
9+
intro/overview
10+
intro/versions
1011
intro/philosophy
1112
intro/linux-basic
1213
intro/self-learning

source/intro/intro-gmt.rst renamed to source/intro/overview.rst

Lines changed: 0 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -62,61 +62,6 @@ GMT的特点
6262
图片格式，可以任意放大缩小而不失真。GMT充分利用PostScript语言的特性，可以
6363
生成高质量的矢量图件，并可以很容易地转换为其他图片格式。
6464

65-
GMT版本号
66-
---------
67-
68-
GMT的版本号的格式为::
69-
70-
major.minor.patch
71-
72-
其中 ``major`` 为主版本号，``minor`` 为次版本号，``patch`` 为补丁版本号。
73-
74-
一般而言，版本号的更新规则如下：
75-
76-
- 当有极大的更新，会增加主版本号 ``major`` ，因而 ``major`` 不同的两个版本在
77-
语法和功能上有很大的差异
78-
- 当有较大的更新，比如个别命令的语法有变化，会更新次版本号 ``minor``
79-
- 若更新主要是修复错误，则会增加 ``patch`` 的版本号
80-
81-
因而， ``GMT 5.x.x`` 与 ``GMT 4.x.x`` 之间有很大差异，两个版本的语法是不完全
82-
兼容的，切勿混在一起使用。 ``GMT 4.5.x`` 和 ``GMT 4.4.x`` ，部分命令的语法和
83-
用法可能有一点区别。而 ``GMT 4.5.13`` 相对于 ``GMT 4.5.12`` ，主要是修复了一些BUG。
84-
85-
GMT4 vs GMT5
86-
------------
87-
88-
GMT目前在同时维护GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
89-
90-
GMT4的优缺点：
91-
92-
- 已发布十年有余，功能相对成熟
93-
- 仅修复Bug，不再增加新功能，命令语法相对稳定
94-
- 网络上的中文教程及示例多采用GMT4语法，新手学习起来更方便
95-
96-
GMT5的优缺点：
97-
98-
- GMT5是GMT的未来
99-
- 相对于GMT4有很多改进，命令语法更统一，选项的设计更加合理
100-
- 增加了很多新功能，其中非常有用的包括但不限于：
101-
102-
- ``-Bafg`` 自动确定坐标轴的标注间隔
103-
- 支持透明色，且支持透明图层
104-
- 引入修饰物的概念，使得相关代码更具通用性
105-
- ``-X`` 和 ``-Y`` 支持多种指定坐标原点的方式，画多子图的组合图时更加简单
106-
107-
- 由于重写了大量代码，因而可能有较多的Bug
108-
- 目前关于GMT5的中文教程太少
109-
110-
综上，对于用户的建议是：
111-
112-
- 新用户推荐学习GMT5，毕竟GMT5是GMT的未来，更多新用户的加入也可以更好地促进GMT的发展
113-
- 实验室可能有前人留下的GMT4的代码，若历史负担太重，建议使用GMT4
114-
- 若自己的大型项目中使用了GMT绘图，建议使用GMT4，因为GMT4相对稳定，不至于因为
115-
GMT小版本的不兼容而影响到自己的项目
116-
117-
PS：GMT4和GMT5可在系统中共存，因而完全可以同时安装两个版本，旧脚本不必修改，
118-
继续使用GMT4，新脚本则使用GMT5语法。
119-
12065
跨平台特性
12166
----------
12267

‎source/intro/self-learning.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ GMT相关的学习资源列举如下。虽然官方文档都有对应的中文
1010
#. `GMT中文模块手册 <http://modules.gmt-china.org>`_
1111
#. `GMT官方示例 <http://gmt.soest.hawaii.edu/doc/5.4.2/Gallery.html>`_
1212
#. `GMT中文社区示例 <http://gmt-china.org/gallery/>`_
13-
#. `SeisMan博客GMT示例 <https://seisman.info/tags/GMT/>`_
13+
#. `SeisMan博客GMT示例 <http://seisman.info/tags/GMT/>`_
1414
#. :doc:`GMT开发版源码 </appendix/get-gmt-dev>` 中的测试脚本
1515
#. GMT学习QQ群：218905582
1616
#. `GMT官方论坛 <http://gmt.soest.hawaii.edu/projects/gmt/boards/1>`_

‎source/intro/versions.rst‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
GMT版本
2+
=======
3+
4+
版本号
5+
------
6+
7+
GMT的版本号的格式为::
8+
9+
major.minor.patch
10+
11+
其中 ``major`` 为主版本号，``minor`` 为次版本号，``patch`` 为补丁版本号。
12+
13+
一般而言，版本号的更新规则如下：
14+
15+
- 当有极大的更新，会增加主版本号 ``major`` ，因而 ``major`` 不同的两个版本在
16+
语法和功能上有很大的差异
17+
- 当有较大的更新，比如个别命令的语法有变化，会更新次版本号 ``minor``
18+
- 若更新主要是修复错误，则会增加 ``patch`` 的版本号
19+
20+
因而， ``GMT 5.x.x`` 与 ``GMT 4.x.x`` 之间有很大差异，两个版本的语法是不完全
21+
兼容的，切勿混在一起使用。 ``GMT 4.5.x`` 和 ``GMT 4.4.x`` ，部分命令的语法和
22+
用法可能有一点区别。而 ``GMT 4.5.13`` 相对于 ``GMT 4.5.12`` ，主要是修复了一些BUG。
23+
24+
GMT4 vs GMT5
25+
------------
26+
27+
GMT目前在同时维护GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
28+
29+
GMT4的优缺点：
30+
31+
- 已发布十年有余，功能相对成熟
32+
- 仅修复Bug，不再增加新功能，命令语法相对稳定
33+
- 网络上的中文教程及示例多采用GMT4语法，新手学习起来更方便
34+
35+
GMT5的优缺点：
36+
37+
- GMT5是GMT的未来
38+
- 相对于GMT4有很多改进，命令语法更统一，选项的设计更加合理
39+
- 增加了很多新功能，其中非常有用的包括但不限于：
40+
41+
- ``-Bafg`` 自动确定坐标轴的标注间隔
42+
- 支持透明色，且支持透明图层
43+
- 引入修饰物的概念，使得相关代码更具通用性
44+
- ``-X`` 和 ``-Y`` 支持多种指定坐标原点的方式，画多子图的组合图时更加简单
45+
46+
- 由于重写了大量代码，因而可能有较多的Bug
47+
- 目前关于GMT5的中文教程太少
48+
49+
综上，对于用户的建议是：
50+
51+
- 新用户推荐学习GMT5，毕竟GMT5是GMT的未来，更多新用户的加入也可以更好地促进GMT的发展
52+
- 实验室可能有前人留下的GMT4的代码，若历史负担太重，建议使用GMT4
53+
- 若自己的大型项目中使用了GMT绘图，建议使用GMT4，因为GMT4相对稳定，不至于因为
54+
GMT小版本的不兼容而影响到自己的项目
55+
56+
PS：GMT4和GMT5可在系统中共存，因而完全可以同时安装两个版本，旧脚本不必修改，
57+
继续使用GMT4，新脚本则使用GMT5语法。
58+

‎source/io/postscript.rst‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
PostScript
44
==========
55

6-
前面已经多次提到了PostScript（简写为PS），这一节将简单介绍一下PS语言与PS格式。
6+
GMT生成的图片为PS格式，全称是PostScript。这一节将简单介绍一下PS语言与PS格式。
77

88
PS是什么
99
--------
@@ -56,18 +56,18 @@ GMT所有的绘图模块都只能生成PS代码，将这些PS代码保存到PS
5656

5757
GMT提供了 ``psconvert`` 模块，可以很方便地将PS文件以任意精度转换为jpeg、png、eps、pdf等图片格式，以满足不同情形下的需求。
5858

59-
PS解释器
59+
PS阅读器
6060
--------
6161

62-
PS解释器，或称PS阅读器，是用于查看PS文件的软件。
62+
PS阅读器，或称PS解释器，是用于查看PS文件的软件。
6363

6464
- `ghostscript <http://ghostscript.com/>`_
6565
- `gsview <http://www.gsview.com/>`_
6666
- `evince <https://wiki.gnome.org/Apps/Evince>`_
6767
- `zathura <https://pwmt.org/projects/zathura/>`_ (Linux only)
6868
- `SumatraPDF <http://www.sumatrapdfreader.org/free-pdf-reader.html>`_ (Windows only)
6969

70-
将PS转化为其他格式
70+
将PS转换为其他格式
7171
------------------
7272

7373
GMT提供了 ``psconvert`` 模块，可以很方便地将PS文件以任意精度转换为jpeg、png、eps、pdf等图片格式，以满足不同情形下的需求。

‎source/option/J.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
.. |lonp| replace:: lon\ :sub:`p`
3333
.. |latp| replace:: lat\ :sub:`p`
3434

35-
下表列出了GMT所支持的全部投影方式，详细介绍见 :doc:`/projections` 。
35+
下表列出了GMT所支持的全部投影方式，详细介绍见 :doc:`/proj` 。
3636

3737
.. table:: GMT -J Codes
3838

‎source/preface.rst‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
前言
22
####
33

4-
本项目开始于2014年。在2014年，网络上能够找到的GMT中文文档大多基于GMT4甚至
5-
GMT3。这些文档存在一些共同的缺点：
4+
GMT中文参考手册开始于2014年。在2014年，网络上能够找到的GMT中文文档大多基于
5+
GMT4甚至GMT3。这些文档存在一些共同的缺点：
66

77
#. 排版质量差：大多是在Word里写好然后转换成PDF
88
#. 缺乏维护：文档写好发布后就没有再持续更新
@@ -11,7 +11,7 @@ GMT3。这些文档存在一些共同的缺点：
1111
#. 命令过时：有些命令在新版本的GMT下无法执行，新用户的体验很糟糕
1212
#. 重复劳动：多个作者独立翻译整理出了几份相似的文档，很多工作都是在重复劳动
1313

14-
本项目具有如下优点：
14+
相比于其他文档，本手册具有如下优点：
1515

1616
#. 高质量排版：文档提供网页版和PDF版，PDF由LaTeX制作得到，排版质量高
1717
#. 持续维护：适配GMT的新版本，且不断修正文档中存在的错误，不定期发布新版本
@@ -24,7 +24,7 @@ GMT3。这些文档存在一些共同的缺点：
2424
工作中来。
2525

2626
本作品采用 `知识共享署名-非商业性使用 4.0 国际许可协议 <https://creativecommons.org/licenses/by-nc/4.0/>`_
27-
进行许可。任何人都可以自由地分享、修改本作品，但必须遵循如下条件：
27+
进行许可。任何人均可自由分享和使用本手册中的所有内容或修改本手册，但必须遵循如下条件：
2828

29-
- 署名：必须提到原作者，提供指向此许可协议的链接，表明是否有做修改
29+
- 署名：必须提到手册的作者——GMT中文社区
3030
- 非商业性使用：不能对本作品进行任何形式的商业性使用

0 commit comments

Comments
 (0)