Make the citation links go to the DOI links

[wd15]

Remove http://www.ctcms.nist.gov/fipy/documentation/refs.bib_cited.html and simply go straight to the DOI line where possible or at least provide the link alongside the listings.

Imported from trac ticket #457, created by wd15 on 08-16-2012 at 16:18, last modified: 09-11-2013 at 17:19

[guyer]

Linking straight to the DOI would be a mistake, as the link might not always work and then there'd be no trace of what we were referencing.

changeset:e3a63fba4f/fipy switched to [https://github.com/mcmtroffaes/sphinxcontrib-bibtex sphinxcontrib-bibtex], which relies on [http://pybtex.sourceforge.net pybtex]. The [http://bazaar.launchpad.net/~ero-sennin/pybtex/trunk/view/head:/pybtex/style/formatting/unsrt.py#L418 development version of pybtex] renders DOIs, but I can't get this to work with [https://github.com/mcmtroffaes/sphinxcontrib-bibtex sphinxcontrib-bibtex] right now: mcmtroffaes/pybtex-docutils#3.

We should keep an eye on [https://github.com/mcmtroffaes/sphinxcontrib-bibtex sphinxcontrib-bibtex] and update the documentation when this problem is fixed.

Trac comment by guyer on 09-09-2013 at 11:24

[fipymigrate]

In 4aabf41:

#CommitTicketReference repository="fipy" revision="4aabf41f64a88c223f8c058c19292a56dadb389f"
List requirements for building documentation

We have not kept up to date with what's needed for Sphinx to build the
docs.

Addresses issue #334

Trac comment by Jonathan Guyer guyer@nist.gov on 09-09-2013 at 18:21

[fipymigrate]

In 5dfdc19:

#CommitTicketReference repository="fipy" revision="5dfdc194c014695405dd2238e54d56d4495c226a"
Remove URLs redundant to DOIs

Addresses issue #334

Trac comment by Jonathan Guyer guyer@nist.gov on 09-09-2013 at 18:21

[guyer]

Turns out I didn't have the [http://bazaar.launchpad.net/~pybtex-devs/pybtex/trunk absolute latest of pybtex]. With everything at the bleeding edge, DOIs get rendered properly as links.

Pull request:

The following changes since commit a1e9b1e148f1a4190b042789fffbdab75adeb772:

  Document additional Sphinx package (2013-09-09 10:44:31 -0400)

are available in the git repository at:

  ssh://git@code.matforge.org/nist/fipy.git ticket457-Make_the_citation_links_go_to_the_DOI_links

for you to fetch changes up to 5dfdc194c014695405dd2238e54d56d4495c226a:

  Remove URLs redundant to DOIs (2013-09-09 18:16:03 -0400)

----------------------------------------------------------------
Jonathan Guyer (2):
List requirements for building documentation
Remove URLs redundant to DOIs

 documentation/USAGE.txt | 25 +++++++++++++++++++++++--
 documentation/refs.bib  |  6 ------
 2 files changed, 23 insertions(+), 8 deletions(-)

Trac comment by guyer on 09-09-2013 at 18:29

[fipymigrate]

In 8e96cf5:

#CommitTicketReference repository="fipy" revision="8e96cf5ab75549e4d52ace770bfbce043a75e9e0"
Merge branch 'ticket457-Make_the_citation_links_go_to_the_DOI_links' into develop

Fixed issue #334

Trac comment by Daniel Wheeler daniel.wheeler2@gmail.com on 09-11-2013 at 17:19