# Printable GMT documentation (manual & cookbook)

**URL:** <https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790>\
**Category:** Q&A\
**Created:** [April 9, 2022, 2:52am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790 "2022-04-09T02:52:31Z")\
**Posts on this page:** 17\
**Page:** 1

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [April 9, 2022, 2:52am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/1 "2022-04-09T02:52:31Z")

</div>

Hi, I understand the reasons for not providing pdf docs with v6, but I work in the field, largely offline for several months per year, so have used earlier versions with docs (manual & cookbook) I could print and take with me.

I’d like to move to v6, but this is an issue for me. As I understand it, even the man pages are no longer supported.

Does anyone know of a largely automated way I can generate printed docs from the online pages? Printing one page at a time is not really feasible.

Thanks,

Brent Wood

---

<div class="post-metadata">

**Author:** ![seisman](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/seisman/32/4_2.png) [@seisman](https://forum.generic-mapping-tools.org/u/seisman)\
**Post date:** [April 9, 2022, 4:00am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/2 "2022-04-09T04:00:15Z")

</div>

There is offline documentation (in HTML format) in the GMT’s share/doc/html directory.

If you move to GMT v6, you can simply type `gmt docs home` to visit the local HTML version of the documentation, or type `gmt docs basemap` to directly open the local documentation for the `basemap` module.

---

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [April 9, 2022, 4:41am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/3 "2022-04-09T04:41:40Z")

</div>

Thanks for replying.

Not here, GMT installed on Linux (Ubuntu) via apt. I can use gmt docs to open the online docs, but the local ones are not installed, or it seems, available via apt. Which I guess is a package issue more than a GMT one…

So short of a local compile of GMT (which I tend to regard as a last resort), any other suggestions?

---

<div class="post-metadata">

**Author:** ![seisman](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/seisman/32/4_2.png) [@seisman](https://forum.generic-mapping-tools.org/u/seisman)\
**Post date:** [April 9, 2022, 5:07am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/4 "2022-04-09T05:07:08Z")

</div>

The GMT version from Ubuntu apt is usually too old. For example, Ubuntu 20.04 is providing GMT 6.0.0 but the latest version is GMT 6.3.0. So installing GMT via apt is not recommended.

If you’re an Anaconda user, you can install GMT using `conda install gmt -c conda-forge`, which also provides the local version of the documentation.

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [April 9, 2022, 7:33am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/5 "2022-04-09T07:33:38Z")

</div>

Will a ‘make pdf’ give good and printable result in sphinx?

If so, I can build the docs and send you. Give me a ping.

---

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [April 9, 2022, 11:37pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/6 "2022-04-09T23:37:35Z")

</div>

Sounds good to me, if you can that would be great, much appreciated. I regularly use the main user manual & the cookbook.

Thanks

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [April 10, 2022, 9:23am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/7 "2022-04-10T09:23:13Z")

</div>

Turned out it was a bit more difficult than I remembered. Will see what I can do. When time permits…

---

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [April 10, 2022, 7:46pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/8 "2022-04-10T19:46:11Z")

</div>

Not a problem, I appreciate the effort!!

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [April 11, 2022, 10:04am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/9 "2022-04-11T10:04:49Z")

</div>

I built the docs as html. Basically the same as you get when going to [The Generic Mapping Tools Documentation — GMT 6.6.0 documentation](https://docs.generic-mapping-tools.org/dev/index.html).

I wanted to try building it as pdf, but ran into some issues, unfortunately.

Here’s the download link:  
[https://www.dropbox.com/s/ege0sz8vqu4ioeh/220411-gmt-docs-dev-6.4.zip?dl=0](https://www.dropbox.com/s/ege0sz8vqu4ioeh/220411-gmt-docs-dev-6.4.zip?dl=0)

Hope it can be of some help (and use).

---

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [May 11, 2022, 10:39pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/10 "2022-05-11T22:39:27Z")

</div>

Hi Andreas,

Many thanks for this!!!

But my apologies, I have been working at sea without internet access… back early due to some vessel mechanical repairs but the document has been deleted from dropbox before I could download it.

Could it be re-posted? Please note I’m not sure how long I’ll be on shore for, as I’ll be back out as soon as the repairs are complete.

Thanks,

Brent

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [May 12, 2022, 5:05am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/11 "2022-05-12T05:05:17Z")

</div>

No problem. Please try again now.

---

<div class="post-metadata">

**Author:** ![Joaquim](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/joaquim/32/16_2.png) [@Joaquim](https://forum.generic-mapping-tools.org/u/Joaquim)\
**Post date:** [May 12, 2022, 2:16pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/12 "2022-05-12T14:16:17Z")

</div>

The Windows installer comes with the full documentation included.

---

<div class="post-metadata">

**Author:** ![Brent](https://avatars.discourse-cdn.com/v4/letter/b/ec9cab/32.png) [@Brent](https://forum.generic-mapping-tools.org/u/Brent)\
**Post date:** [May 12, 2022, 10:55pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/13 "2022-05-12T22:55:42Z")

</div>

Thanks Joaquim, I don’t use Windows much. Generally I find that working on Linux is much more productive.

Andreas’s zip works perfectly on my Linux system, so I appreciate that effort!!

---

<div class="post-metadata">

**Author:** ![jjavediqbal](https://avatars.discourse-cdn.com/v4/letter/j/5f9b8f/32.png) [@jjavediqbal](https://forum.generic-mapping-tools.org/u/jjavediqbal)\
**Post date:** [July 4, 2023, 5:37am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/14 "2023-07-04T05:37:05Z")

</div>

Hi Andreas,

Can you please share docs file again for downloading.  
Thanks in Advance

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [July 4, 2023, 7:59am UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/15 "2023-07-04T07:59:58Z")

</div>

Hi jjavediqbal,

Could you try one of the following:

- There was a similar issue about this on github, see [here](https://github.com/GenericMappingTools/gmt/issues/7597).
- [Here](https://github.com/GenericMappingTools/gmt/issues/7597#issuecomment-1617751212)’s a command that will download the docs and make a local copy using `wget`.
- [Here](https://github.com/GenericMappingTools/gmt/issues/7597#issuecomment-1618232704)’s another way.

If you’re not able to get the docs using these tips, let me know and I’ll upload an archive for you and share.

---

<div class="post-metadata">

**Author:** ![Andreas](https://avatars.discourse-cdn.com/v4/letter/a/ee7513/32.png) [@Andreas](https://forum.generic-mapping-tools.org/u/Andreas)\
**Post date:** [July 20, 2023, 8:07pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/16 "2023-07-20T20:07:11Z")

</div>

Good news.

There was a [request](https://github.com/GenericMappingTools/gmt/issues/7597) for a way to download the documentation.  
Thanks to [this](https://github.com/GenericMappingTools/gmt/pull/7650) PR, the docs are now available as a zip file.

 ![Screenshot 2023-07-20 220546](https://canada1.discourse-cdn.com/flex047/uploads/gmt/original/2X/9/958b82d313de2e64a2493eb42ced55a899a957d2.png)

---

<div class="post-metadata">

**Author:** ![John\_Geodesy](https://yyz1.discourse-cdn.com/flex047/user_avatar/forum.generic-mapping-tools.org/john_geodesy/32/116_2.png) [@John\_Geodesy](https://forum.generic-mapping-tools.org/u/John_Geodesy)\
**Post date:** [July 21, 2023, 9:31pm UTC](https://forum.generic-mapping-tools.org/t/printable-gmt-documentation-manual-cookbook/2790/17 "2023-07-21T21:31:22Z")

</div>

This is great. I was able to create a PDF of the documentation HTML inside of Acrobat. I requested landscape orientation and the PDF is almost 3000 pages long and weighs-in at 82.5 MB. After Acrobat file compression, it comes to 24.5 MB. I won’t be printing it any time soon! But the PDF might come in handy (e.g., loss of internet connection or remote working). Links were retained.
