Update to GMT 5.4.4 (#72)

gmt-china · Jul 3, 2018 · cac6e23 · cac6e23
1 parent ddc99b3
commit cac6e23
Show file tree

Hide file tree

Showing 22 changed files with 84 additions and 71 deletions.
diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@
 
 ## 版本说明
 
-本手册目前与 GMT 5.4.3 同步，历史版本见 [release](https://github.com/gmt-china/GMT_docs/releases) 页面。
+本手册目前与 GMT 5.4.4 同步，历史版本见 [release](https://github.com/gmt-china/GMT_docs/releases) 页面。
 
 - 在线阅读： https://docs.gmt-china.org
 - 离线阅读： [HTML](https://docs.gmt-china.org/GMT_docs.zip) [PDF](https://docs.gmt-china.org/GMT_docs.pdf)

diff --git a/source/GMT_style.sty b/source/GMT_style.sty
@@ -1,7 +1,7 @@
 % 文档相关信息
 \newcommand{\GMTDOCTITLE}{GMT\textbf{参考手册}}   % 文档标题
 \newcommand{\GMTDOCAUTHOR}{GMT中文社区}               % 文档作者
-\newcommand{\GMTDOCVERSION}{5.4.3}              % 文档版本
+\newcommand{\GMTDOCVERSION}{5.4.4}              % 文档版本
 
 % 字体设置
 \setmonofont{Source Code Pro}
@@ -89,8 +89,8 @@
 
 % 图表标题
 \usepackage[labelfont={small,bf}, textfont=small]{caption}
-\captionsetup[figure]{aboveskip=6pt, belowskip=-12pt}
-\captionsetup[table]{aboveskip=6pt, belowskip=-6pt}
+\captionsetup[figure]{aboveskip=6pt, belowskip=6pt}
+\captionsetup[table]{aboveskip=6pt, belowskip=-12pt}
 
 % 首行缩进
 \usepackage{indentfirst}

diff --git a/source/api/julia.rst b/source/api/julia.rst
@@ -86,7 +86,7 @@ GMT 的 Julia 接口的官方地址为： https://github.com/joa-quim/GMT.jl
    Julia 接口能够正确使用的前提是 Julia 可以找到 GMT 的动态链接库文件。所以，
    若以上命令报错，则可以执行::
 
-        echo 'push!(Libdl.DL_LOAD_PATH, "/opt/GMT-5.4.1/lib64")' >> ~/.juliarc.jl
+        echo 'push!(Libdl.DL_LOAD_PATH, "/opt/GMT-5.4.4/lib64")' >> ~/.juliarc.jl
 
    将 GMT 的动态库文件所在目录添加到 Julia 的搜索路径中。
 
@@ -181,7 +181,7 @@ Julia 示例位于： ``~/.julia/v0.5/GMT/test/gallery.jl`` 中，你可以直
 
 如果想要执行该 Julia 脚本，你需要将 ``~/.julia/v0.5/GMT/test/gallery.jl`` 的第7行修改为::
 
-    global g_root_dir = "/opt/GMT-5.4.1/share/"
+    global g_root_dir = "/opt/GMT-5.4.4/share/"
     global out_path = ""
 
 并安装如下方式运行示例：

diff --git a/source/basic/character-escape.rst b/source/basic/character-escape.rst
@@ -57,7 +57,7 @@
 ------------
 
 .. figure:: /images/GMT_escape_examples.*
-   :width: 700 px
+   :width: 100%
    :align: center
 
    GMT转义序列示例

diff --git a/source/basic/color.rst b/source/basic/color.rst
@@ -14,18 +14,29 @@
 颜色名
 ------
 
-通过颜色名指定颜色是最直观的方式了。常见的颜色如 ``white`` 、 ``black`` 、 ``red`` 、 ``orange`` 、 ``yellow`` 、 ``green`` 、 ``cyan`` 、 ``blue`` 、 ``magenta`` 、 ``gray`` （或 ``grey`` ）和 ``brown`` 等 。除 ``white`` 和 ``black`` 之外，其余的几种常见颜色名还可以加上前缀 ``light`` 或 ``dark`` ，以表示浅色和深色。比如 ``lightblue`` 、 ``blue`` 、 ``darkblue`` 分别表示浅蓝、蓝色和深蓝。
+通过颜色名指定颜色是最直观的方式了。常见的颜色如 ``white``\ 、
+``black``\ 、 ``red``\ 、 ``orange``\ 、 ``yellow``\ 、 ``green``\ 、
+``cyan``\ 、 ``blue``\ 、 ``magenta``\ 、 ``gray`` （或 ``grey`` ）
+和 ``brown`` 等。
+除 ``white`` 和 ``black`` 之外，其余的几种常见颜色名还可以加上前缀 ``light``
+或 ``dark``\ ，以表示浅色和深色。比如 ``lightblue``\ 、``blue``\ 、``darkblue``
+分别表示浅蓝、蓝色和深蓝。
 
-GMT共支持663种颜色名。Linux下可以使用 ``man gmtcolors`` 命令查看GMT支持的颜色名列表，或直接查看GMT自带的颜色文档 ``${GMTHOME}/share/doc/pdf/GMT_RGBchart_a4.pdf`` 。
+GMT共支持663种颜色名。Linux下可以使用 ``man gmtcolors`` 命令查看GMT支持的
+颜色名列表，或直接查看GMT自带的颜色文档 ``${GMTHOME}/share/doc/pdf/GMT_RGBchart_a4.pdf`` 。
 
-所有的颜色名都是不区分大小写的，所以 ``lightblue`` 、 ``LIGHTBLUE`` 或者 ``LightBlue`` 都是合法的颜色名。
+所有的颜色名都是不区分大小写的，所以 ``lightblue``\ 、``LIGHTBLUE`` 或者 ``LightBlue``
+都是合法的颜色名。
 
 RGB
 ---
 
-即三原色光模型，或又称RGB颜色模型，是一种加色模型，将红（\ **R**\ ed ）、绿（\ **G**\ reen）、蓝（\ **B**\ lue）三原色的色光以不同的比例相加，以产生多种多样的色光。
+即三原色光模型，或又称RGB颜色模型，是一种加色模型，将红（\ **R**\ ed ）、
+绿（\ **G**\ reen）、蓝（\ **B**\ lue）三原色的色光以不同的比例相加，
+以产生多种多样的色光。
 
-GMT中可以通过指定 ``r/g/b`` 的格式来指定RGB颜色，其中 ``r`` 、 ``g`` 、 ``b`` 的取值范围都是0到255，三者用反斜线 ``/`` 分开。
+GMT中可以通过指定 ``r/g/b`` 的格式来指定RGB颜色，其中 ``r``\ 、``g``\ 、``b``
+的取值范围都是0到255，三者用反斜线 ``/`` 分开。
 
 RGB颜色示例：
 
@@ -35,7 +46,10 @@ RGB颜色示例：
 - ``0/255/0`` ：绿色；
 - ``0/0/255`` ：蓝色；
 
-RGB颜色除了可以用上面的表示法之外，还可以用HMTL中常用的表示法 ``#RRGGBB`` ，即分别用两位的十六进制数字表示每个颜色通道，0对应的16进制是 ``00`` ，255对应的16进制是 ``FF`` 。例如 ``#000000`` 即黑色， ``#FF0000`` 即红色。十六进制数用大小写表示均可。
+RGB颜色除了可以用上面的表示法之外，还可以用HMTL中常用的表示法 ``#RRGGBB``\ ，
+即分别用两位的十六进制数字表示每个颜色通道，0对应的16进制是 ``00``\ ，
+255对应的16进制是 ``FF``\ 。例如 ``#000000`` 即黑色，``#FF0000`` 即红色。
+十六进制数用大小写表示均可。
 
 HSV
 ---

diff --git a/source/basic/glossary.rst b/source/basic/glossary.rst
@@ -5,7 +5,7 @@
 
 .. figure:: /images/GMT_glossary.*
    :align: center
-   :width: 700 px
+   :width: 100%
 
    GMT绘图元素
 

diff --git a/source/conf.py b/source/conf.py
@@ -39,13 +39,11 @@
 project = u'GMT参考手册'
 copyright = u'2014-2018, GMT中文社区'
 author = u'GMT中文社区'
-version = '5.4.3'
+version = '5.4.4'
 release = version
 rst_prolog = '''
-.. |GMT4_latest_release| replace:: 4.5.17
-.. |GMT4_latest_release_date| replace:: 2018-01-01
-.. |GMT5_latest_release| replace:: 5.4.3
-.. |GMT5_latest_release_date| replace:: 2018-01-01
+.. |GMT5_latest_release| replace:: 5.4.4
+.. |GMT5_latest_release_date| replace:: 2018-07-01
 '''
 
 # -- Options for HTML output ----------------------------------------------

diff --git a/source/index.rst b/source/index.rst
@@ -9,17 +9,17 @@ GMT 参考手册
 
 欢迎来到 `GMT <http://gmt.soest.hawaii.edu>`_ （Generic Mapping Tools）的世界。
 
-本项目是 `GMT中文社区 <http://gmt-china.org>`_ 维护的GMT中文参考手册，既可以作为
+本项目是 `GMT中文社区 <https://gmt-china.org>`_ 维护的GMT中文参考手册，既可以作为
 入门读物，也可以作为日常参考。希望通过阅读本手册，能够让用户尽快掌握GMT的用法。
 
 **相关链接：**
 
-- 社区主页：http://gmt-china.org
+- 社区主页：https://gmt-china.org
 - 项目主页：https://docs.gmt-china.org
 - 项目源码：https://github.com/gmt-china/GMT_Docs
 - GMT官方手册：http://gmt.soest.hawaii.edu/doc/latest/index.html
 - GMT模块手册： https://modules.gmt-china.org
-- GMT图库： http://gmt-china.org/gallery/
+- GMT图库： https://gmt-china.org/gallery/
 
 .. toctree::
    :maxdepth: 3

diff --git a/source/install/cn-linux.rst b/source/install/cn-linux.rst
@@ -23,8 +23,8 @@ GMT 原生并不支持中文。为了让 GMT 支持中文，需要修改 ghostsc
 GMT 字体配置文件
 ++++++++++++++++
 
-假定 GMT 的安装路径为 ``/opt/GMT-5.4.3`` ，则字体配置文件的路径为
-``/opt/GMT-5.4.3/share/postscriptlight/PSL_custom_fonts.txt`` 。
+假定 GMT 的安装路径为 ``/opt/GMT-5.4.4`` ，则字体配置文件的路径为
+``/opt/GMT-5.4.4/share/postscriptlight/PSL_custom_fonts.txt`` 。
 
 使 gs 支持中文
 --------------

diff --git a/source/install/database.rst b/source/install/database.rst
@@ -3,7 +3,7 @@ GMT 数据库的建立
 
 在使用 GMT 绘图时，经常会用到某些数据，比如地形起伏数据、正确的国界线数据、
 中国地质构造分界线数据等等。
-社区已经提供了一个数据集，包含了一些常见的数据：http://gmt-china.org/datas/。
+社区已经提供了一个数据集，包含了一些常见的数据：https://gmt-china.org/datas/。
 
 这些数据具有两个特性：
 

diff --git a/source/install/linux.rst b/source/install/linux.rst
@@ -83,7 +83,7 @@ netCDF（>4.0且支持netCDF-4/HDF5）、ghostscript等。
 
 Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 
-#. GMT源码： http://mirrors.ustc.edu.cn/gmt/gmt-5.4.3-src.tar.gz
+#. GMT源码： http://mirrors.ustc.edu.cn/gmt/gmt-5.4.4-src.tar.gz
 #. 全球海岸线数据GSHHG： http://mirrors.ustc.edu.cn/gmt/gshhg-gmt-2.3.7.tar.gz
 #. 全球数字图表DCW： http://mirrors.ustc.edu.cn/gmt/dcw-gmt-1.1.3.tar.gz
 
@@ -95,23 +95,23 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 .. code-block:: bash
 
    # 解压三个压缩文件
-   $ tar -xvf gmt-5.4.3-src.tar.gz
+   $ tar -xvf gmt-5.4.4-src.tar.gz
    $ tar -xvf gshhg-gmt-2.3.7.tar.gz
    $ tar -xvf dcw-gmt-1.1.3.tar.gz
 
    # 将gshhg和dcw数据复制到gmt的share目录下
-   $ mv gshhg-gmt-2.3.7 gmt-5.4.3/share/gshhg
-   $ mv dcw-gmt-1.1.3 gmt-5.4.3/share/dcw-gmt
+   $ mv gshhg-gmt-2.3.7 gmt-5.4.4/share/gshhg
+   $ mv dcw-gmt-1.1.3 gmt-5.4.4/share/dcw-gmt
 
    # 切换到gmt源码目录下
-   $ cd gmt-5.4.3
+   $ cd gmt-5.4.4
 
    # 新建用户配置文件
    $ gedit cmake/ConfigUser.cmake
 
 向 ``cmake/ConfigUser.cmake`` 文件中加入如下语句::
 
-    set (CMAKE_INSTALL_PREFIX "/opt/GMT-5.4.3")
+    set (CMAKE_INSTALL_PREFIX "/opt/GMT-5.4.4")
     set (GMT_INSTALL_MODULE_LINKS FALSE)
     set (COPY_GSHHG TRUE)
     set (COPY_DCW TRUE)
@@ -121,8 +121,8 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 其中，
 
 - ``CMAKE_INSTALL_PREFIX`` 用于设置GMT的安装路径，上面的语句会将GMT安装在
-  ``/opt/GMT-5.4.3`` 目录下，用户可以自行修改为其他路径。没有 root 权限的
-  一般用户，可以将安装路径设置为 ``/home/xxx/software/GMT-5.4.3`` 等有可读写
+  ``/opt/GMT-5.4.4`` 目录下，用户可以自行修改为其他路径。没有 root 权限的
+  一般用户，可以将安装路径设置为 ``/home/xxx/software/GMT-5.4.4`` 等有可读写
   权限的路径；
 - ``GMT_INSTALL_MODULE_LINKS`` 为FALSE，表明不在GMT的bin目录下建立命令的软链接，
   也可设置为TRUE
@@ -144,16 +144,16 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 
 继续执行如下命令以检查GMT的依赖关系::
 
-    # 注意，此处新建的 build 文件夹位于 gmt-5.4.3 目录下，不是 gmt-5.4.3/cmake 目录下
+    # 注意，此处新建的 build 文件夹位于 gmt-5.4.4 目录下，不是 gmt-5.4.4/cmake 目录下
     $ mkdir build
     $ cd build/
     $ cmake ..
 
 ``cmake ..`` 会检查GMT对软件的依赖关系，我的检查结果如下::
 
     *  Options:
-    *  Found GSHHG database       : /home/user/GMT/gmt-5.4.3/share/gshhg (2.3.7)
-    *  Found DCW-GMT database     : /home/user/GMT/gmt-5.4.3/share/dcw-gmt
+    *  Found GSHHG database       : /home/user/GMT/gmt-5.4.4/share/gshhg (2.3.7)
+    *  Found DCW-GMT database     : /home/user/GMT/gmt-5.4.4/share/dcw-gmt
     *  NetCDF library             : /usr/lib64/libnetcdf.so
     *  NetCDF include dir         : /usr/include
     *  GDAL library               : /usr/lib64/libgdal.so
@@ -178,10 +178,10 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
     *  Build proto supplements    : none
     *
     *  Locations:
-    *  Installing GMT in          : /opt/GMT-5.4.3
-    *  GMT_DATADIR                : /opt/GMT-5.4.3/share
-    *  GMT_DOCDIR                 : /opt/GMT-5.4.3/share/doc
-    *  GMT_MANDIR                 : /opt/GMT-5.4.3/share/man
+    *  Installing GMT in          : /opt/GMT-5.4.4
+    *  GMT_DATADIR                : /opt/GMT-5.4.4/share
+    *  GMT_DOCDIR                 : /opt/GMT-5.4.4/share/doc
+    *  GMT_MANDIR                 : /opt/GMT-5.4.4/share/man
     -- Configuring done
     -- Generating done
 
@@ -208,7 +208,7 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 
 .. code-block:: bash
 
-   $ echo 'export GMT5HOME=/opt/GMT-5.4.3' >> ~/.bashrc
+   $ echo 'export GMT5HOME=/opt/GMT-5.4.4' >> ~/.bashrc
    $ echo 'export PATH=${GMT5HOME}/bin:$PATH' >> ~/.bashrc
    $ echo 'export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${GMT5HOME}/lib64' >> ~/.bashrc
    $ exec $SHELL -l
@@ -226,4 +226,4 @@ Linux安装GMT需要下载三个文件（这里提供的国内下载源）：
 在终端键入 ``gmt`` ，若出现如下输出，则安装成功::
 
     $ gmt --version
-    5.4.3
+    5.4.4
diff --git a/source/install/macOS.rst b/source/install/macOS.rst
@@ -26,7 +26,7 @@ macOS 下 GMT 的安装方法有很多，可以直接使用安装包，也可以
 4.  测试安装是否成功::
 
        $ gmt --version
-       5.4.3
+       5.4.4
 
 如果想同时安装 GMT4 和 GMT5，还需要执行以下步骤::
 
@@ -59,20 +59,20 @@ macOS 下 GMT 的安装方法有很多，可以直接使用安装包，也可以
 
 GMT 为 macOS 用户提供了 dmg 安装包。
 
-1. 到社区主页的 `下载页面 <http://gmt-china.org/download/>`_ 下载最新版本的 dmg 安装包。
+1. 到社区主页的 `下载页面 <https://gmt-china.org/download/>`_ 下载最新版本的 dmg 安装包。
 
-2. 双击 dmg 包以解压，将解压得到的 ``GMT-5.4.3.app`` 拖动到 Applications 目录即可。
+2. 双击 dmg 包以解压，将解压得到的 ``GMT-5.4.4.app`` 拖动到 Applications 目录即可。
 
-3. GMT 默认会安装到 ``/Applications/GMT-5.4.3.app/`` 目录下，将如下语句::
+3. GMT 默认会安装到 ``/Applications/GMT-5.4.4.app/`` 目录下，将如下语句::
 
-       export PATH=${PATH}:/Applications/GMT-5.4.3.app/Contents/Resources/bin
+       export PATH=${PATH}:/Applications/GMT-5.4.4.app/Contents/Resources/bin
 
    加入到 ``~/.bashrc`` 中即可。
 
 4. 测试安装是否成功::
 
        $ gmt --version
-       5.4.3
+       5.4.4
 
 使用 macports 安装
 ------------------

diff --git a/source/install/windows.rst b/source/install/windows.rst
@@ -24,7 +24,7 @@ ghostscript 和 gsview。
 
 1. 下载
 
-   到社区主页的 `下载页面 <http://gmt-china.org/download/>`_ 下载所需要的安装包。
+   到社区主页的 `下载页面 <https://gmt-china.org/download/>`_ 下载所需要的安装包。
 
 2. 安装GMT
 
@@ -46,7 +46,7 @@ ghostscript 和 gsview。
    安装完成后，“开始”->“所有程序”->“附件”->“命令提示符”以启动cmd。在cmd窗口中执行::
 
        C:\Users\xxxx> gmt --version
-       5.4.3
+       5.4.4
 
    即表示安装成功。
 
@@ -87,7 +87,7 @@ ghostscript 和 gsview。
 
 欢迎补充，请参考：
 
-#. http://gmt.soest.hawaii.edu/doc/5.4.3/GMT_Docs.html#cygwin-and-gmt
+#. http://gmt.soest.hawaii.edu/doc/5.4.4/GMT_Docs.html#cygwin-and-gmt
 #. http://gmt.soest.hawaii.edu/projects/gmt/wiki/BuildingGMT#Cygwin
 
 在 MSYS2 中安装

diff --git a/source/intro/overview.rst b/source/intro/overview.rst
@@ -15,16 +15,16 @@ GMT的历史
 - 1988年，Paul Wessel和Walter H.F. Smith开发了GMT的最原始版本GMT 1.0
 - 1991年8月10日，GMT 2.0发布
 - 1998年11月8日，GMT 3.x的第一个正式版发布
-- 2005年10月1日，GMT 4.x的第一个正式版发布；目前最新版本 GMT |GMT4_latest_release|
-  发布于  |GMT4_latest_release_date|
+- 2005年10月1日，GMT 4.x的第一个正式版发布；GMT4.x系列的最后一个版本是
+  GMT 4.5.18，发布于2018年7月1日；
 - 2013年11月5日，GMT 5.x的第一个正式版发布；目前最新版本 GMT |GMT5_latest_release|
   发布于  |GMT5_latest_release_date|
 
 GMT维护者
 ---------
 
 .. figure:: /static_images/GMT5_Summit_2016.jpg
-   :width: 1200 px
+   :width: 100%
    :align: center
 
    GMT目前的5个维护者：Joaquim Luis、Walter H.F. Smith、Remko Scharroo、Florian Wobbe 和 Paul Wessel

diff --git a/source/intro/self-learning.rst b/source/intro/self-learning.rst
@@ -3,13 +3,13 @@ GMT学习资源
 
 GMT相关的学习资源列举如下。虽然官方文档都有对应的中文版本，但还是建议一切以官方英文版本为准。
 
-#. `GMT官方入门教程 <http://gmt.soest.hawaii.edu/doc/5.4.3/tutorial.html>`_
-#. `GMT官方参考手册 <http://gmt.soest.hawaii.edu/doc/5.4.3/GMT_Docs.html>`_
+#. `GMT官方入门教程 <http://gmt.soest.hawaii.edu/doc/5.4.4/tutorial.html>`_
+#. `GMT官方参考手册 <http://gmt.soest.hawaii.edu/doc/5.4.4/GMT_Docs.html>`_
 #. `GMT中文参考手册 <https://docs.gmt-china.org>`_
-#. `GMT官方模块手册 <http://gmt.soest.hawaii.edu/doc/5.4.3/index.html#man-pages>`_
+#. `GMT官方模块手册 <http://gmt.soest.hawaii.edu/doc/5.4.4/index.html#man-pages>`_
 #. `GMT中文模块手册 <https://modules.gmt-china.org>`_
-#. `GMT官方示例 <http://gmt.soest.hawaii.edu/doc/5.4.3/Gallery.html>`_
-#. `GMT中文社区示例 <http://gmt-china.org/gallery/>`_
+#. `GMT官方示例 <http://gmt.soest.hawaii.edu/doc/5.4.4/Gallery.html>`_
+#. `GMT中文社区示例 <https://gmt-china.org/gallery/>`_
 #. `SeisMan博客 <https://blog.seisman.info/>`_
 #. :doc:`GMT开发版源码 </appendix/get-gmt-dev>` 中的测试脚本
 #. GMT学习QQ群：218905582

diff --git a/source/intro/versions.rst b/source/intro/versions.rst
@@ -24,12 +24,12 @@ GMT的版本号的格式为::
 GMT4 vs GMT5
 ------------
 
-GMT目前在同时维护GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
+GMT目前的主流版本有GMT4和GMT5两个大版本。用户是选择GMT4还是GMT5呢？
 
 GMT4的优缺点：
 
 - 已发布十年有余，功能相对成熟
-- 仅修复Bug，不再增加新功能，命令语法相对稳定
+- 已发布最终版本，不会再有任何更新与变化，命令语法稳定
 - 网络上的中文教程及示例多采用GMT4语法，新手学习起来更方便
 
 GMT5的优缺点：
@@ -55,4 +55,3 @@ GMT5的优缺点：
 
 PS：GMT4和GMT5可在系统中共存，因而完全可以同时安装两个版本，旧脚本不必修改，
 继续使用GMT4，新脚本则使用GMT5语法。
-