summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-10-03 20:32:45 +0000
committerKarl Berry <karl@freefriends.org>2021-10-03 20:32:45 +0000
commit9d67bfdcf1353cbb0d96f6eb0e10b469ab0020b9 (patch)
tree92ec4ccf6c4679ace2bc8c91a8c0e6308655ab40 /Master/texmf-dist/doc/support
parent01ff03dce6921c6e40b65ec78befdf9124b1709d (diff)
crossrefware (3oct21)
git-svn-id: svn://tug.org/texlive/trunk@60689 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/crossrefware/Makefile20
-rw-r--r--Master/texmf-dist/doc/support/crossrefware/README66
-rw-r--r--Master/texmf-dist/doc/support/crossrefware/crossrefware.pdfbin136411 -> 233582 bytes
-rw-r--r--Master/texmf-dist/doc/support/crossrefware/head.ltx47
4 files changed, 77 insertions, 56 deletions
diff --git a/Master/texmf-dist/doc/support/crossrefware/Makefile b/Master/texmf-dist/doc/support/crossrefware/Makefile
index 8181d382e32..c8caf35d606 100644
--- a/Master/texmf-dist/doc/support/crossrefware/Makefile
+++ b/Master/texmf-dist/doc/support/crossrefware/Makefile
@@ -1,8 +1,10 @@
+# Makefile for the (La)TeX crossrefware package. Public domain.
+
SCRIPTS = \
ltx2crossrefxml.pl \
bibdoiadd.pl \
- bibzbladd.pl \
bibmradd.pl \
+ bibzbladd.pl \
biburl2doi.pl \
bbl2bib.pl
@@ -15,17 +17,16 @@ PDF = crossrefware.pdf
all: ${MAN1} ${PDF}
chmod a+x ${SCRIPTS}
-
+check:
+ ./ltx2crossrefxml.pl --help
+ ./ltx2crossrefxml.pl --version
%.1: %.pl
- pod2man -c "CROSSREF LIBRARY" -n $* -s 1 -r "" $< > $@
-
-
+ pod2man -c "LATEX CROSSREFWARE" -n $* -s 1 -r "" $< > $@
clean:
- $(RM) *.aux *.toc *.log *.tex *.idx *.ilg *.ind *.out *.zip *.tgz \
- *~
+ $(RM) *.aux *.toc *.log *.tex *.idx *.ilg *.ind *.out *.zip *.tgz *~
distclean: clean
$(RM) *.pdf *.1 *.3
@@ -42,4 +43,7 @@ crossrefware.tex: ${SCRIPTS}
pod2latex -modify -full -prefile head.ltx -out $@ $+
archive: all clean
- COPYFILE_DISABLE=1 tar -C .. -czvf ../$(PACKAGE).tgz --exclude '*~' --exclude '*.tgz' --exclude '*.zip' --exclude CVS --exclude '.git*' $(PACKAGE); mv ../$(PACKAGE).tgz .
+ COPYFILE_DISABLE=1 tar -C .. -czvf ../$(PACKAGE).tgz --exclude '*~' \
+ --exclude '*.tgz' --exclude '*.zip' --exclude CVS \
+ --exclude '.git*' $(PACKAGE)
+ mv ../$(PACKAGE).tgz .
diff --git a/Master/texmf-dist/doc/support/crossrefware/README b/Master/texmf-dist/doc/support/crossrefware/README
index 882bdb31e0b..1682b98fe32 100644
--- a/Master/texmf-dist/doc/support/crossrefware/README
+++ b/Master/texmf-dist/doc/support/crossrefware/README
@@ -1,55 +1,61 @@
Crossrefware Bundle
- version 2017/11/26
-
+ version 2021-10-02
Scripts useful for working with Crossref, MathSciNet and Zentralblatt MATH.
-This work was commissioned by The Saint Lois University and The
-Princeton University (Mathematics Department)
-
bibdoiadd.pl - add DOI numbers to papers in a given bib file
bibzbladd.pl - add Zbl numbers to papers in a given bib file
bibmradd.pl - add MR numbers to papers in a given bib file
bbl2bib.pl - convert `thebibliography' environment to a bib file
biburl2doi.pl - convert urls pointing to doi.org to dois
-ltx2crossrefxml.pl - a tool for creation of XML files for submitting to crossref.org
+ltx2crossrefxml.pl - create XML files for submission to crossref.org
-The scripts use bibtexperllibs libraries from CTAN
+Bug reports, source code: https://github.com/borisveytsman/crossrefware
+Releases: https://ctan.org/pkg/crossrefware
-Installation:
+These scripts rely on the bibtexperllibs libraries (replace
+/crossrefware with /bibtexperllibs in the above urls).
-1. Move *.pl files to the binaries directory in your system.
+For an example of using ltx2crossrefxml and associated code, see the
+TUGboat processing at
+https://github.com/TeXUsersGroup/tugboat/tree/trunk/capsules/crossref.
+Installation:
+1. Move *.pl files to the binaries directory in your system.
2. Use *.cfg files as configuration files samples.
-
3. Move *.1 to the man pages directory in your system.
+This work was commissioned by The Saint Louis University and
+Princeton University (Mathematics Department). Thank you!
Changes:
- 2018/04/15 - Fixed a bug in bibzbladd
- - Work around a bug in mathscinet
+2021-10-02 - changed TEXSELFAUTOPARENT to TEXMFROOT
+
+2021-01-18 - all conversions moved from ltx2crossrefxml to LaTeX::ToUnicode.
+ - config file can provide a hook for processing.
+
+2018/04/15 - Fixed a bug in bibzbladd
+ - Work around a bug in mathscinet
- 2017/11/26: - Switched to date-based versioning for the
- bundle.
- - bbl2bib now converts urls starting with
- http(s)://(dx.)doi.org to dois. This functionality
- is also provided by a separate script biburl2doi
- - bibadddoi now has the option to (not) canonize
- names
+2017/11/26 - Switched to date-based versioning for the bundle.
+ - bbl2bib now converts urls starting with
+ http(s)://(dx.)doi.org to dois. This functionality
+ is also provided by a separate script biburl2doi
+ - bibadddoi now has the option to (not) canonize names
- Version 2.2: We now treat absent CA permissively.
- New debug options for bbl2bib
+Version 2.2: We now treat absent CA permissively.
+ New debug options for bbl2bib
- Version 2.1a: Bug in bbl2bib corrected
+Version 2.1a: Bug in bbl2bib corrected
- Version 2.1: New options to add empty doi and zbl when doi or zbl
- are not found to prevent repeated searches.
- Added bibmradd.pl
- Added bbl2bib.pl
+Version 2.1: New options to add empty doi and zbl when doi or zbl
+ are not found to prevent repeated searches.
+ Added bibmradd.pl
+ Added bbl2bib.pl
- Version 2.0: Moved to BibTeX::Parser suite.
- Now we use new Zbmath interface.
- Now we use bibtexperllibs libraries
+Version 2.0: Moved to BibTeX::Parser suite.
+ Now we use new Zbmath interface.
+ Now we use bibtexperllibs libraries
- Version 1.1: workaround for a bug with macrons in TeX::Encode \ No newline at end of file
+Version 1.1: workaround for a bug with macrons in TeX::Encode
diff --git a/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf b/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf
index 87d5bac969e..c40afb1dee4 100644
--- a/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf
+++ b/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/crossrefware/head.ltx b/Master/texmf-dist/doc/support/crossrefware/head.ltx
index 16391486bf9..72ae89028e6 100644
--- a/Master/texmf-dist/doc/support/crossrefware/head.ltx
+++ b/Master/texmf-dist/doc/support/crossrefware/head.ltx
@@ -1,39 +1,50 @@
-\documentclass{article}
-\usepackage{makeidx}
-\usepackage[osf]{mathpazo}
+\documentclass[11pt]{article}
+\usepackage{makeidx,fullpage}
\usepackage[hidelinks]{hyperref}
\makeindex
\begin{document}
\sloppy
\title{Crossrefware documentation\thanks{This work was commissioned by
- The Saint Lois University and The Princeton University (Mathematics
- Department)}}
+ Saint Louis University and Princeton University (Mathematics Department)}}
\author{Boris Veytsman\thanks{borisv@lk.net, boris@varphi.com}}
\maketitle
\tableofcontents
\section{Introduction}
-These scripts can be used to submit files to Crossref, check and add
-doi numbers, MathSciNet numbers and ZbMath numbers to papers, and to
-convert `bbl' files to `bib' files.
+These scripts can be used to create files for submission to Crossref,
+check and add doi numbers, MathSciNet numbers and ZbMath numbers to
+papers, and to convert `bbl' files to `bib' files.
-I am grateful to Josko Plazonic from Princeton Math Dept whose
-(unpublished) Python script was an inspiration for this suite.
+Development sources and issue tracker are on github:
+\url{https://github.com/borisveytsman/crossrefware}.
+Releases are made on CTAN:
+\url{https://ctan.org/pkg/crossrefware}
+and from there included in \TeX\ Live and other distributions.
+
+The script \path{ltx2crossrefxml} extracts information from \path{.rpi}
+files and (if present) \path{.bbl} files and generates an XML file
+suitable for submission to crossref.org. (Crossref is the organization
+that handles DOI numbers for scholarly papers.) It does not actually
+upload the submission, just outputs XML.
-The script \path{ltx2crossrefxml} is used to extract the information
-from a \LaTeX\ file and generate an XML file suitable for submission
-to Crossref (the organization that keeps DOI numbering system).
+This \path{.rpi} file is a plain text representation of the metadata for
+one article. It is written by the \path{resphilosophica} package
+(\url{https://ctan.org/pkg/resphilosophica}). It can also be created by
+hand.
-Several scripts, \path{bibdoiadd}, \path{bibmradd} and \path{bibmradd}
+Several scripts, \path{bibdoiadd}, \path{bibmradd} and \path{bibzbladd}
take a \path{bib} file, and add to each entry a DOI, MR or ZBL number
correspondingly, if they can find this entry in the corresponding
database.
-Script \path{bbl2bib} tries to reconstruct a \path{bib} file from the
+The \path{bbl2bib} script tries to reconstruct a \path{bib} file from the
corresponding \path{thebibliography} environment. One can argue that
-this operation is akin to reconstructing a cow from the steak. The
-way the script does it is searching for the entry in the MR database,
+this operation is akin to reconstructing the cow from a steak. The
+way the script does it is by searching for the entry in the MR database,
and creating the corresponding Bib\TeX\ fields.
-Below are manual pages for these scripts.
+I am grateful to Josko Plazonic from Princeton Math Dept whose
+(unpublished) Python script was an inspiration for this suite.
+
+Following are manual pages for these scripts.