博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
用Devhelp看自己的文档
阅读量:6211 次
发布时间:2019-06-21

本文共 1276 字,大约阅读时间需要 4 分钟。

我最开始用Linux的目的就是方便开发,同时接触更多的底层。一段时间后发现,Linux对我来说什么都好,就是help doc不如Windows。经常是遇到一个问题,却找不相应文档,硬着头皮去论坛提问,又被一句“请先阅读《提问的智慧》”给打了回来。最早在 Windows XPE上面开发时,充分体会到MSDN的方便,所以在Linux下一直关注有没有一个同等替代品。其实Linux下的Howto和说明很多,还有man和 info,资料是很充分了,但实在是分散,不方便应急的查找。我曾经试过用c写了一个命令行下的helpdoc打印程序,通过读文件(html)事先,但 毕竟还是命令行的,看,查,都不够方便。现在终于找到一个专门用于GNOME开发的帮助软件devhelp。 Devhelp 是一个GNOME下的文档浏览器,是为了阅读用 gtk-doc 生成的格式的文档而设计的,gtk-doc 是构建 GTK+ 文档的标准工具,相关的项目,例如 Pango 和 GNOME 也使用它。使用 Devhelp,可以迅速地搜索函数索引并浏览已经安装的文档,从而可以更迅速地获得需要的信息。   这玩意很好装,可以通过aptitude install devhelp-books,也可以从 下载源代码来安装。 当然我们不能光装完就完了,不然这写的也太没有水准了。我们有了这么一个方便的看文档的地方,得琢磨一个啥法子来充分利用阿。默认从源代码安装完的devhelp只带了17个reference manual,这明显是不够的,我们需要来扩充它。 首先,我们需要从 下 载安装脚本devhelp-install。然后我们需要devhelp格式的doc文件。devhelp使用的是一种XML文件来存储table of contents, index以及元数据,这种文件的后缀名通常都是devhelp或者devhelp2。提供devhelp格式的帮助文件的地方,这里推荐一个,是 htmlhelp项目主站提供的 。 顺便说说安装的事。看一下这个bash脚本,就会知道其实安装过程很简单,其实你要手工安装也可以,因为手工的话灵活性更强,首先下载某个tgz文 件,针对devhelp格式的。然后解压缩,你会发现有一个充斥着html的文件夹和一个以devhelp为扩展名的文件,就是刚才说的XML文件。然后 把这个文件和那些HTML文件一起放到同一个文件夹下(是文件,不是存放HTML的文件夹),文件夹名字要和XML文件名字一样就行了。存放位置呢,一般 是各个软件在share目录下属于自己html文件夹,比如/usr/share/doc/python2.5/html/,也有很多gtk开发的软件对 应的开发文档存放在/usr/share/gtk-doc/html/下,当然也可以和安装脚本一样安装在home的.local下,这就看个人了。

转载于:https://www.cnblogs.com/shaoguangleo/archive/2011/10/06/2805964.html

你可能感兴趣的文章
收藏的文章
查看>>
【工具使用系列】关于 MATLAB Simulink Stateflow, 你需要知道的事
查看>>
uClibc库的交叉编译
查看>>
让spring mvc支持put请求
查看>>
一个简单的随机数方法,支持小数
查看>>
centos下yum安装ffmpeg
查看>>
给 Android 开发者的 RxJava 详解
查看>>
IOS UIWebView调用H5页面后退方法出现“about:blank”
查看>>
ARM嵌入式Linux系统开发详解(第2版)
查看>>
centos环境下php7安装记录
查看>>
JAVA NIO Connection reset by peer 异常
查看>>
An internal error occurred during: "Building works
查看>>
Django中的@login_required和@permission_irequired用法简介
查看>>
py脚本在crontab中无法运行
查看>>
Android平台下与服务器数据库通信的方法
查看>>
TCP/IP 6.2增强型内部网关路由选择协议(EIGRP)(2)
查看>>
hadoop2.x分布式集群安装配置 ~第三步:ssh免密钥配置
查看>>
ubuntu下locale设定
查看>>
从个人网站到淘宝网 仰观Java时代淘宝的技术发展
查看>>
你有拒绝 22K 的权力(转)
查看>>