提交: 19f3178f85992ff8dcf0f32fb55d95b700f5f82d - groff-pdfmark (hg)

Reference Documentation: PDF Publishing with GNU Troff

Commit MetaInfo

• 修訂: 19f3178f85992ff8dcf0f32fb55d95b700f5f82d (tree)
• 時間: 2022-02-12 06:02:01
• 作者: Keith Marshall <keith@user...>
• Commiter: Keith Marshall

Log Message

Add support for custom location keyword interpretation.

* pdfmark.tmac (pdf*href.format): Generalize keyword interpreter.
(pdf*href-K): New internal macro; it implements the interpreter for
"pdfhref K ..." macro calls; use it to map location keywords to...
(PDFHREF.FILEREF, PDFHREF.PAGEREF, PDFHREF.SECTREF): ...these; thus...
(pdf*href.format.file, pdf*href.format.page, pdf*href.format.section):
...these become redundant; delete them.

* pdfmark.ms (pdfhref K): Document it; add keeps, to avoid potential
widow lines in following paragraphs.

Change Summary

• modified: pdfmark.ms
• modified: tmac/pdfmark.tmac

差異

diff -r 81770f396af0 -r 19f3178f8599 pdfmark.ms
--- a/pdfmark.ms	Fri Dec 31 19:19:09 2021 +0000
+++ b/pdfmark.ms	Fri Feb 11 21:02:01 2022 +0000
@@ -1389,6 +1389,13 @@
 .CW pdfhref ,
 when formatting the text in the active region of a link,
 .XR set-format ). (
+.IP \*[= K]
+Define one or more location keywords,
+and associated \%format\(hystring names,
+which should be interpreted by the
+.CW pdfhref
+reference text formatting routine,
+.XR custom-format ). (
 .IP \*[= Z]
 Define the absolute position on the physical PDF output page,
 where the \%\(lqhot\(hyspot\(rq associated with an active link is to be placed.

diff -r 81770f396af0 -r 19f3178f8599 tmac/pdfmark.tmac
--- a/tmac/pdfmark.tmac	Fri Dec 31 19:19:09 2021 +0000
+++ b/tmac/pdfmark.tmac	Fri Feb 11 21:02:01 2022 +0000
@@ -1240,6 +1240,26 @@
 .ds PDFHREF.SECTREF  section \\$1,
 .ds PDFHREF.FILEREF  \\$1
 .\"
+.de pdf*href-K
+.\" -----------------------------------------------------------------
+.\" Usage:
+.\"   .pdfhref K keyword format-name [keyword format-name] ...
+.\" -----------------------------------------------------------------
+.\" Map a format string name to an arbitrary keyword, which may be
+.\" interpreted by the pdf*href.format macro, (or any alternative,
+.\" which may have been designated by the user).
+.\"
+.while \\n(.$>1 \{\
+.   ds pdf*href.format.\\$1 \\$2
+.   shift 2
+.   \}
+..
+.\" Use it, to map the standard reference mark location keywords.
+.\"
+.pdfhref K file      PDFHREF.FILEREF
+.pdfhref K section   PDFHREF.SECTREF
+.pdfhref K page      PDFHREF.PAGEREF
+.\"
 .de pdf*href.format
 .\" -----------------------------------------------------------------
 .\" Usage: (to be called ONLY by "pdfhref")
@@ -1261,7 +1281,7 @@
 .\"
 .ds PDFHREF.TEXT \\*[PDFHREF.PREFIX]
 .while d\\$0.\\$1 \{\
-.   \\$0.\\$1 "\\$2"
+.   as PDFHREF.TEXT " \\*[\\*[\\$0.\\$1] "\\$2"]\"
 .   shift 2
 .   \}
 .\"
@@ -1281,34 +1301,6 @@
 .\"
 .ds PDFHREF.TEXT \\*[PDFHREF.TEXT]
 ..
-.de pdf*href.format.file
-.\" ----------------------------------------------------------------------
-.\" Include a file identifier in a formatted reference.
-.\" This is invoked ONLY by "pdf*href.format", and ONLY IF the
-.\" reference data includes an initial file identifier tuple.
-.\" ----------------------------------------------------------------------
-.\"
-.as PDFHREF.TEXT " \\*[PDFHREF.FILEREF]
-..
-.de pdf*href.format.page
-.\" ----------------------------------------------------------------------
-.\" Include a page number in a formatted reference.
-.\" This is invoked ONLY by "pdf*href.format", and ONLY IF the
-.\" reference data includes an initial page number tuple.
-.\" ----------------------------------------------------------------------
-.\"
-.as PDFHREF.TEXT " \\*[PDFHREF.PAGEREF]
-..
-.de pdf*href.format.section
-.\" ----------------------------------------------------------------------
-.\" Include a section number in a formatted reference.
-.\" This is invoked ONLY by "pdf*href.format", and ONLY IF the
-.\" reference data includes an initial section number tuple.
-.\" ----------------------------------------------------------------------
-.\"
-.as PDFHREF.TEXT " \\*[PDFHREF.SECTREF]
-..
-.\"
 .\" Make "pdf*href.format" the default cross reference formatter
 .\"
 .als pdf*href.default pdf*href.format