summaryrefslogtreecommitdiff
path: root/support/crossrefware/head.ltx
blob: 72ae89028e64484173d378ff134948ab49c5183a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
\documentclass[11pt]{article}
\usepackage{makeidx,fullpage}
\usepackage[hidelinks]{hyperref}
\makeindex
\begin{document}
\sloppy
\title{Crossrefware documentation\thanks{This work was commissioned by
  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 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.

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.

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{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.   

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 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.

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.