From 9d67bfdcf1353cbb0d96f6eb0e10b469ab0020b9 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 3 Oct 2021 20:32:45 +0000 Subject: crossrefware (3oct21) git-svn-id: svn://tug.org/texlive/trunk@60689 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/support/crossrefware/Makefile | 20 ++++--- Master/texmf-dist/doc/support/crossrefware/README | 66 +++++++++++---------- .../doc/support/crossrefware/crossrefware.pdf | Bin 136411 -> 233582 bytes .../texmf-dist/doc/support/crossrefware/head.ltx | 47 +++++++++------ 4 files changed, 77 insertions(+), 56 deletions(-) (limited to 'Master/texmf-dist/doc/support') 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 Binary files a/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf and b/Master/texmf-dist/doc/support/crossrefware/crossrefware.pdf 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. -- cgit v1.2.3