Merge branch 'ticket457-Make_the_citation_links_go_to_the_DOI_links' …

…into develop Fixed ticket:457
usnistgov · Sep 11, 2013 · 8e96cf5 · 8e96cf5
2 parents 96d5155 + f5153cc
commit 8e96cf5
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 8 deletions.
diff --git a/documentation/USAGE.txt b/documentation/USAGE.txt
@@ -653,11 +653,32 @@ command in the base directory::
 
    This mechanism is intended primarily for the developers. At a minimum, 
    you will need at least version 1.1.2 of `Sphinx
-   <http://sphinx.pocoo.org/latest>`_, plus all of its prerequisites.
+   <http://sphinx.pocoo.org/latest>`_, plus all of its prerequisites, 
+   although we build the documentation witih the latest development code 
+   (you will need hg_ installed)::
 
-   You will also need to `pip install sphinxcontrib-bibtex`.
+   $ pip install --upgrade -e hg+https://bitbucket.org/birkenfeld/sphinx#egg=sphinx
+
+   We use several contributed Sphinx plugins::
+
+   $ hg clone https://bitbucket.org/birkenfeld/sphinx-contrib/
+
+   $ cd sphinx-contrib/traclinks
+   $ python setup.py install
+
+   Bibliographic citations require the `sphinxcontrib-bibtex` package. For 
+   the moment, the development versions of several packages are required 
+   to properly render our bibliography (you will need both bzr_ and git_ 
+   installed)::
+
+   $ pip install -e bzr+lp:~pybtex-devs/pybtex/trunk
+   $ pip install -e git+git@github.com:mcmtroffaes/pybtex-docutils.git#egg=pybtex-docutils
+   $ pip install -e git+git@github.com:mcmtroffaes/sphinxcontrib-bibtex.git#egg=sphinxcontrib-bibtex
 
 .. _download the latest manual:  http://matforge.org/fipy/wiki/FiPyManual
+.. _hg: http://mercurial.selenic.com
+.. _bzr: http://bazaar.canonical.com
+.. _git: http://git-scm.com
 
 
 

diff --git a/documentation/refs.bib b/documentation/refs.bib
@@ -36,7 +36,6 @@ @article{BoettingerReview:2002
    volume =  32,
    year =    2002,
    pages =   {163-194},
-   url =     {http://arjournals.annualreviews.org/doi/abs/10.1146/annurev.matsci.32.101901.155803},
    doi =     {10.1146/annurev.matsci.32.101901.155803},
 }
 
@@ -47,7 +46,6 @@ @article{ChenReview:2002
    volume =  32,
    year =    2002,
    pages =   {113-140},
-   url =     {http://arjournals.annualreviews.org/doi/pdf/10.1146/annurev.matsci.32.112001.132041},
    doi =     {10.1146/annurev.matsci.32.112001.132041},
 }
 
@@ -87,7 +85,6 @@ @article{NIST:damascene:2001
    number =  1,
    year =    2001,
    pages =   016102,
-   url =     {http://link.aps.org/abstract/PRL/v87/e016102},
    doi =     {10.1103/PhysRevLett.87.016102},
 }
 
@@ -186,7 +183,6 @@ @article{WarrenPolycrystal
    number =  20,
    year =    2003,
    pages =   {6035-6058},
-   url =     {http://dx.doi.org/10.1016/S1359-6454(03)00388-4},
    doi =     {10.1016/S1359-6454(03)00388-4},
 }
 
@@ -199,7 +195,6 @@ @article{ElPhFI
    year =    2004,
    pages =   {021603},
    eprint =  {cond-mat/0308173},
-   url =     {http://link.aps.org/abstract/PRE/v69/e021603},
    doi =     {10.1103/PhysRevE.69.021603},
 }
 
@@ -212,7 +207,6 @@ @article{ElPhFII
    year =    2004,
    pages =   {021604},
    eprint =  {cond-mat/0308179},
-   url =     {http://link.aps.org/abstract/PRE/v69/e021604},
    doi =     {10.1103/PhysRevE.69.021604},
 }