summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-11-19 21:44:26 +0000
committerKarl Berry <karl@freefriends.org>2023-11-19 21:44:26 +0000
commit6b447bc60550e6f36490f0992f371a739bc13a85 (patch)
tree4beb86e5d63f93947ef2f17f83c28b8ea0ad7a5e /Master/texmf-dist/doc/man
parente6d80c059c6f406941d26d63e1de56e06e81d316 (diff)
bibtexperllibs (19nov23)
git-svn-id: svn://tug.org/texlive/trunk@68910 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/ltx2unitxt.173
-rw-r--r--Master/texmf-dist/doc/man/man1/ltx2unitxt.man1.pdfbin0 -> 20923 bytes
2 files changed, 73 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/ltx2unitxt.1 b/Master/texmf-dist/doc/man/man1/ltx2unitxt.1
new file mode 100644
index 00000000000..8dc8e714264
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ltx2unitxt.1
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
+.TH LTX2UNITXT "1" "November 2023" "ltx2unitxt " "User Commands"
+.SH NAME
+ltx2unitxt \- convert LaTeX source fragment to plain (Unicode) text or simple html
+.SH SYNOPSIS
+.B ltx2unitxt
+[\fI\,-c CONFIG\/\fR] [\fI\,-o OUTPUT\/\fR] [\fI\,--html\/\fR] [...] [\fI\,INFILE\/\fR]...
+.SH DESCRIPTION
+Convert the LaTeX source in INFILE (or standard input) to plain text
+using Unicode code points for accents and other special characters; or,
+optionally, output HTML with simple translations for font changes and url
+commands.
+.PP
+Common accent sequences, special characters, and simple markup commands
+are translated, but there is no attempt at completeness. Math, tables,
+figures, sectioning, etc., are not handled in any way, and mostly left
+in their TeX form in the output. The translations assume standard LaTeX
+meanings for characters and control sequences; macros in the input are
+not considered.
+.PP
+The input can be a fragment of text, not a full document, as the purpose
+of this script was to handle bibliography entries and abstracts (for the
+ltx2crossrefxml script that is part of the crossrefware package).
+Patches to extend this script are welcome. It uses the LaTeX::ToUnicode
+Perl library for the conversion; see its documentation for details.
+.PP
+Conversion is currently done line by line, so TeX constructs that cross
+multiple lines are not handled properly. If it turns out to be useful,
+conversion could be done by paragraph instead.
+.PP
+The config file is read as a Perl source file. It can define a function
+`LaTeX_ToUnicode_convert_hook()' which will be called early; the value
+it returns (which must be a string) will then be subject to the standard
+conversion.
+.PP
+For an example of using this script and associated code, see the TUGboat
+processing at
+https://github.com/TeXUsersGroup/tugboat/tree/trunk/capsules/crossref.
+.SH OPTIONS
+.TP
+\fB\-c\fR, \fB\-\-config\fR=\fI\,FILE\/\fR
+read (Perl) config FILE for a hook, as explained above
+.TP
+\fB\-e\fR, \fB\-\-entities\fR
+output entities &#xNNNN; instead of literal characters
+.TP
+\fB\-g\fR, \fB\-\-german\fR
+handle some features of the german package
+.TP
+\fB\-h\fR, \fB\-\-html\fR
+output simplistic HTML instead of plain text
+.TP
+\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
+output to FILE instead of stdout
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+be verbose
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+output version information and exit
+.TP
+\-?, \fB\-\-help\fR
+display this help and exit
+.PP
+Options can be abbreviated unambiguously, and start with either \- or \fB\-\-\fR.
+.PP
+Dev sources, bug tracker: https://github.com/borisveytsman/bibtexperllibs
+Releases: https://ctan.org/pkg/bibtexperllibs
+.PP
+ltx2unitxt (bibtexperllibs) 0.51
+Copyright 2023 Karl Berry.
+This is free software: you can redistribute it and/or
+modify it under the same terms as Perl itself.
diff --git a/Master/texmf-dist/doc/man/man1/ltx2unitxt.man1.pdf b/Master/texmf-dist/doc/man/man1/ltx2unitxt.man1.pdf
new file mode 100644
index 00000000000..65577b000dd
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ltx2unitxt.man1.pdf
Binary files differ