updates

gmt-china · Jul 18, 2017 · 4ab6ede · 4ab6ede
1 parent c8a7bbc
commit 4ab6ede
Show file tree

Hide file tree

Showing 12 changed files with 78 additions and 76 deletions.
diff --git a/source/basics.rst b/source/basics.rst
@@ -1,7 +1,7 @@
 绘图基础
 ########
 
-这一章介绍GMT中所有程序通用的基础知识，这些知识点在GMT中会经常使用，因而需要全面掌握。
+这一章介绍GMT中所有程序通用的基础知识。
 
 .. toctree::
 

diff --git a/source/index.rst b/source/index.rst
@@ -18,8 +18,8 @@ GMT 参考手册
 
 欢迎来到 `GMT <http://gmt.soest.hawaii.edu>`_ （Generic Mapping Tools）的世界。
 
-本项目是GMT中文社区维护的GMT中文手册，既可以作为入门读物，也可以作为日常参考。
-希望通过阅读本手册，能够让用户尽快掌握GMT的用法。
+本项目是 `GMT中文社区 <http://gmt-china.org>`_ 维护的GMT中文参考手册，既可以作为
+入门读物，也可以作为日常参考。希望通过阅读本手册，能够让用户尽快掌握GMT的用法。
 
 **相关链接：**
 
@@ -37,14 +37,14 @@ GMT 参考手册
    :hidden:
 
    preface
-   introductions
+   intro
    install
    tutorial
    basics
    io
    options
    configurations
-   projections
+   proj
    style
    api
    appendix
diff --git a/source/install/directory-tree.rst b/source/install/directory-tree.rst
@@ -1,5 +1,5 @@
-目录树
-======
+目录结构
+========
 
 本文用 ``$GMTHOME`` 表示GMT的安装路径，在Linux下一般是 :file:`/usr/local/GMT5`
 或 :file:`/opt/GMT5` ，在Windows下一般是 ``C:\programs\gmt5`` 。

diff --git a/source/introductions.rst → source/intro.rst b/source/introductions.rst → source/intro.rst
@@ -6,7 +6,8 @@
 .. toctree::
    :maxdepth: 2
 
-   intro/intro-gmt
+   intro/overview
+   intro/versions
    intro/philosophy
    intro/linux-basic
    intro/self-learning

diff --git a/source/intro/intro-gmt.rst → source/intro/overview.rst b/source/intro/intro-gmt.rst → source/intro/overview.rst
@@ -62,61 +62,6 @@ GMT的特点
    图片格式，可以任意放大缩小而不失真。GMT充分利用PostScript语言的特性，可以
    生成高质量的矢量图件，并可以很容易地转换为其他图片格式。
 
-GMT版本号
----------
-
-GMT的版本号的格式为::
-
-    major.minor.patch
-
-其中 ``major`` 为主版本号，``minor`` 为次版本号，``patch`` 为补丁版本号。
-
-一般而言，版本号的更新规则如下：
-
-- 当有极大的更新，会增加主版本号 ``major`` ，因而 ``major`` 不同的两个版本在
-  语法和功能上有很大的差异
-- 当有较大的更新，比如个别命令的语法有变化，会更新次版本号 ``minor``
-- 若更新主要是修复错误，则会增加 ``patch`` 的版本号
-
-因而， ``GMT 5.x.x`` 与 ``GMT 4.x.x`` 之间有很大差异，两个版本的语法是不完全
-兼容的，切勿混在一起使用。 ``GMT 4.5.x`` 和 ``GMT 4.4.x`` ，部分命令的语法和
-用法可能有一点区别。而 ``GMT 4.5.13`` 相对于 ``GMT 4.5.12`` ，主要是修复了一些BUG。
-
-GMT4 vs GMT5
-------------
-
-GMT目前在同时维护GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
-
-GMT4的优缺点：
-
-- 已发布十年有余，功能相对成熟
-- 仅修复Bug，不再增加新功能，命令语法相对稳定
-- 网络上的中文教程及示例多采用GMT4语法，新手学习起来更方便
-
-GMT5的优缺点：
-
-- GMT5是GMT的未来
-- 相对于GMT4有很多改进，命令语法更统一，选项的设计更加合理
-- 增加了很多新功能，其中非常有用的包括但不限于：
-
-  - ``-Bafg`` 自动确定坐标轴的标注间隔
-  - 支持透明色，且支持透明图层
-  - 引入修饰物的概念，使得相关代码更具通用性
-  - ``-X`` 和 ``-Y`` 支持多种指定坐标原点的方式，画多子图的组合图时更加简单
-
-- 由于重写了大量代码，因而可能有较多的Bug
-- 目前关于GMT5的中文教程太少
-
-综上，对于用户的建议是：
-
-- 新用户推荐学习GMT5，毕竟GMT5是GMT的未来，更多新用户的加入也可以更好地促进GMT的发展
-- 实验室可能有前人留下的GMT4的代码，若历史负担太重，建议使用GMT4
-- 若自己的大型项目中使用了GMT绘图，建议使用GMT4，因为GMT4相对稳定，不至于因为
-  GMT小版本的不兼容而影响到自己的项目
-
-PS：GMT4和GMT5可在系统中共存，因而完全可以同时安装两个版本，旧脚本不必修改，
-继续使用GMT4，新脚本则使用GMT5语法。
-
 跨平台特性
 ----------
 

