Naming and Delivery Specifications
Learn how to name and package article data files for delivery to PMC. Use these standard formats to allow PMC to efficiently process and archive your publisher-supplied article content.
Abbreviations
jour - a journal identifier, such as an alphanumeric journal abbreviation or ISSN
vol - a journal volume
iss - a journal issue
uid - any unique identifier for an article, typically the article's elocation-id or first page number
timestamp - a unique timestamp
type - optional. It can identify any of the following file types:
- -g figure graphic + alphanumeric identifier
- -i inline graphic + alphanumeric identifier
- -s supplementary material file + alphanumeric identifier
ext - the lowercase file type extension
How to Deliver Files to PMC
PMC will provide you with an FTP account to use, for either your technical evaluation or your production deposits.
- All content sent to PMC must be sent via FTP.
- Do not send files as attachments to an email message.
- If your deposit contains substantial change, or is otherwise unusual, please notify your PMC contact via email.
How to Name Article Data Files
Article data files should be named systematically and consistently, and should contain all major article identifying information, such as jour, vol, iss and uid as defined in the box below. Examples of well-named files can be found in the table below.
Guidance for systematic file naming
- All file names must be unique within a volume. No two articles can use the same file name.
- XML and PDF base file names must match exactly.
- Names of image files and supplemental data files must match the names referenced in the XML file.
- File names cannot contain spaces.
- File names cannot contain special characters, such as ?, %, #, /, or :
Examples of well-named article data files
In the examples in this table, file names are constructed for a hypothetical journal, Biological Testing.
File Type | Naming Scheme | Example Name |
---|---|---|
Article XML
|
jour-vol-uid.ext jour-vol-iss-uid.ext |
biotes-10-bt.12345.xml biotes-10-01-bt.12345.xml |
Article PDF |
jour-vol-uid.ext jour-vol-iss-uid.ext |
biotes-10-bt.12345.pdf biotes-10-01-bt.12345.pdf |
Figures and Inline Graphics |
jour-vol-uid-type.ext jour-vol-iss-uid-type.ext |
biotes-10-bt.12345-g001.tif biotes-10-bt.12345-g002.tif biotes-10-bt.12345-i001.png biotes-10-01-bt.12345-g001.tif biotes-10-01-bt.12345-g002.tif biotes-10-01-bt.12345-i001.png |
Supplementary Materials |
jour-vol-uid-type.ext jour-vol-iss-uid-type.ext |
biotes-10-bt.12345-s001.mpg biotes-10-bt.12345-s002.doc biotes-10-bt.12345-s003.csv biotes-10-01-bt.12345-s001.mpg biotes-10-01-bt.12345-s002.doc biotes-10-01-bt.12345-s003.csv |
How to Package Article Data Files
All article content sent to PMC must be packaged in a compressed data file. PMC currently accepts the following compression formats: .zip, .tar, .gz, and .tgz.
PMC strongly prefers article data files that are collected into article-based packages; however, in special circumstances, PMC will accept collection-based packages. The elements making up the package naming scheme should reflect the journal's publication model.
- Article-based packaging: an individual article's data files are deposited in a single compressed data package.
- Collection-based packaging: all the data files for a collection of articles, such as a complete issue or volume, are deposited at the same time in a single compressed data package.
PMC only supports a single level of file decompression. For either packaging method, collect all article files directly into a compressed data package. Do not use 'nested' zips or subdirectories.
Below are examples for article-based and collection-based packaging.
Article-based delivery package (preferred)
Naming Scheme(s) | Example Names |
---|---|
jour-vol-iss-uid.ext jour-vol-uid-timestamp.ext |
biotes-10-01-bt.12345.zip biotes-10-bt.12345-20240510020202-1153344.zip |
Collection-based delivery package
Naming Scheme(s) | Example Names |
---|---|
jour-vol-iss.ext jour-vol-timestamp.ext |
biotes-10-01.zip biotes-10-20240510020202-1153344.zip |
How to Package Revision Files
Contents of Revision Packages | Naming Revision/Correction Packages
Contents of Revision Packages
Resubmit only files that have been modified, along with their corresponding XML files. If submitting replacement files for multiple issues, use a separate package for each issue. Do not combine files for different issues or journals in the same package.
The name of any replacement article data file (.xml, .pdf, .tif, etc.) must be identical to the original (replaced) file names.
Naming Revision/Correction Packages
Each revision package sent to PMC must include a suffix that differentiates the revision from the original package. The acceptable revision indicators are
- a revision notation, e.g. .r1, .r2, .r3 appended to the original file package name, or
- if the original packaging uses timestamps, then an updated timestamp is sufficient.