Skip to content

boxuk/academic-bloggers-toolkit

 
 

Repository files navigation

Call for maintainers

I personally have not needed to use this plugin for a couple of years and am too busy to devote time to maintain it on my own. If you are interested in becoming a maintainer, please reach out via a new Github issue. Thank you!

ABT Banner Donate Maintainability WordPress WordPress rating

An open source WordPress plugin providing an all-in-one solution for effective academic blogging.

Contents

Manifesto

To my knowledge, there is not one citation plugin that exists for WordPress that does its job the way it should. Every other citation plugin uses WordPress shortcodes to render citations. Is that a bad thing. Yes. Here's why:

Once you commit to using a plugin that uses shortcodes to render content, you're stuck with it for the life of your website. If you uninstall that plugin, all posts which rely on the shortcodes from that plugin break. Additionally, if the person who wrote the plugin decides he/she no longer wants to support it and the shortcode API changes, all of your posts will break. This is unacceptable for academic writing.

This plugin generates plain, beautiful HTML and renders it at the time of insertion. There are zero shortcodes. There is zero chance of your posts breaking.

Need to write one long blog post with lots of references? Download this plugin, write the post, and then delete the plugin if you don't need it any longer. Freedom.

Features

  • Insert formatted references on the fly using PMID, PMCID, DOI (CrossRef, DataCite, & mEDRA), URL, or ISBN.
  • Manually insert formatted references from over 15 types of references.
  • Import a full bibliography from your favorite reference manager using an exported .ris or BibTeX file.
  • Automatically format references for every citation style on planet earth (over 1300).
  • Fully interactive reference list which lives beside the post editor.
  • Search PubMed from the post editor and insert references instantly.
  • Inline citations display full formatted references on the frontend when hovered with the mouse (or when tapped on mobile). No more scrolling down and losing your focus!

Translations

Click Here to Translate this Plugin

Contributing

If you'd like to contribute to this project, please read the contributor guide.

Building

If you'd like to build a production version of the plugin and push to the built branch, use the following steps:

  • npm run build
  • git checkout origin built
  • cp -r dist/* .
  • git add --all -- ':!dist/*' ':!src/*' ':!node_modules/*'
  • git push origin built

About

WordPress plugin providing an all-in-one solution for effective academic blogging.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 83.2%
  • PHP 10.5%
  • SCSS 5.6%
  • Other 0.7%