diff --git a/source/intro/self-learning.rst b/source/intro/self-learning.rst
@@ -10,7 +10,7 @@ GMT相关的学习资源列举如下。虽然官方文档都有对应的中文
 #. `GMT中文模块手册 <http://modules.gmt-china.org>`_
 #. `GMT官方示例 <http://gmt.soest.hawaii.edu/doc/5.4.2/Gallery.html>`_
 #. `GMT中文社区示例 <http://gmt-china.org/gallery/>`_
-#. `SeisMan博客GMT示例 <https://seisman.info/tags/GMT/>`_
+#. `SeisMan博客GMT示例 <http://seisman.info/tags/GMT/>`_
 #. :doc:`GMT开发版源码 </appendix/get-gmt-dev>` 中的测试脚本
 #. GMT学习QQ群：218905582
 #. `GMT官方论坛 <http://gmt.soest.hawaii.edu/projects/gmt/boards/1>`_
diff --git a/source/intro/versions.rst b/source/intro/versions.rst
@@ -0,0 +1,58 @@
+GMT版本
+=======
+
+版本号
+------
+
+GMT的版本号的格式为::
+
+    major.minor.patch
+
+其中 ``major`` 为主版本号，``minor`` 为次版本号，``patch`` 为补丁版本号。
+
+一般而言，版本号的更新规则如下：
+
+- 当有极大的更新，会增加主版本号 ``major`` ，因而 ``major`` 不同的两个版本在
+  语法和功能上有很大的差异
+- 当有较大的更新，比如个别命令的语法有变化，会更新次版本号 ``minor``
+- 若更新主要是修复错误，则会增加 ``patch`` 的版本号
+
+因而， ``GMT 5.x.x`` 与 ``GMT 4.x.x`` 之间有很大差异，两个版本的语法是不完全
+兼容的，切勿混在一起使用。 ``GMT 4.5.x`` 和 ``GMT 4.4.x`` ，部分命令的语法和
+用法可能有一点区别。而 ``GMT 4.5.13`` 相对于 ``GMT 4.5.12`` ，主要是修复了一些BUG。
+
+GMT4 vs GMT5
+------------
+
+GMT目前在同时维护GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
+
+GMT4的优缺点：
+
+- 已发布十年有余，功能相对成熟
+- 仅修复Bug，不再增加新功能，命令语法相对稳定
+- 网络上的中文教程及示例多采用GMT4语法，新手学习起来更方便
+
+GMT5的优缺点：
+
+- GMT5是GMT的未来
+- 相对于GMT4有很多改进，命令语法更统一，选项的设计更加合理
+- 增加了很多新功能，其中非常有用的包括但不限于：
+
+  - ``-Bafg`` 自动确定坐标轴的标注间隔
+  - 支持透明色，且支持透明图层
+  - 引入修饰物的概念，使得相关代码更具通用性
+  - ``-X`` 和 ``-Y`` 支持多种指定坐标原点的方式，画多子图的组合图时更加简单
+
+- 由于重写了大量代码，因而可能有较多的Bug
+- 目前关于GMT5的中文教程太少
+
+综上，对于用户的建议是：
+
+- 新用户推荐学习GMT5，毕竟GMT5是GMT的未来，更多新用户的加入也可以更好地促进GMT的发展
+- 实验室可能有前人留下的GMT4的代码，若历史负担太重，建议使用GMT4
+- 若自己的大型项目中使用了GMT绘图，建议使用GMT4，因为GMT4相对稳定，不至于因为
+  GMT小版本的不兼容而影响到自己的项目
+
+PS：GMT4和GMT5可在系统中共存，因而完全可以同时安装两个版本，旧脚本不必修改，
+继续使用GMT4，新脚本则使用GMT5语法。
+
diff --git a/source/io/postscript.rst b/source/io/postscript.rst
@@ -3,7 +3,7 @@
 PostScript
 ==========
 
