The FTP push protocol
On this protocol, journal metadata are uploaded to PhilPapers by
journal editors as they become available. Some journal hosting
companies (e.g. Atypon) already support this protocol.
In order to use this protocol, you must first obtain a user id and
password from the PhilPapers General Editors (
contact us), and submit a list of the
titles you would like to be indexed. Metadata should be uploaded as
follows.
Connecting to the server
The FTP server is feeds.philpapers.org. It does not use secure FTP but
normal FTP. You will use the username and password provided to you by the editors.
What to upload
PhilPapers only indexes research articles and book reviews. Please do not upload prefaces, errata and the like.
The file format
PhilPapers supports the
NLM Archiving and Interchange format versions 1.0 and 2.2
with one article per file.
Not all elements included in the examples are mandatory. For a regular journal article, the mandatory elements are:
- Authors' names
- Article title
- Journal name (journal title)
- Volume, issue, and page numbers
- Either a DOI or a link to the full text of the article (we prefer to have both)
- An abstract
For book reviews:
- Authors' names
- Either a title for the review or the author(s) and title(s) of the reviewed works (it is best when both can be provided).
- Journal name
- Volume, issue, and page numbers
- Either a DOI or a link to the full text of the review
Packaging the files
You can upload separate nlm files or zip archives. Currently only the
zip compression format is supported (on Unix/Linux use
"$zip -r directory.zip directory"
command to zip a directory).
Uploaded files should have unique names. For example, files could be
named sequentially ("upload1.zip", "upload2.zip", etc.).
Metadata from different journals can be combined in the same zip files.
Important notes
- Use only entities defined in the appriopriate DTD. Preferably, use only standard XML entities.
- PhilPapers may not index all the items for which you submit
metadata. In general, front matter material is discarded.
- Make sure to review your journals in the index. Use the "browse
journals" feature for this, as the "recent items" page may not show
everything that you upload.
- It can take up to 24 hours for uploaded material to become available on PhilPapers.
