From PangaWiki
Jump to: navigation, search
PanXML icon. Downloaded from All free icons listed on this page are licensed under a Creative Commons Attribution-Share Alike 3.0 License. This means that you can freely use these icons for any personal and commercial purposes (software interfaces, online services, blogs, templates etc.). However, you should include a link to in your credits.

The software PanXML is a tool to create XML files needed for DOI registration at the German National Library of Science and Technology (TIB). A XML file created by PanXML is based on the XSD file article-doi_v3.2.xsd. Further schemas may be added on request.

Find the current version and reference of PanXML at doi:10.1594/PANGAEA.746153

Find Sourcecode at GitHub

Contact: Rainer Sieger. The software is provided as freeware under the (GNU General Public License (GPLv3) and is freely distributed without warranty by the Alfred Wegener Institute, Helmholtz Center for Polar and Marine Research, Bremerhaven.


Open doi:10.1594/PANGAEA.746153 and click on "View dataset as HTML". Download the current version of PanXML to your computer.


Double-click PanXML_Win.exe and follow the instructions.


Open the downloaded dmg file with a double-click. Drag and drop the file onto the appliction folder icon.


Uncompress the archive to your user bin directory. Double-click

Reference and detailed description

Fig. 1: Create DOI XML dialog

Create XML file...

Users can create a single XML file for the registration using the dialog which is shown in fig. 1.

First step of creating a single DOI XML is to choose the directory for the output file using the button "Browse...". The DOI can be given in free text form. The entry "auto" will be replaced by the name of the journal, the year, the volume number, and the number of the first page.


Author(s): the names of the authors of the article. The "; " or "//" is the list delimiter.

Title: the title of the article without a dot at the end of the line.

Year: the year of publication. It will be expanded to the date (yyyy-01-01) of publication needed by the XML Schema.

Volume: the volume number of the article.

Issue: the issue number of the article.

First page: first page of the article.

Last page: last page of the article.

Language: the subdialog offers five entries (de = German, en = English, es = Spanish, fr = France, ru = Russian). Further languages may be added on request.

Description: the description field can be filled with a short text without line breaks.

Discipline: the subdialog for the discipline of the publication gives a small list of entries.

Type: the type of the publication can be chosen from a list.


Title: the title of the journal.

Publisher: the publisher of the journal.

Contributor: the contributor of the journal.

Place: the town where the journal was published.

Identifier: the identifier of the journal (e.g. ISSN or eISSN)


The button "Example" sets all fields to a valid configuration. The button "New" resets all entries.

The button "OK" starts the process of creating a DOI XML in the output directory. The XML Schema will be downloaded from the PANGAEA website to the output directory as reference.

Fig. 2: Encoding dialog

Reference list -> XML files

For a large number of articles PanXML can generate the XML files for the DOI registration in a batch process.

Before the process can start, the user has to choose the encoding of the input file (UTF-8, Latin-1, Apple Roman) and to choose the output directory with the button "Browse...". The encoding of the output XML files is always UTF-8.

PanXML asks for the reference list and then creates all XML files for the arcticles listed in this list.

Send all XML files together with the corresponding PDF files and the XSD file to the TIB. The use of a compression program like 7-Zip is recommended.

Create reference list as template

The user has to create a list of references with an editor that is able to save the document as tab delimited text file (txt). An example for a reference list like that can be created by PanXML with this menu.