These are all smaller helper scripts for postscript output. In my personal editing environment, I use troff to create postscript files. Sometimes it is necessary to manually adjust the postscript file.
These tools are intentionally not the most performant. They are meant to just work. Feel free to contribute more performant versions as well as other tools.
Use this tool to move pages around. E. g. move the last page (table of contents) to the beginning, so we have a nicely formatted document with ordered pages. All other pages are renumbered to fit the moved page.
# psmove from to <file.ps >output.ps
; psmove 6 2 <file.ps >output.ps
from must be greater than to!
This tool can shuffle pages at will. It needs two parameters: number of pages and a mapping table.
The mapping table is a comma separated list of page numbers.
# reorder a document with 5 pages
; psmovem 5 1,2,3,5,4 <file.ps >output.ps
This tools provides a generator for mapping tables for psmovem.
It uses a simple mapping syntax similar to rc shell redirections.
# move page 5 to 2, then the last page to 1
; psnumseq file.ps '5=2' '-0=1'
# the output can be directly used with psmovem
; psmovem «numpages» `{psnumseq file.ps '5=2' '-0=1'}
Note that 0 is invalid while -0 is valid!
This tool takes postscript input and renumbers all pages sequentially.
It can be used to clean up after moving pages around with psmove.
It also fixes the %%Pages: page number attribute, but only if it's set after the pages.
; pspnumber <file.ps >output.ps
Note: I currently use me macros almost exclusively. Some of these scripts might not work properly with other macro packages.
This troff preprocessor is able to produce double references with refer. This way you can have both footnotes and bibliography, which is not possible with the ported refer.
# refx flags
; refx <file | troff ...
refx will invoke refer two times (with and without the accumulate flag).
Convert formatted text files to a troff language (-ms like).
# sample usage
; txt2ms <file.txt | troff -ms ...
The format uses the two point glyph for special parsing of bold/italic: ‥italic‥ and ‥‥bold‥‥.
To disable this parsing enable the dontparse flag.
Otherwise the format is markdown-like:
# sample section
## sample subsection
### sample subsubsection
New paragraph with ‥‥bold‥‥ and ‥italic‥ text.
Another paragraph with \fBbold\fR and \fIitalic\fR text.
Keep in mind that the format only borrows from markdown. Many features are not supported (links, ...).
The converter is line oriented.
Therefore troff content can be included where needed.
Only empty lines and lines beginning with # are converted.
One special feature: The script is able to use the first line as a title, allowing quick ms-flavored documents.
To use this feature the firstheader variable needs to be set.
Set variables like this:
; txt2ms -v 'firstheader=1' 'dontparse=1' < file.txt
Using txt2ms allows the creation of tables of contents.
The important lines are printed to stderr.
; txt2ms < file.txt | troff >[2] aux.file
txt2ms also introduces the .KT macro for keep titles.
.KT "index" "Prefix" "Title."
This will typeset a keep title in the form: Prefix 5: Title.
Using the *t string and number (.ds *t "text, .nr *t 10) allows setting the indentation level and a hanging tag.
lib/txtmk is an mk library file and can be used to compile indexes that can be included in the source text file (with .so file.msi).
To use the lib/txtmk library you should include the global $MACROS variable in your mkfile (with contents like: -ms -mpictures).
Note: You need to filter the output if you have errors/warnings!