Skip to content

Commit

Permalink
Bump GMT version (#1277)
Browse files Browse the repository at this point in the history
* Bump GMT version

* Update fedora.rst
  • Loading branch information
ZMAlt committed Feb 13, 2024
1 parent 218473d commit e2a0a72
Show file tree
Hide file tree
Showing 17 changed files with 54 additions and 53 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/cache-data.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ jobs:
- conda-forge
- nodefaults
create-args: >-
gmt=6.4.0
gmt=6.5.0
- name: Download data and change configurations
run: bash scripts/setup-ci.sh
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ jobs:
deploy:
runs-on: ubuntu-latest
env:
GMT_DOC_VERSION: 6.4
GMT_DOC_VERSION: 6.5

defaults:
run:
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<!-- ALL-CONTRIBUTORS-BADGE:END -->

[![Deploy](https://github.com/gmt-china/GMT_docs/actions/workflows/deploy.yml/badge.svg)](https://github.com/gmt-china/GMT_docs/actions/workflows/deploy.yml)
[![Documentation version](https://img.shields.io/badge/版本-v6.4-blue.svg)](https://docs.gmt-china.org/latest/)
[![Documentation version](https://img.shields.io/badge/版本-v6.5-blue.svg)](https://docs.gmt-china.org/latest/)
![Repository size](https://img.shields.io/github/repo-size/gmt-china/GMT_Docs)
[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC%20BY--NC%204.0-blue.svg)](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans)

Expand Down
2 changes: 1 addition & 1 deletion environment.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ channels:
- conda-forge
- nodefaults
dependencies:
- gmt=6.4.0
- gmt=6.5.0
- gawk
- sphinx
- sphinx-copybutton
Expand Down
2 changes: 1 addition & 1 deletion source/GMT_style.sty
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
% 文档相关信息
\newcommand{\GMTDOCTITLE}{GMT\textbf{中文手册}} % 文档标题
\newcommand{\GMTDOCAUTHOR}{GMT中文社区} % 文档作者
\newcommand{\GMTDOCVERSION}{6.4} % 文档版本
\newcommand{\GMTDOCVERSION}{6.5} % 文档版本
\newcommand{\GMTCHINAURL}{https://gmt-china.org/} % 社区网站

% sphinx已经载入hyperref
Expand Down
1 change: 1 addition & 0 deletions source/_static/version_switch.js
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
// Add one entry "version: title" for any minor releases
var all_versions = {
'latest': 'latest',
'6.5': '6.5',
'6.4': '6.4',
'6.3': '6.3',
'6.2': '6.2',
Expand Down
2 changes: 1 addition & 1 deletion source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
github_user = "gmt-china"
github_repo = "GMT_docs"
github_url = f"https://github.com/{github_user}/{github_repo}"
version = "6.4"
version = "6.5"
release = version

# -- Contributor information ---------------------------------------------
Expand Down
4 changes: 2 additions & 2 deletions source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -49,8 +49,8 @@ GMT 是地球科学使用最广泛的制图软件之一。
:columns: 3

- `GMT 中文手册源码 <https://github.com/gmt-china/GMT_docs>`__
- `GMT 中文手册 PDF <https://docs.gmt-china.org/6.4/GMT_docs.pdf>`__
- `GMT 中文手册 HTML ZIP <https://docs.gmt-china.org/6.4/GMT_docs.zip>`__
- `GMT 中文手册 PDF <https://docs.gmt-china.org/6.5/GMT_docs.pdf>`__
- `GMT 中文手册 HTML ZIP <https://docs.gmt-china.org/6.5/GMT_docs.zip>`__

.. toctree::
:maxdepth: 3
Expand Down
42 changes: 21 additions & 21 deletions source/install/build-source-unix.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖

编译 GMT 需要下载如下三个文件:

#. GMT 6.4.0 源码:`gmt-6.4.0-src.tar.xz <http://mirrors.ustc.edu.cn/gmt/gmt-6.4.0-src.tar.xz>`_
#. GMT 6.5.0 源码:`gmt-6.5.0-src.tar.xz <http://mirrors.ustc.edu.cn/gmt/gmt-6.5.0-src.tar.xz>`_
#. 全球海岸线数据 GSHHG:`gshhg-gmt-2.3.7.tar.gz <http://mirrors.ustc.edu.cn/gmt/gshhg-gmt-2.3.7.tar.gz>`_
#. 全球数字图表 DCW:`dcw-gmt-2.1.2.tar.gz <https://github.com/GenericMappingTools/dcw-gmt/releases/download/2.1.2/dcw-gmt-2.1.2.tar.gz>`_

Expand All @@ -89,16 +89,16 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
将下载的三个压缩文件放在同一个目录里,按照如下步骤进行安装::

# 解压三个压缩文件
$ tar -xvf gmt-6.4.0-src.tar.xz
$ tar -xvf gmt-6.5.0-src.tar.xz
$ tar -xvf gshhg-gmt-2.3.7.tar.gz
$ tar -xvf dcw-gmt-2.1.2.tar.gz

# 将 gshhg 和 dcw 数据复制到 gmt 的 share 目录下
$ mv gshhg-gmt-2.3.7 gmt-6.4.0/share/gshhg-gmt
$ mv dcw-gmt-2.1.2 gmt-6.4.0/share/dcw-gmt
$ mv gshhg-gmt-2.3.7 gmt-6.5.0/share/gshhg-gmt
$ mv dcw-gmt-2.1.2 gmt-6.5.0/share/dcw-gmt

# 切换到 gmt 源码目录下
$ cd gmt-6.4.0
$ cd gmt-6.5.0

# 用文本编辑器新建并打开 CMake 用户配置文件
# Linux 用户
Expand All @@ -109,12 +109,12 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖

:file:`cmake/ConfigUser.cmake` 文件中加入如下语句::

set (CMAKE_INSTALL_PREFIX "/opt/GMT-6.4.0")
set (CMAKE_INSTALL_PREFIX "/opt/GMT-6.5.0")
set (GMT_USE_THREADS TRUE)

- **CMAKE_INSTALL_PREFIX** 用于设置 GMT 的安装路径,上面的语句会将 GMT 安装在
:file:`/opt/GMT-6.4.0` 目录下,用户可以自行修改为其他路径。没有 root 权限的
一般用户,可以将安装路径设置为 :file:`/home/xxx/opt/GMT-6.4.0` 等有可读写
:file:`/opt/GMT-6.5.0` 目录下,用户可以自行修改为其他路径。没有 root 权限的
一般用户,可以将安装路径设置为 :file:`/home/xxx/opt/GMT-6.5.0` 等有可读写
权限的路径
- **GMT_USE_THREADS** 设置为 **TRUE** 会为 GMT 的某些模块增加多线程并行功能以加速计算,
也可以不设置
Expand All @@ -132,8 +132,8 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
.. note::

以下的 ``mkdir build`` 命令新建的 :file:`build` 文件夹位于 GMT 源码压缩包
解压出来的 :file:`gmt-6.4.0` 目录下。
不是 :file:`gmt-6.4.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.4.0`。
解压出来的 :file:`gmt-6.5.0` 目录下。
不是 :file:`gmt-6.5.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.5.0`。

::

Expand All @@ -148,11 +148,11 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
继续执行 ``cmake .. -G Ninja``,直到出现类似的检查结果::

*
* GMT Version: : 6.4.0
* GMT Version: : 6.5.0
*
* Options:
* Found GSHHG database : /home/user/GMT/gmt-6.4.0/share/gshhg (2.3.7)
* Found DCW-GMT database : /home/user/GMT/gmt-6.4.0/share/dcw-gmt (2.1.2)
* Found GSHHG database : /home/user/GMT/gmt-6.5.0/share/gshhg (2.3.7)
* Found DCW-GMT database : /home/user/GMT/gmt-6.5.0/share/dcw-gmt (2.1.2)
* Found GMT data server : oceania
* NetCDF library : /usr/lib/x86_64-linux-gnu/libnetcdf.so
* NetCDF include dir : /usr/include
Expand Down Expand Up @@ -190,10 +190,10 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
* Found gdal_translate : yes (3.0.4)
*
* Locations:
* Installing GMT in : /opt/GMT-6.4.0
* GMT_DATADIR : /opt/GMT-6.4.0/share
* GMT_DOCDIR : /opt/GMT-6.4.0/share/doc
* GMT_MANDIR : /opt/GMT-6.4.0/share/man
* Installing GMT in : /opt/GMT-6.5.0
* GMT_DATADIR : /opt/GMT-6.5.0/share
* GMT_DOCDIR : /opt/GMT-6.5.0/share/doc
* GMT_MANDIR : /opt/GMT-6.5.0/share/man
-- Configuring done
-- Generating done

Expand Down Expand Up @@ -226,7 +226,7 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
然后向文件末尾加入如下语句以修改环境变量。修改完成后保存文件并退出,
然后重启终端使其生效::

export GMT6HOME=/opt/GMT-6.4.0
export GMT6HOME=/opt/GMT-6.5.0
export PATH=${GMT6HOME}/bin:$PATH
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${GMT6HOME}/lib64

Expand All @@ -243,13 +243,13 @@ macOS 用户可以使用 `Homebrew <https://brew.sh>`__ 安装依赖
重新打开一个终端,键入如下命令,若正确显示 GMT 版本号,则表示安装成功::

$ gmt --version
6.4.0
6.5.0

升级/卸载 GMT
-------------

按照上面的配置,GMT 会被安装到 :file:`/opt/GMT-6.4.0` 目录下。若想要卸载 GMT,
可以直接删除整个 :file:`/opt/GMT-6.4.0` 即可。
按照上面的配置,GMT 会被安装到 :file:`/opt/GMT-6.5.0` 目录下。若想要卸载 GMT,
可以直接删除整个 :file:`/opt/GMT-6.5.0` 即可。

GMT 不支持自动更新,因而若想要升级 GMT,通常建议先卸载 GMT,然后再下载新版源码
并按照上面的步骤重新编译安装。
Expand Down
18 changes: 9 additions & 9 deletions source/install/build-source-windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这

编译 GMT 需要下载如下三个文件:

#. GMT 6.4.0 源码:`gmt-6.4.0-src.tar.gz <http://mirrors.ustc.edu.cn/gmt/gmt-6.4.0-src.tar.gz>`__
#. GMT 6.5.0 源码:`gmt-6.5.0-src.tar.gz <http://mirrors.ustc.edu.cn/gmt/gmt-6.5.0-src.tar.gz>`__
#. 全球海岸线数据 GSHHG:`gshhg-gmt-2.3.7.tar.gz <http://mirrors.ustc.edu.cn/gmt/gshhg-gmt-2.3.7.tar.gz>`__
#. 全球数字图表 DCW:`dcw-gmt-2.1.2.tar.gz <https://mirrors.ustc.edu.cn/gmt/dcw-gmt-2.1.2.tar.gz>`__

Expand All @@ -85,16 +85,16 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
将下载的三个压缩文件放在同一个目录里。打开 Git Bash,并按照如下步骤进行安装::

# 解压三个压缩文件
$ tar -xvf gmt-6.4.0-src.tar.gz
$ tar -xvf gmt-6.5.0-src.tar.gz
$ tar -xvf gshhg-gmt-2.3.7.tar.gz
$ tar -xvf dcw-gmt-2.1.2.tar.gz

# 将 gshhg 和 dcw 数据复制到 gmt 的 share 目录下
$ mv gshhg-gmt-2.3.7 gmt-6.4.0/share/gshhg-gmt
$ mv dcw-gmt-2.1.2 gmt-6.4.0/share/dcw-gmt
$ mv gshhg-gmt-2.3.7 gmt-6.5.0/share/gshhg-gmt
$ mv dcw-gmt-2.1.2 gmt-6.5.0/share/dcw-gmt

# 切换到 gmt 源码目录下
$ cd gmt-6.4.0
$ cd gmt-6.5.0

打开 :file:`cmake` 目录,在其中创建文件 :file:`cmake/ConfigUser.cmake`,
并向文件中加入如下语句::
Expand All @@ -118,8 +118,8 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
.. note::

以下的 ``mkdir build`` 命令新建的 :file:`build` 文件夹位于 GMT 源码压缩包
解压出来的 :file:`gmt-6.4.0` 目录下。
不是 :file:`gmt-6.4.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.4.0`。
解压出来的 :file:`gmt-6.5.0` 目录下。
不是 :file:`gmt-6.5.0/cmake` 目录下,更不是 :file:`/opt/GMT-6.5.0`。

::

Expand All @@ -137,7 +137,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
继续执行 ``cmake ..``,直到出现类似的检查结果::

*
* GMT Version: : 6.4.0
* GMT Version: : 6.5.0
*
* Options:
* Found GSHHG database : D:/a/gmt/gmt/coastline/gshhg (2.3.7)
Expand Down Expand Up @@ -203,7 +203,7 @@ Windows 下可以通过 C++ 库管理器 `vcpkg <https://vcpkg.io>`__ 安装这
启动 CMD,键入如下命令,若正确显示 GMT 版本号,则表示安装成功::

$ gmt --version
6.4.0
6.5.0

升级/卸载 GMT
-------------
Expand Down
2 changes: 1 addition & 1 deletion source/install/conda.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Anaconda 的 base 环境下默认安装了数百个软件包,其中部分软
::

$ gmt --version
6.4.0
6.5.0

升级 GMT
--------
Expand Down
14 changes: 7 additions & 7 deletions source/install/macOS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ macOS 下安装 GMT 有多种方式:
重新打开一个终端,键入如下命令,若正确显示 GMT 版本号,则表示安装成功::

$ gmt --version
6.4.0
6.5.0

4. 升级 GMT

Expand All @@ -79,10 +79,10 @@ Ghostscript、GDAL、GraphicsMagick 和 FFmpeg,可以直接双击安装使用

1. 下载

- Intel:`gmt-6.4.0-darwin-x86_64.dmg <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.4.0-darwin-x86_64.dmg>`__
- ARM:`gmt-6.4.0-darwin-arm64.dmg <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.4.0-darwin-arm64.dmg>`__
- Intel:`gmt-6.5.0-darwin-x86_64.dmg <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.5.0-darwin-x86_64.dmg>`__
- ARM:`gmt-6.5.0-darwin-arm64.dmg <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.5.0-darwin-arm64.dmg>`__

2. 双击 dmg 包,在弹出的 Finder 窗口中,将 :file:`GMT-6.4.0.app` 拖动到 :file:`Applications` 目录
2. 双击 dmg 包,在弹出的 Finder 窗口中,将 :file:`GMT-6.5.0.app` 拖动到 :file:`Applications` 目录

3. 在 Finder 的左侧边栏中点击 **Applications**,找到 GMT 图标并右键点击,
按下 :kbd:`option` 键的同时鼠标点击“Open”选项。
Expand All @@ -92,7 +92,7 @@ Ghostscript、GDAL、GraphicsMagick 和 FFmpeg,可以直接双击安装使用
4. GMT 会启动一个终端并显示欢迎信息。根据欢迎信息中的
提示将如下语句添加到 :file:`~/.zshrc` 中以修改环境变量::

export GMTHOME=/Applications/GMT-6.4.0.app/Contents/Resources
export GMTHOME=/Applications/GMT-6.5.0.app/Contents/Resources
export PATH=${GMTHOME}/bin:${PATH}
export PROJ_LIB=$GMTHOME/share/proj
export GS_LIB=$GMTHOME/share/ghostscript/Resource/Init
Expand All @@ -105,7 +105,7 @@ Ghostscript、GDAL、GraphicsMagick 和 FFmpeg,可以直接双击安装使用
5. 打开一个终端,输入如下命令,检测安装是否成功::

$ gmt --version
6.4.0
6.5.0

6. 卸载 GMT

Expand Down Expand Up @@ -144,7 +144,7 @@ Ghostscript、GDAL、GraphicsMagick 和 FFmpeg,可以直接双击安装使用
4. 重新打开一个终端,检测安装是否成功::

$ gmt --version
6.4.0
6.5.0

5. 升级 GMT。当有新版本发布时,可以执行如下命令升级 GMT::

Expand Down
6 changes: 3 additions & 3 deletions source/install/windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ GMT 为 Windows 用户提供了 32 位和 64 位安装包,可以直接下载

1. 下载 GMT 安装包

- 64 位安装包:`gmt-6.4.0-win64.exe <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.4.0-win64.exe>`__
- 32 位安装包:`gmt-6.4.0-win32.exe <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.4.0-win32.exe>`__
- 64 位安装包:`gmt-6.5.0-win64.exe <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.5.0-win64.exe>`__
- 32 位安装包:`gmt-6.5.0-win32.exe <http://mirrors.ustc.edu.cn/gmt/bin/gmt-6.5.0-win32.exe>`__

GMT 安装包中不仅包含了 GMT,还包含了运行 GMT 所需的如下软件:

Expand Down Expand Up @@ -95,4 +95,4 @@ GMT 的强大功能。因而,建议 Windows 用户安装 Bash 环境并编写
4. `Windows Subsystem for Linux (WSL) <https://learn.microsoft.com/en-us/windows/wsl/>`__

用户可以根据自己的喜欢选择合适的 Bash 环境。对于不熟悉 Bash 环境的用户,可以直接安装
Git for Windows。
Git for Windows。
2 changes: 1 addition & 1 deletion source/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ GMT 的历史
- 1998 年 11 月 8 日,GMT3 发布
- 2005 年 10 月 1 日,GMT4 发布
- 2013 年 11 月 5 日,GMT5 发布
- 2019 年 11 月 1 日,GMT6 发布(目前最新版本 GMT 6.4.0 发布于 20220618 日)
- 2019 年 11 月 1 日,GMT6 发布(目前最新版本 GMT 6.5.0 发布于 20240107 日)

想了解更多关于 GMT 的历史故事,可以观看/收听下面的视频/音频:

Expand Down
2 changes: 1 addition & 1 deletion source/tutorial/get-started/linux.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ GMT 是一个纯命令行软件,没有任何的图形界面。所有的绘图

.. code-block:: console
GMT - The Generic Mapping Tools, Version 6.4.0 [64-bit] [8 cores]
GMT - The Generic Mapping Tools, Version 6.5.0 [64-bit] [8 cores]
(c) 1991-2021 The GMT Team (https://www.generic-mapping-tools.org/team.html).
Supported in part by the US National Science Foundation (http://www.nsf.gov/)
Expand Down
2 changes: 1 addition & 1 deletion source/tutorial/get-started/macos.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ macOS 下可以使用 :kbd:`Command + 空格键` 启动 Spotlight,在弹出的

.. code-block:: console
GMT - The Generic Mapping Tools, Version 6.4.0 [64-bit] [8 cores]
GMT - The Generic Mapping Tools, Version 6.5.0 [64-bit] [8 cores]
(c) 1991-2021 The GMT Team (https://www.generic-mapping-tools.org/team.html).
Supported in part by the US National Science Foundation (http://www.nsf.gov/)
Expand Down
2 changes: 1 addition & 1 deletion source/tutorial/get-started/windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ GMT 是一个纯命令行软件,没有任何的图形界面。所有的绘图

.. code-block:: console
GMT - The Generic Mapping Tools, Version 6.4.0 [64-bit] [8 cores]
GMT - The Generic Mapping Tools, Version 6.5.0 [64-bit] [8 cores]
(c) 1991-2021 The GMT Team (https://www.generic-mapping-tools.org/team.html).
Supported in part by the US National Science Foundation (http://www.nsf.gov/)
Expand Down

0 comments on commit e2a0a72

Please sign in to comment.