1. 文档如何发布？
2. 发布的HTML版和PDF版文档如何提供下载链接？
3. 旧版本的HTML和PDF如何处理？

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#switching-between-different-gmt-versions

1. http://gmt.soest.hawaii.edu/doc/latest/gmt.html#aspatial-full
2. http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#ogr-gmt-gis-i-o-the-a-option

1. sphinx自带的模板比较符合英文的书籍，对于中文并不特别合适
2. 由于Python2的中文编码问题，latex_elements中的preamble中若含有中文，则需要使用类似ur'''xxx'''的语法，似乎Python2不支持
3. 自定义的模板可以更符合项目的需求

两种方式:

1. 所有脚本放在 scripts 目录下，统一命名
2. 脚本放在各自章节目录下

1. http://gmt.soest.hawaii.edu/doc/latest/GMT_Tutorial.html
2. GMT之路
3. http://gmt.soest.hawaii.edu/projects/gmt/repository/show/trunk/doc/tutorial
4. http://gmt.soest.hawaii.edu/projects/gmt/repository/show/trunk/doc/scripts (GMT_tut*.sh)

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#the-gmt-vector-data-format-for-ogr-compatibility

5.4.5的5个示例： http://gmt.soest.hawaii.edu/doc/5.4.5/Gallery.html#animations
6.0.0的7个示例: http://www.generic-mapping-tools.org/gmt/dev/Gallery.html#animations

1. http://gmt.soest.hawaii.edu/doc/5.2.1/julia_wrapper.html
2. https://github.com/joa-quim/GMT.jl
3. http://gmt.soest.hawaii.edu/projects/gmt/repository/show/trunk/doc/scripts/ml

http://gmt.soest.hawaii.edu/doc/latest/GMT_API.html

需要注意：

Linux和macOS下字体名为:

39 STSong-Light-UniGB-UTF8-H
40 STFangsong-Light-UniGB-UTF8-H
41 STHeiti-Regular-UniGB-UTF8-H
42 STKaiti-Regular-UniGB-UTF8-H

Windows下字体名为:

39 STSong-Light-GB-EUC-H
40 STFangsong-Light-GB-EUC-H
41 STHeiti-Regular-GB-EUC-H
42 STKaiti-Regular-GB-EUC-H

#125 adds some histogram plots to gallery. However, the horizontal histogram example doesn't work for GMT 6.0.0.

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#color-space-the-final-frontier

目前文档中有很多示例，某些示例是以脚本的形式给出的，这种示例可以直接运行以进行测试。而某些示例是直接以单行代码的形式出现在文档中的，这些示例在最初是经过测试的，但是一旦GMT版本有更新，这些示例能否正常运行则无法确认。

两种解决办法：

1. 所有示例均写到脚本中，不管是一行还是两行
2. 写一个单独的脚本，搜索文档中的所有示例，然后依次执行这些示例

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#annotation-of-contours-and-quoted-lines

source/scripts 目录下几乎所有脚本的文件名都是以 GMT_ 开头，这是完全没有必要的，可以全部重命名，删除开头的 GMT_。由于脚本生成的图片要与脚本同名，所以，脚本内部的图片名也需要修改。同时 rst 文件中插入脚本及图片的地方也需要修改。

• 重命名所有脚本
• 重命名所有图片
• 更正正文中的脚本和图片名

需要测试在不同机器下的可移植性。

1. 已经支持GMT中文的Linux机器
2. 尚未支持GMT中文的Linux机器
3. 已经支持GMT中文的Windows机器
4. 尚未支持GMT中文的Windows机器
5. 已经支持GMT中文的macOS机器
6. 尚未支持GMT中文的macOS机器

需要做如下测试：

1. gs是否可以正常查看PS文件
2. 系统常用PDF阅读器是否可以正常查看PS文件
3. Windows下Adobe Illustrator是否能够正常打开PDF文件

鉴于需要测试的情况较多，可以考虑在将带有中文的PS、PDF文件上传到群中，由大家帮助测试。

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#app-custom-symbols

1. 介绍如何选择投影方式
2. 整理各个投影方式的说明文档

是否需要在特殊字体说明页面增加调用方式的介绍！

https://docs.gmt-china.org/basic/special-fonts/

http://docs.gmt-china.org/vectors.html

给出具体的示例代码，以展示如何绘制三种不同的矢量。

In first-plot.rst at line 60: -Sa/0.5c should be -Sa0.5c

参考：

1. https://seisman.info/gmt-chinese-support-under-windows.html
2. https://seisman.info/gmt-chinese-under-linux.html

在手册中加入一节介绍 Bash、awk 的基础用法，可以参考 https://learnxinyminutes.com/docs/zh-cn/bash-cn/

Build log: https://travis-ci.org/gmt-china/GMT_docs/builds/139090394

