Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
No description, website, or topics provided.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
.SH txt2page txt2page converts plain text marked up with a modest amount of groff markup into HTML. It is a small bash/vim script that implements a usable subset of the larger Common Lisp program \*[: github.com/ds26gte/troff2page]troff2page\&. Useful when on a system where I can't or don't want to install troff2page. With the help of the external programs groff and pandoc, txt2page can also convert its input to PDF and docx respectively. Installation: Place the scripts txt2page, txt2page_pdf, and txt2page_docx in your PATH, and the Vim files txt2page.vim, tx2page_pdf.vim, and txt2page_docx.vim in your ‘runtimepath’ (typically ~/.vim or ~/.config/nvim, or their ‘after’ subdirectory — *not* the ‘plugin’ subdirectory). % txt2page filename.txt creates ‘filename.html’. Here, ‘%’ is your Un*x command-line prompt. The source-file extension doesn’t have to be ‘.txt’: it can be anything or nothing. You can supply groff-like options to txt2page. For HTML, the only relevant one is ‘-s’. For PDF, use the option ‘-Tpdf’ and other usual groff options for fonts, layout, &c. E.g., % txt2page -Tpdf -r PS=14p -r PI=1.5m -r LL=6i -r PO=1.13i filename.txt creates ‘filename.pdf’. For docx, use the option ‘-Tdocx’. E.g., % txt2page -Tdocx filename.txt creates ‘filename.docx’. For HTML, if the ‘-s’ option is not used, .so filename Some Additional Description merely *links* to (the HTML version of) ‘filename’ with ‘Some Additional Description’ serving as link text. In troff of course, both syntaxes cause sourcing of filename, since troff ‘.so’ considers only its first argument. I had it this way because it’s a way to coax a Table of Contents into the HTML without additional markup. For HTML, if the ‘-s’ option is used, all ‘.so’ calls cause interpolation (recursively). This allows you to create one single all-encompassing HTML page for the document, chasing down all subfiles.