• R/O
  • SSH

提交

標籤
無標籤

Frequently used words (click to add to your profile)

javac++androidlinuxc#objective-cqt誰得cocoawindowspythonrubyphpgameguibathyscaphec翻訳omegat計画中(planning stage)frameworktwittertestdombtronvb.netdirectxarduinopreviewerゲームエンジン

Reference Documentation: PDF Publishing with GNU Troff


Commit MetaInfo

修訂651fc10b18c4932dc4939e8cf47fc2c59259df63 (tree)
時間2022-02-27 23:19:43
作者Keith Marshall <keith@user...>
CommiterKeith Marshall

Log Message

Add discussion of "ms" document structure.

* pdfmark.ms (Section 3.1.1): Add content.
(Section 4): Add cross-reference label, named...
(pdf-publishing): ...thus.

Change Summary

差異

diff -r 5da678ba39a9 -r 651fc10b18c4 pdfmark.ms
--- a/pdfmark.ms Sun Feb 27 11:07:02 2022 +0000
+++ b/pdfmark.ms Sun Feb 27 14:19:43 2022 +0000
@@ -3919,6 +3919,115 @@
39193919 are described below.
39203920 .
39213921 .NH 3
3922+.XN -S -- Document Structuring Considerations when using \F[C]ms\F[] Macros
3923+.LP
3924+Every published document
3925+.EM must
3926+incorporate,
3927+as a minimum,
3928+a document body;
3929+additionally,
3930+many documents may include
3931+.EM \%front\(hymatter ,
3932+which precedes the body,
3933+and
3934+.EM \%end\(hymatter ,
3935+which follows the body.
3936+Additionally,
3937+when publishing as a PDF document,
3938+it may be desired to incorporate a document outline,
3939+referring to chapter,
3940+or section headings,
3941+within the document body.
3942+.LP
3943+Conventionally,
3944+when a document is to include a
3945+.EM "table of contents" ,
3946+this should be placed at the end of the
3947+.EM \%front\(hymatter .
3948+.LP
3949+Traditional
3950+.CW AT&T
3951+implementations of
3952+.CW ms
3953+provide a number of macros to control \%front\(hymatter style,
3954+(of which only the \(lqreleased paper\(rq style,
3955+selected by use of the
3956+.CW RP
3957+macro,
3958+is supported by
3959+.CW groff
3960+.CW ms ),
3961+accompanied by several macros to specify \%front\(hymatter content,
3962+(also supported by
3963+.CW groff
3964+.CW ms ).
3965+Both traditional,
3966+and
3967+.CW groff
3968+.CW ms
3969+implementations also provide a small set of macros
3970+to facilitate compilation of a table of contents;
3971+they do not,
3972+however,
3973+offer any standard facilities for creation
3974+of a corresponding document outline.
3975+.LP
3976+Unfortunately,
3977+the traditional
3978+.CW ms
3979+method of compiling the table of contents
3980+results in it being printed at the end of the document,
3981+rather than in its normal position,
3982+at the end of the \%front\(hymatter.
3983+Traditionally,
3984+this unusual placement of the table of contents would be corrected,
3985+by manual collation,
3986+after printing;
3987+emulation of this mechanical collation technique presents a challenge,
3988+when the document is to be published in PDF format.
3989+.LP
3990+Taking up the challenge of collating the various document sections
3991+into the correct order,
3992+when producing any PDF document,
3993+will necessitate special consideration during the PDF publication process;
3994+this will be discussed in greater depth,
3995+in
3996+.rn PDFHREF.PREFIX XX
3997+.XR pdf-publishing .
3998+.rn XX PDFHREF.PREFIX
3999+To accommodate any specialized processing which may be required,
4000+.CW spdf.tmac
4001+provides:\(en
4002+.QS
4003+.sp -\n(PDu
4004+.IP \(bu
4005+Macros to isolate the
4006+.EM \%front\(hymatter ,
4007+(excluding the
4008+.EM "table of contents" ),
4009+from the body of the document.
4010+.IP \(bu
4011+Further macros to compile a table of contents,
4012+and a corresponding PDF document outline,
4013+deriving both from section headings,
4014+.XR xh-xn-macros ). (
4015+.IP \(bu
4016+A redefined implementation of the
4017+.CW TC
4018+macro,
4019+(to be invoked at the end of the document,
4020+as in traditional
4021+.CW ms
4022+usage);
4023+this isolates the table of contents
4024+from its preceding \%front\(hymatter (if any),
4025+and from the document body,
4026+to facilitate the collation process.
4027+.\"nr PD +0.1v
4028+.QE
4029+.
4030+.NH 3
39224031 .XN -S -- \F[C]ms\F[] Section Headings in PDF Documents
39234032 .LP
39244033 Traditionally,
@@ -3951,7 +4060,7 @@
39514060 .bp
39524061 .
39534062 .NH 1
3954-.XN The PDF Publishing Process
4063+.XN -N pdf-publishing -- The PDF Publishing Process
39554064 .
39564065 .NH 2
39574066 .XN -N do-xref -- Resolving Cross References