XML Format
This page describes how to create a publications database file for use with
Publist.
If you prefer to forgo the instructions, or follow them with ease, I suggest
you download my own XML file,
and have a look.
You should start with an XML file that has only these two lines:
<pubDB>
</pubDB>
Anything you add should be between these two lines. Do not add any lines
before or after this section.
Now you can add all your publications one by one.
Let's start with an example, and then describe each field:
<publication>
<key>sc02</key>
<type>conference</type>
<authors>
Frachtenberg, Eitan and Petrini, Fabrizio and Fernandez, Juan and Pakin, Scott and Coll, Salvador
</authors>
<title>STORM: Lightning-Fast Resource Management</title>
<booktitle>
IEEE/ACM Conference on Supercomputing [[a href="http://www.sc-2002.org/"]]SC'02[[/a]]
</booktitle>
<pages>125--142</pages>
<address>Baltimore, MD</address>
<month>11</month>
<year>2002</year>
<team>true</year>
<area>Resource Management</area>
<subarea>STORM</subarea>
</publication>
Fields description
- publication: Not a field, but an indication of where a new publication entry starts (and ends).
- key: A unique string that identifies the publication (do not use '/' in key).
- type: Type of publication: can be for example one of: book, bookchapter, journal, conference, workshop, poster, report, talk, or thesis. You can also use any custom type of your own--see publist.ini for details.
- authors: List of authors, separated by " and ". Names must start with the last name, followed by a comma and the rest of the name, e.g. "Roosevelt, Franklin D. and Einstein, Albert".
- editors: For types "book" and "bookchapter". Same format at authors (optional).
- title: The title of the paper/publication.
- booktitle: The conference, journal, or framework where the publication was published.
- pages: Page numbers in proceedings or journal (optional).
- address: Location of the conference (optional, not expected for journal papers).
- volume: Volume of journal (optional).
- number: Journal issue number (optional).
- month: Numeric month of publication (1-12).
- year: Year of publication (four digits).
- isbn: ISBN number of book (optional).
- team: Should publication appear when using print_team() (optional, true/false).
- area: Area/field of publication (optional).
- subarea: Subarea/field of publication (optional).
Notes on syntax
- Line breaks and whitespace are allowed, and will not show on output page.
Use specific HTML/CSS commands (such as <br>) to force whitespace.
- Some fields are optional, or interchangeable. For example, a journal
may not have an address and a conference may not have a volume. You can also add your own custom fields.
In particular area and subarea are only used for sorting and selection queries,
and are not shown with the publication.
- Order of fields is not important, as long as all the required fields appear.
- Fields and field headers are case sensitive
- HTML code can be embedded in any of the fields' text, to create hyperlinks,
special formatting, etc. However, the "<" and ">" delimiters must be
replaced with "[[" and "]]" respectively, so as not to be considered part of the XML code.
An example is shown in the booktitle field above.
- Comments can be added to the XML file in the usual syntax,
e.g. <!-- This is a comment -->
Back to Publist's homepage