http://gmt.soest.hawaii.edu/doc/latest/postscriptlight.html

Edit on GitHub 链接莫名其妙的少了个 edit
正确链接应为：
https://github.com/gmt-china/GMT_Docs/edit/master/source/index.rst
实际链接为：
https://github.com/gmt-china/GMT_Docs//master/source/index.rst

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#filtering-of-data-in-gmt

• 完善部分简单示例代码：线条 符号 海岸线

• 新添示例代码种类: 绘制双 Y 轴， 绘制速度分布图等

Sphinx支持的格式众多，发布文档时会发布如下格式：

1. HTML
2. PDF
3. epub

1. gmt已经从homebrew/science中移到了 homebrew/core 中
2. homebrew的gmt4和gmt不再存在冲突，但安装两个之后只能使用GMT5版本
3. 是否可能修改gmt的formulae使得其安装时支持额外的选项

master CPT 是 GMT 5.3 新增的内容，见 http://gmt.soest.hawaii.edu/doc/5.3.3/GMT_Docs.html#master-dynamic-cpts

1. http://gmt.soest.hawaii.edu/doc/5.2.1/matlab_wrapper.html
2. http://gmt.soest.hawaii.edu/projects/gmt-matlab-octave-api/wiki
3. http://gmt.soest.hawaii.edu/projects/gmt/repository/show/trunk/doc/scripts/ml

GMT 5.3.0中关于 matlab 接口有更新，因而需要更新文档。

这里是文档更新到 GMT6 的待完善列表。需要在6正式发布后，6版本的文档最终发布前，最后写的内容列举如下：

目前源码中指定的是图片的绝对大小，例如 900px，这样做在生成PDF时会有较多问题，应改为相对大小，比如 90%。

• 联系数据发布者，确认是否可以公开以及是否有数据来源（比如从哪篇文章中的图数字化得到）
• 整理数据，删除不需要的部分，修改使之符号GMT要求
• 数据段中加入地块名称信息，使得数据本身更加完整
• 写脚本展示其用法，以及绘图效果
• 写博文

目前，安装教程还不够完整，至少缺乏以下三点：
1.构建 GMT 数据库的指引
2. 常见问题的预防针（紫斑兔用户的阅读器显示倒转等问题）
3. Mac 的中文支持

对于以上三点，我目前只掌握 Linux 系统的数据库构建 http://seisman.info/gmt-setup-database.html 。
Mac 的中文支持最近会研究。

我已經开了新分支fixinstall

need to change modules' names for @gmt6.

All works about it please try to merge into #82

• psxy => plot
• psxyz => plot3d
• psscale => colorbar
• pscoast => coast
• psconvert
• ps2raster
• pssolar
• psbasemap
• psclip
• pshistogram
• pstext
• pslegend
• psrose
• pssac
• psmeca
• pspolar
• psvelo
• pscoupe
• psimage
• pscontour
• pssegy
• pssegyz
• pswiggle

在GMT6发布之后，将会有若干年的时间存在GMT5和GMT6共存的情况，这涉及到文档的多版本问题。可能的处理方式列举如下。

只保留GMT6最新版

此做法比较激进，GMT_docs, GMT_modules, gmt-china.org 三者均完全使用 GMT6 的最新语法。此做法也是最为简单的办法。

保留GMT5和GMT6两个版本

保留多个版本有两个方式：

1. 多repo，GMT5和GMT6分别位于不同的repo，问题在于需要同时维护两个版本的文档，较为复杂；
2. 多分支，GMT6位于master分支，GMT5位于gmt5分支；

保留多个版本后需要考虑的主要问题有两点：

1. 如何同时维护两个版本的文档；
2. 两个版本或多个版本如何设置网址；

关于网址的几种选择：

1. GMT6使用docs.gmt-china.org；GMT5使用某个任意网址，例如 gmt5-docs.gmt-china.org
2. 统一使用 docs.gmt-china.org，链接风格为 docs.gmt-china.org/VERSION/xxx，其中VERSION 可以取 5.4.3, 6.0.0, latest 或者为空，其中 VERSION 取 latest 或空都指向最新版本的文档。其效果类似于 READTHEDOCS这个网站提供的 http://gmt-docs.readthedocs.io/zh_CN/latest/ http://gmt-docs.readthedocs.io/zh_CN/5.3.3/ ，唯一的区别在于链接中没有语言 zh_CN 的信息

文字大小：http://docs.gmt-china.org/text.html#id2

参考资料：

1. 维基百科中给出了中文字号与point之间的关系： https://en.wikipedia.org/wiki/Point_%28typography%29#Point-size_names
2. ctex宏包文档中的图
   

http://gmt.soest.hawaii.edu/doc/latest/GMT_Docs.html#modifiers-to-read-and-write-grids-and-images-via-gdal