如何在groff man宏中控制标头的内容

johntait.org

我使用groff手册宏来生成通用文档(实际上不是手册页),因为它们易于学习和使用。我希望将后记页面标题控制为自由文本。

groff的手册说:

将文件man.local用于man宏的本地扩展或样式更改。

巨集: .PT

控制标题的内容。通常,标题在两边打印命令名称和段号,并在中间打印TH的可选第五个参数。

我如何在实践中做到这一点?

托马斯·迪基

措辞晦涩,但建议是修改man.local文件本身,而不要覆盖在该文件中找到的宏。

一个很好的起点是文档:5.21编写宏(GNU Troff手册)。那显示了如何定义宏。

要研究的实际宏在很大程度上取决于版本。在Debian中,我PTgroff-base包中宏中找到了

/usr/share/groff/1.21/tmac/an-old.tmac

作为

.\" Redefine these to customize the header & footer
.
.de1 PT
.  tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
..

它将命名变量作为第一个参数传递给.tl要了解什么.tl(grep是您的朋友)及其作用,需要做一些工作(在此处提到):

您是否知道.tl(标题)分为左,中,右三个部分?

另一方面,groff的文档多年来不断完善:您可以在索引中找到“ .tl”

通常,您会发现:

  • 大多数宏(您在读取这些文件时遇到的宏)都是未记录的
  • grep在宏列表上(grep-w帮助)是找到特定宏的唯一方法
  • 有些宏的设备特定版本会覆盖通用版本

本文收集自互联网,转载请注明来源。

如有侵权,请联系 [email protected] 删除。

编辑于
0

我来说两句

0 条评论
登录 后参与评论

相关文章

如何在 groff 中包含图片作为外部文件?

如何在 ms 包中为 groff 自定义标题?

groff:如何在使用 PDF_WWW_LINK mom 宏生成的链接后放置标点符号?

如何在 LoopBack 中访问控制器函数中的标头?

如何在RestController中获取标头值并将其传递给父控制器

如何在Spring MVC REST控制器中访问HTTP标头信息?

如何在codeigniter控制器中定义json标头?

如何在集成测试中为API控制器添加请求标头

如何在emscripten wget2函数中获取内容类型的响应标头?

如何在WPF中设置小的扩展标头并扩展内容?

Azure ExecuteBatch-如何在C#中设置首选内容目录标头?

如何在葡萄中传递标头?

如何正确显示groff中的波兰变音符号?

如何使用 mom 宏在 groff 中添加指向 URL 的超链接?

如何在.net MVC Web API控制器方法中设置内容范围标头?

如何在请求中遍历 HttpHeaders 并将任何缺失的内容添加到新的标头变量中

如何控制QTableWidget标头的外观

如何控制requirejs设置的请求标头?

如何控制uitable标头的样式?

如何从响应标头获取内容长度?

内容与flexbox标头重叠-如何避免

如何在 nginx 中为某些文件扩展名添加带有代理传递的缓存控制标头

如何在JavaFX中的TitledPane中更改标头组件

如何在golang中从http请求中读取标头?

在Firefox中,如何查看HTTP请求标头?(在Web控制台中的何处?)

如何从Spring Cloud Stream App Starter源产生的Kafka消息中删除内容类型标头

请求文件时,如何使Azure在响应中返回“接受范围”和“内容编码”标头?

在春季集成中解组Xml有效内容后如何保留JMS标头

如果标头缺少内容类型,如何通过asText访问Scala播放中的请求正文