-前面已经多次提到了PostScript（简写为PS），这一节将简单介绍一下PS语言与PS格式。
+GMT生成的图片为PS格式，全称是PostScript。这一节将简单介绍一下PS语言与PS格式。
 
 PS是什么
 --------
@@ -56,18 +56,18 @@ GMT所有的绘图模块都只能生成PS代码，将这些PS代码保存到PS
 
    GMT提供了 ``psconvert`` 模块，可以很方便地将PS文件以任意精度转换为jpeg、png、eps、pdf等图片格式，以满足不同情形下的需求。
 
-PS解释器
+PS阅读器
 --------
 
-PS解释器，或称PS阅读器，是用于查看PS文件的软件。
+PS阅读器，或称PS解释器，是用于查看PS文件的软件。
 
 - `ghostscript <http://ghostscript.com/>`_
 - `gsview <http://www.gsview.com/>`_
 - `evince <https://wiki.gnome.org/Apps/Evince>`_
 - `zathura <https://pwmt.org/projects/zathura/>`_ (Linux only)
 - `SumatraPDF <http://www.sumatrapdfreader.org/free-pdf-reader.html>`_ (Windows only)
 
-将PS转化为其他格式
+将PS转换为其他格式
 ------------------
 
 GMT提供了 ``psconvert`` 模块，可以很方便地将PS文件以任意精度转换为jpeg、png、eps、pdf等图片格式，以满足不同情形下的需求。

diff --git a/source/option/J.rst b/source/option/J.rst
@@ -32,7 +32,7 @@
 .. |lonp| replace:: lon\ :sub:`p`
 .. |latp| replace:: lat\ :sub:`p`
 
-下表列出了GMT所支持的全部投影方式，详细介绍见 :doc:`/projections` 。
+下表列出了GMT所支持的全部投影方式，详细介绍见 :doc:`/proj` 。
 
 .. table:: GMT -J Codes
 

diff --git a/source/preface.rst b/source/preface.rst
@@ -1,8 +1,8 @@
 前言
 ####
 
-本项目开始于2014年。在2014年，网络上能够找到的GMT中文文档大多基于GMT4甚至
-GMT3。这些文档存在一些共同的缺点：
+GMT中文参考手册开始于2014年。在2014年，网络上能够找到的GMT中文文档大多基于
+GMT4甚至GMT3。这些文档存在一些共同的缺点：
 
 #. 排版质量差：大多是在Word里写好然后转换成PDF
 #. 缺乏维护：文档写好发布后就没有再持续更新
@@ -11,7 +11,7 @@ GMT3。这些文档存在一些共同的缺点：
 #. 命令过时：有些命令在新版本的GMT下无法执行，新用户的体验很糟糕
 #. 重复劳动：多个作者独立翻译整理出了几份相似的文档，很多工作都是在重复劳动
 
-本项目具有如下优点：
+相比于其他文档，本手册具有如下优点：
 
 #. 高质量排版：文档提供网页版和PDF版，PDF由LaTeX制作得到，排版质量高
 #. 持续维护：适配GMT的新版本，且不断修正文档中存在的错误，不定期发布新版本
@@ -24,7 +24,7 @@ GMT3。这些文档存在一些共同的缺点：
 工作中来。
 
 本作品采用 `知识共享署名-非商业性使用 4.0 国际许可协议 <https://creativecommons.org/licenses/by-nc/4.0/>`_
-进行许可。任何人都可以自由地分享、修改本作品，但必须遵循如下条件：
+进行许可。任何人均可自由分享和使用本手册中的所有内容或修改本手册，但必须遵循如下条件：
 
-- 署名：必须提到原作者，提供指向此许可协议的链接，表明是否有做修改
+- 署名：必须提到手册的作者——GMT中文社区
 - 非商业性使用：不能对本作品进行任何形式的商业性使用
diff --git a/source/projections.rst → source/proj.rst b/source/projections.rst → source/proj.rst
diff --git a/source/tutorial.rst b/source/tutorial.rst
@@ -7,8 +7,6 @@
 在开始阅读本章之前，请注意：
 
 #. 确保已安装GMT最新版本，且可正确执行
-#. 本章的示例中需要一些额外的数据。建议读者建一个 :file:`tutorial` 目录，并将
-   ``${GMTHOME}/share/doc/tutorial`` 目录下的数据复制到该目录中。
 #. 对于每一个绘图任务，建议将所有的GMT以及Unix命令放在shell脚本中，并为脚本增加
    可执行权限。教程中的所以后脚本均为bash脚本。使用其他脚本语言的用户需要自行修改。
 #. 使用 `gs xxx.ps` 以查看生成的PS文件。不同系统下PS阅读器可能不同