【问题标题】：Where can I find good documentation for Gtkmm?我在哪里可以找到 Gtkmm 的好文档？
【发布时间】：2021-04-25 01:06:33
【问题描述】：

似乎很难找到关于 Gtkmm 主题的高质量文档。

Gtkmm 有没有好的文档？如果有，在哪里可以找到？

【问题讨论】：

标签： gtk gtk3 gtkmm gtkmm3

【解决方案1】：

文档当然不是 Gtkmm 的强项。此外，Gtkmm API 从一个版本到另一个版本发生了很多变化，其中一些不向后兼容。但是，有一些信息来源值得了解。

Gtkmm 编程书

有空here。

正如网页解释的那样：

本书解释了用于创建用户界面的 gtkmm C++ API 的关键概念。它还介绍了主要的用户界面元素（“小部件”）。

所以这是一个有趣的介绍。此外，上面提供的链接提供了这本书的许多副本。因此，您可以阅读 Gtkmm 2.20.1 版和 4.0.1 版（以及其他版本）。这可能非常有用。

Gtkmm 参考手册

有空here。

正如网页解释的那样：

gtkmm 是流行的 GUI 库 GTK+ 的官方 C++ 接口。亮点包括类型安全的回调，以及一组可通过继承轻松扩展的全面小部件。

这是 Gtkmm API 文档。它基本上看起来像 Gtkmm 的 Doxygen 文档。它可能非常有用，但通常不完整。与 Programming with Gtkmm 页面一样，它提供了许多版本的 API 文档。当您遇到 API 兼容性问题（例如，新版本中似乎不再存在某个方法）时，这可能非常有用。不要忽视“相关页面”页面，快速浏览特定版本的新内容会很有趣。

此文档也可通过 DevHelp 离线使用。请参阅this SO answer 了解如何安装它。但请注意，离线版本提供单一版本（您无法跨版本浏览）。

Gtkmm 演示

有空here。

如存储库中所述：

这些是与 gtk+ 一起分发的 C 演示的 C++ 版本。你可能会发现它们更容易理解，因为 C++ 允许更清晰的组织和代码重用。 gtk-demo 包含多个功能演示和 API，它们是 gtk+3.0 中的新功能，它显示了它正在运行的演示的源代码。

这些是 Gtkmm 官方存储库中可用的 Gtkmm 示例。它们可以下载、编译和播放，非常酷。此外，这些演示得到维护，这意味着它们随着 Gtkmm 版本的发展而发展。这非常很有用，因为您可以使用存储库回到过去并使用不同的 API 版本。这为我节省了几次，因为我需要使用较旧的 API 版本并发现当前的 API 完全不同。

如果你不想编译它们并且你已经安装了 Gtkmm，你也可以运行

gtk3-demo

为您安装的 Gtkmm 版本启动演示：

Gtkmm 邮件列表

有空here。

这个邮件列表是关于 gtkmm 的使用和开发的 C++ 绑定到 GTK+

我也在那里找到了一些特定问题的答案。然而，直接使用它是相当困难的，因为那里没有任何东西可以帮助搜索特定的主题。我找到的大多数答案都是谷歌搜索的结果，指向邮件列表的一些元素。

GTK 文档

Gtkmm 本质上是围绕 GTK+ (GTK) 的 C++ 包装器。这意味着GTK+ documentation 也很有用。例如，我经常使用Widget Gallery for Gtk3 和Widget Gallery for Gtk4 来查看可用的小部件以及它们的外观。

并不是说像PyGTK 这样的其他包装器也可以提供帮助。然而，根据我的经验，它们不如 Gtk+ 文档有趣。

非官方文档

其他一些网络资源也很有用。这里有一个快速列表：

Gnome wiki Gtkmm project page：一些其他地方没有的随机资源。例如，有一篇文章介绍了如何将 Gtkmm 与 CMake 结合使用。
Philippe Licidarme Gtkmm tutorial examples：很多简洁的例子。所有源代码也可以下载。
Gedit 和Inkscape 存储库：这是两个分别使用 GTK 和 Gtkmm 的成功软件。即使 Gedit 存储库是用 GTK 编写的，我也将它放在首位，因为在这个存储库中我找到了最多的答案。
The Michal B. GTK playlist ：一组 YouTube 视频，展示了很多好东西。 Gtkmm 本身没有，但非常接近 (GTK)。
有点过时，但亨特学院的 Stuart Weiss 教授有really nice lecture notes 关于 GTK+ 的主题。这些注释包含很多细节，是我们在官方文档中真正需要的那种细节，但不幸的是几乎找不到。
GTK 3 Programming with C and Glade (GTK) - 由 Lecrapouille 提供。
Linux Gtk Glade Programming (GTK) - 由 Lecrapouille 提供。
关注 SO 上的 gtkmm 和 gtkmm 标签，以及 gtk 和 gtk3 标签。

【讨论】：

本书和参考手册在撰写本文时都返回了 404，除了通过网络缓存外，它们似乎在其他任何地方都不可用。
你是对的...Gnome developer 网站似乎发生了变化。在他们的新网站上，据说 Gtkmm 文档是可用的 here，但它会重定向到 Gtkmm 网站，这反过来会导致 404。对于其他编程语言，一切似乎都很好。
文档 URL 也很旧：developer-old.gnome.org。他们推出了一个新网站，但只针对 GTK 而不是针对 Gtkmm。 docs.gtk.org
谢谢，我去看看（至少 GTK 相关的链接）。