philliplord

This plugin displays who, what and when information about a blog and its 
posts; it provides widgets which readers can see, as well as a computational 
representation that allows computers to extract the same information. This 
provides greater clarity on who posts are written by, and how they should be 
cited. Readers can download the citation as a BibTeX file. Another widget 
provides deep links through to Web Archives, allowing readers to check old 
versions of posts.
It is part of the Knowledgeblog project (http://knowledgeblog.org), which is 
developing plugins to improve WordPress as a tool for academic publishing, 
either for individual authors, or for conferences and workshops publishing 
proceedings to the web. As well as this file, additional documentation is 
available at 
<a href="http://process.knowledgeblog.org/category/kblog-metadata" rel="nofollow ugc">process</a>.
It is often useful to embed bibliographic metadata, describing the author(s), 
title and publication date into a web page. There are a variety of different 
ways of doing this, described in a variety of different specifications and/or 
standards. These vary widely in their formality, uptake and age, as well as 
clarity with which the specification is written.
The practical upshot of this is that automatic capture of metadata which 
enables tools such as Greycite (http://greycite.knowledgeblog.org) and various 
bibliographic software to work is a somewhat ad hoc affair. Sometimes it 
works, sometimes it does not. Rather than requiring users to add a separate 
plugin for each of these specifications, kblog-metadata takes the approach of 
adding metadata in as many formats as possible, in the hope that, for any 
tool, at least one will work.
Kblog Metadata enhances the ability of WordPress to expose and edit 
bibliographic metadata of academic posts. It consists of a number of 
pieces of functionality
<ul>
<li>kblog-headers — adds invisible metadata</li>
<li>kblog-authors — allows multiple authors, without requring WordPress accounts</li>
<li>kblog-table-of-contents — displays all posts in a variety of formats. </li>
<li>kblog-title — set container titles (“blogname”) per post or using a custom taxonomy.</li>
<li>kblog-boilerplate — displays citation information as widget or in post 
content</li>
<li>kblog-download — downloaded bib or other formats for posts</li>
<li>kblog-archive — widget to display web archives</li>
</ul>
We will include new formats or specifications where possible, so long as they 
are not too computationally intensive. Please send email to the <a href="mailto:knowledgeblog@googlegroups.com" rel="nofollow ugc">mailing 
list</a> if you are interested in a new format.
<h3>Kblog Headers</h3>
There are many tools to which academics may want to advertise their work. We 
currently support three independent standards which are:
<ol>
<li>COinS (http://ocoins.info).</li>
<li>Meta tags as suggested by Google Scholar.</li>
<li>Open Graph Protocol (http://ogp.me) </li>
</ol>
These will be automatically added to add pages and posts on installation of 
the plugin. The metadata is taken either from the user profile, the WordPress 
metadata, or from Kblog Author metadata.
<h3>Kblog Table of Contents</h3>
The table of contents functionality comes in two forms: one designed for 
embedding in an existing page, and one for computational consumption. To add a 
table of contents to a page add a “shortcode” to your post contents.
[kblogtoc]
Additionally, it is also possible to retrieve a simple HTML or plain text 
representation of the table of contents from (http://blogurl/?kblog-toc=txt) 
or (http://blogurl/?kblog-toc=html). Author information comes from 
Kblog Author.
You can specify the default category for the table of contents from the 
Settings Menu, or accept the default which is to show them all.
<h3>Kblog Authors</h3>
Academic writing is more often multi-author than not, yet this is poorly 
supported within WordPress. While there are existing co-author plugins these 
often require assigning multiple user accounts, one per author, even though 
many authors will never login to WordPress. Within Kblog Authors you can add 
“display authors”, totally independently from WordPress accounts. They will 
appear on Kblog Table of Contents and in metadata generated by Kblog Headers.
Authors can be added either on the “Edit Post” page of WordPress, or through 
the use of an [author] shortcode within the document content. Authors 
specified within the post content take precedence.
<h3>Kblog Title</h3>
Authors may wish to alter the apparent title of their blog for a post or a 
group of posts. For example, I may wish to publish a paper that I have written 
for a conference on my own blog, but wish the metadata to refer to the 
conference. Alternatively, as with 
<a href="http://bio-ontologies.knowledgeblog.org" rel="nofollow ugc">bio-ontologies</a> I may wish to host 
multiple meetings on a single website (one per year, for instance), and have 
the year, or meeting number, appear in the metadata. Kblog Title allows both 
of these uses, by allowing the user to set the container name (“blogname”) 
either for an individual post, or using an Event tag.
<h3>Acknowledgements</h3>
kblog-metadata includes the HumanNameParser from Jason Priem 
(http://jasonpriem.org/human-name-parse/) which is licensed under the MIT 
License.
<h3>Copyright</h3>
This plugin is copyright Phillip Lord, Newcastle University and is licensed 
under GPLv2.

Kblog Metadata

Displays bibliographic metadata both for humans and computers.

With this plugin you can include content from arXiv or other academic 
repositories in your blog post. For example, if placing
<pre><code>[kblog-inc server="arxiv"]1303.0213[/kblog-inc]
</code></pre>
in your blog post, the abstract of this article will be include at this point 
in text. Additionally, the title will be set to the title of the article (“The 
semantic web takes wing” in this case). Finally, if you have use 
<a href="kblog-metadata" rel="nofollow ugc">https://wordpress.org/plugins/kblog-metadata/</a>, the authors, 
and date will be set appropriately also.
It is possible to add additional material to the post as normal; for example, 
with my 
<a href="papers" rel="nofollow ugc">http://www.russet.org.uk/blog/category/all/professional/science/papers</a>, 
I add a plain English summary, and where the authors allow, I also add the 
reviews; an example can be seen for the above 
<a href="[paper" rel="nofollow ugc">http://www.russet.org.uk/blog/2366</a>.
Kblog-include uses OAI-PHM to harvest the metadata that is displays; as this 
is a standard, it should mean that kblog-include can transclude from any 
repository that supports this standard. In practice, unfortunately, different 
repositories use the tags in different ways. Currently, kblog-include supports 
http://arxiv.org, the [http://eprint.ncl.ac.uk](Newcastle University) eprints 
server, and <a href="Greycite" rel="nofollow ugc">http://greycite.knowledgeblog.org</a>. For example:
[kblog-inc server=”eprint.ncl.ac.uk”]193637[/kblog-inc]
Shows one of my papers.
I am open to requests for new servers, ideally, via 
[https://github.com/phillord/kblog-include](pull request), or email otherwise.

Kblog Include

Transcludes content from arXiv and other academic repositories.

Kblog Metadata vs Kblog Include