Ortext BibTex to WordPress Reference Importer

The Ortext BibTex Importer plugin imports reference in BibTex format into a WordPress post type. For this ortext, references are imported into the custom post_type refs. One post is created for each reference. A field otx-key must be included in the BibTex string to support key linking. The BibTex Importer includes the source BibTex in the post meta field _otx-bibtex. The post title is set to the otx-key followed by the (truncated if necessary) reference title.

For each reference to be imported, the importer checks if its otx-key already exists among the posts in the targeted post_type. If it does, it will not import the reference. If you want to re-import all your references, you can delete all the references in post_type refs (or in whatever other post_type you’re targeting) and re-import them all.

The importer converts the BibTex DOI or URL field, if it’s non-empty, to a hyperlink. In addition, the URLl is stored as the value for the reference post meta-key _otx-ref-url. That meta-value could be used to redirect links externally. Using the value of the meta-key _otx-bibtex, all the references fields could be easily accessed programmatically.

The BibTex importer includes some fairly old parsing code. As a security precaution, we suggest using the BibTex Importer only for BibTex files that you create and control. In addition, good security practice is not to have unused code on a public server. If you want to use the BibTex Importer on a public server, we suggests that you install it, use it for your specific import job, then remove it from the public server.

All the references in this ortext are listed as BibTex strings in site archive file references.txt For this ortext, we maintained its references in EndNote. We labeled a custom field in EndNote as otx-key. Whenever we entered a reference in EndNote, we added a value for otx-key. We exported the references from EndNote as BibTex and then imported them into this ortext under the custom post_type refs.

The references include a reference-type field. The reference types included in this ortext are:

  • Book
  • Book Section
  • Edited Book
  • Government Document
  • Report
  • Case
  • Conference Proceedings
  • Thesis
  • Journal Article
  • Magazine Article
  • Newspaper Article
  • Web Page
  • Generic

The reference type determines the names of the fields associated with a reference of that type. Not all references have values for all fields. Fields that are empty are not included in the BibTex reference string.

As an experiment, you could delete all the references in the WordPress installation and re-import them with the Ortext BibTex Importer plugin and the file references.txt from the site archive. That should have no substantial effect on the ortext.

As a further experiment, you could copy one BibTex reference string into a separate file and there change its title field. Then delete that reference in your WordPress installation and re-import it. You can then search for links to it by its otx-key value. You’ll notice that the hyperlinks to the reference are broken. That’s because the hyperlinks depend on the reference post title. But if you flip all the internal hyperlinks in the ortext to key links, and then flip them back, the permalink will be correct.  If you don’t change the otx-key, you can always re-build correct hyperlinks by flipping from permalinks to key links and then back to permalinks.

Leave a comment (will be included in public domain license)

Your email address will not be published. Required fields are marked *