This is an old revision of the document!
Table of Contents
PubMed2020 Plugin
Compatible with DokuWiki
Greebo, Frusterick Manners, Elenor Of Tsort, Detritus
Description
This plugin retrieves the MedLine description of articles and books recorded in the NCBI PubMed database and allow users to easily include article citation into their DokuWiki pages. The MedLine content is cached in the media directory of your wiki. This plugin is 100% compatible with the new citation interface of PubMed (as of 05/2020).
This plugin is perfectly adapted to dokuwiki farms and works with PHP 5.6+.
Authors and licence
- Ikuo Obataya wrote the pubmed plugin in 2007-2016
- Eric Maeker improved this first plugins (without integrating new Ikuo code) from 2016 to 2019
- Code was rewritten in 2020 due to PubMed new API (see updateCtx)
- License : Public Domain
- Version : 2020-05-27
Examples/Usage
- See in action inside a farm animal (at the bottom of the page)
- See in action (in combination with RefNotes plugin)
Installation
Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually. The local plugin directory must have the same name as the plugin is named, otherwise the plugin won't work properly.
Syntax
Including article citation into your pages
The syntax is quite easy: {{pmid>01234567}}
or {{pmid>command:01234567}}
Using the default options:
{{pmid>24073682}}
where 24073682 is the PMID of the article as notified by pubmed.
{{pmid>user:24073682}}
where 24073682 is the PMID of the article as notified by pubmed and the default user parameter will be used to create the article citation.
Using specific formula:
{{pmid>long:24073682}}
where 24073682 is the PMID of the article as notified by pubmed and long is the selected article citation formula.
You can require multiple citations at once (creating a nice HTML list):
For example this list uses the citations used as examples in the Vancouver referencing paper {{pmid>vancouver:19171717,12142303,12028325,12084862,12166575,15857727}}
Including links to pubmed search page
You can also use this plugin to create pubmed search URL.
{{pmid>search:"Inappropriate Prescribing"[Mesh]}}
{{pmid>search:"Drug-Related Side Effects and Adverse Reactions"[Mesh] AND (Review[ptyp] AND "loattrfree full text"[sb])}}
Options
Citation formula
- The article citation can be automatically included using pre-formatted outputs:
- vancouver : Full Vancouver citation see Vancouver.
- short : ISO citation in a short way.
- long : full ISO citation including all authors, article title, journal title, volume, year, month, pages.
- long_tt : same as long but with translated title (if exists)
- long_pdf : full ISO citation including all authors, article title, journal title, volume, year, month, pages. If you own the PDF file a link will show.
- long_tt_pdf : same as long_pdf but with translated title (if exists)
- long_abstract : append the full abstract to the long citation. The abstract can toggled and is hidden by default.
- long_tt_abstract : same as long_tt_abstract but with translated title (if exists)
- long_abstract_pdf : append the full abstract to the long citation. The abstract can toggled and is hidden by default. If you own the PDF file a link will show.
- long_tt_abstract_pdf : same as long_tt_abstract_pdf but with translated title (if exists)
- or user defined : you can define you own citation formula (see below).
- Provides by default a link to the PubMed page and to the free full text in PMC if exists.
User defined citation
You can define in the configuration a simple string to define your own citation formula. The following tokens are available.
Token | Content |
---|---|
%pmid% | PMID with a link to pubmed citation |
%type% | Type of the citation (“article”, “book”) |
%authors% | All authors (complete lastname) |
%authorsVancouver% | All authors (initials lastname) |
%first_author% | Only first author +/- “et al” |
%corporate_author% | Author collective |
%title% | Title of the article |
%title_tt% | Translated title in the original language of the publication |
%book_title% | Title of the Book |
%collection_title% | Title of the collection |
%copyright% | Copyright |
%country% | Country |
%lang% | Language of the article |
%journal_iso% | ISO Journal title (abbrev) |
%journal_title% | Full Journal title |
%journal_id% | Journal ID |
%iso% | Self computed ISO citation |
%so% | Medline ISO citation |
%vol% | Volume |
%issue% | Issue |
%year% | Year |
%month% | Month |
%pages% | Pages |
%abstract% | Abstract (togglable) |
%doi% | DOI of the publication |
%pii% | PII of the publication |
%journal_url% | Link to Journal web site using the DOI |
%pmc_url% | If available, link to free PDF of the article. |
%abstractFr% | Show french translated abstract (see specific doc) |
%localpdf% | Add link to local PDF file (see specific doc) |
Hard coded formula | Content |
---|---|
short | %first_author%. %iso%. %pmid%. %journal_url% %pmc_url% |
long | %authors%. %title%. %iso%. %pmid%. %journal_url% %pmc_url% |
long_pdf | %authors%. %title%. %iso%. %pmid%. %journal_url% %pmc_url% %localpdf% |
long_abstract | %authors%. %title%. %iso%. %pmid%. %journal_url% %pmc_url% %abstract% %abstractFr% |
long_abstract_pdf | %authors%. %title%. %iso%. %pmid%. %journal_url% %pmc_url% %abstract% %abstractFr% %localpdf% |
long_tt | %authors%. %title_tt%. %iso%. %pmid%. %journal_url% %pmc_url% |
long_tt_pdf | %authors%. %title_tt%. %iso%. %pmid%. %journal_url% %pmc_url% %localpdf% |
long_tt_abstract | %authors%. %title_tt%. %iso%. %pmid%. %journal_url% %pmc_url% %abstract% %abstractFr% |
long_tt_abstract_pdf | %authors%. %title_tt%. %iso%. %pmid%. %journal_url% %pmc_url% %abstract% %abstractFr% %localpdf% |
Styling
You can change the style of your citation. Please take a look at the style.css file for further information.
Using local PDF
You get a direct link to your media PDF files of publications. You have to save the PDF files in the media directory: media/pubmed/pmid_pdf
or media/pubmed/doi_pdf
. Just use the PMID or DOI as file name. It is recommanded to use the PMID mode.
Specific commands
- Some more commands are available:
- test only for devs
- raw_medline show the retrieved MedLine code. summaryxml:24073682
- clear_raw_medline : clear all cached Medline files
- remove_dir : remove the cache directory (by default /data/media/pubmed)
- recreate_cross_refs : recreate the crossref (DOI ↔ PMID)
- full_pdf_list : show all available PDF (see specific doc)
- To use these commands, use this syntax:
{{pmid>cmd}}
Configuration and Settings
- This plugin comes with some configuration parameters:
- Default citation formula.
- Default user defined formula.
- Default authors limitation in Vancouver citation
- Default string replacement of authors over the Vancouver author limitation
Development
Change Log
- New version 2023-01-13 (2023-01-12 06:48)
- sciencedirect urls (2022-12-23 17:19)
- ScienceDirect urls (2022-12-23 17:19)
- Some improvements in managing titles and abstracts (2022-12-23 17:18)
- Title and abstract normalization additions (2022-02-05 10:32)
- NPG citation format correction (when no vol or issue) (2022-02-05 10:32)
- PubMed search link -> span instead of div (2022-01-04 14:37)
- Correctly manages commands even if doc_format used (2022-01-04 14:36)
Report Bugs and Issues
Please use the github repository to adress any comments, issues or wishes.
Roadmap
- Get related using eftech
- Show Mesh terms
- Search Mesh terms extracted from a PMID