Update README.md
Update description, changelog and roadmap
This commit is contained in:
parent
aeff6f4aad
commit
d7311088b2
29
README.md
29
README.md
|
@ -1,19 +1,25 @@
|
||||||
<div align="center"><img src="https://github.com/ulaulaman/citations-tools/blob/master/assets/banner-772x250.jpg?raw=true" /></div>
|
<div align="center"><img src="https://github.com/ulaulaman/citations-tools/blob/master/assets/banner-772x250.jpg?raw=true" /></div>
|
||||||
|
|
||||||
The plugin add a shortcode in order to link a paper using its doi code. You can also use an other shortcode to resolve doi code and publish a full citation apa formatted.
|
Some tools for scientific and editorial bloggers.
|
||||||
|
|
||||||
# Description
|
# Description
|
||||||
|
The plugin add a shortcode in order to link a paper using its doi code. You can also use an other shortcode to resolve doi code and publish a full citation apa formatted. It is also a shortcode for manual citations.
|
||||||
|
|
||||||
|
## Link doi
|
||||||
|
|
||||||
Using the standard for doi link, the plugin introduce a shortcode in order to create a link to a paper provided by doi.
|
Using the standard for doi link, the plugin introduce a shortcode in order to create a link to a paper provided by doi.
|
||||||
How to use the shortcode:
|
**How to use the shortcode**:
|
||||||
|
|
||||||
[ctdoi code="..."]Title of the paper[/doi]
|
[ctdoi code="..."]Title of the paper[/doi]
|
||||||
|
|
||||||
|
## Doi resolver
|
||||||
|
|
||||||
The plugin send the doi code to [Crossref Metadata Search](https://search.crossref.org/), get the information and publish a full citation in apa standard with the shortcode [ctdoiresolve ...].
|
The plugin send the doi code to [Crossref Metadata Search](https://search.crossref.org/), get the information and publish a full citation in apa standard with the shortcode [ctdoiresolve ...].
|
||||||
How to use the shortcode:
|
**How to use the shortcode**:
|
||||||
|
|
||||||
[ctdoiresolve code="..."]
|
[ctdoiresolve code="..."]
|
||||||
|
|
||||||
There are also two optional parameters:
|
There are also three optional parameters:
|
||||||
|
|
||||||
[ctdoiresolve code="..." arxiv="..."]
|
[ctdoiresolve code="..." arxiv="..."]
|
||||||
|
|
||||||
|
@ -27,6 +33,18 @@ if the paper has a free pdf version
|
||||||
|
|
||||||
if the paper has a free version on [archive.org](https://archive.org/)
|
if the paper has a free version on [archive.org](https://archive.org/)
|
||||||
|
|
||||||
|
## Manual citations
|
||||||
|
|
||||||
|
There's also a shortcode for manual citations, [paperdata ...]. You can use it with the following syntax:
|
||||||
|
|
||||||
|
[paperdata auth="author/s name/s" year="..." title="..." journal="..." vol="..." issue="..." pages="..." code="..."]
|
||||||
|
|
||||||
|
You can also use the arxiv, pdfurl, archiveurl parameters.
|
||||||
|
|
||||||
|
## Styling
|
||||||
|
|
||||||
|
You can style citations adding in your css theme the class "paperdata".
|
||||||
|
|
||||||
## External service
|
## External service
|
||||||
|
|
||||||
**Digital Object Identifier**, or *DOI*, is a persistent identifier used to uniquely identify objects, standardized by the **International Organization for Standardization** (*ISO*). DOIs are mainly used to identify academic, professional, and government information, such as journal articles, research reports and data sets, official publications.
|
**Digital Object Identifier**, or *DOI*, is a persistent identifier used to uniquely identify objects, standardized by the **International Organization for Standardization** (*ISO*). DOIs are mainly used to identify academic, professional, and government information, such as journal articles, research reports and data sets, official publications.
|
||||||
|
@ -43,6 +61,7 @@ if the paper has a free version on [archive.org](https://archive.org/)
|
||||||
3. Use the shortcode into your posts or pages.
|
3. Use the shortcode into your posts or pages.
|
||||||
|
|
||||||
# Changelog
|
# Changelog
|
||||||
|
* 0.3 add shortcode for manual citations
|
||||||
* 0.2.6.1 update readme.txt
|
* 0.2.6.1 update readme.txt
|
||||||
* 0.2.6 add archive.org link in doi resolver as shortcode's parameter
|
* 0.2.6 add archive.org link in doi resolver as shortcode's parameter
|
||||||
* 0.2.5 fix error code
|
* 0.2.5 fix error code
|
||||||
|
@ -54,7 +73,7 @@ if the paper has a free version on [archive.org](https://archive.org/)
|
||||||
* 0.1 shortcode for doi link
|
* 0.1 shortcode for doi link
|
||||||
|
|
||||||
## Roadmap
|
## Roadmap
|
||||||
* add shortcode for manual citations (papers)
|
* ~~add shortcode for manual citations (papers)~~
|
||||||
* add shortcode for manual citations (books)
|
* add shortcode for manual citations (books)
|
||||||
* add arXiv resolver
|
* add arXiv resolver
|
||||||
* add pubmed resolver
|
* add pubmed resolver
|
||||||
|
|
Loading…
Reference in New Issue