docs foot/bib fix

sandialabs · Jan 23, 2023 · 02210c2 · 02210c2
1 parent 9e6dbc7
commit 02210c2
Show file tree

Hide file tree

Showing 18 changed files with 35 additions and 111 deletions.
diff --git a/README.rst b/README.rst
@@ -2,7 +2,7 @@
 statMechCrack
 #############
 
-|build| |docs| |codefactor|
+|stable| |latest| |codefactor|
 
 Statistical mechanical models for crack growth. 
 
@@ -24,13 +24,7 @@ or using ``conda`` via the ``mrbuche`` channel on `Anaconda <https://anaconda.or
 
     conda install --channel mrbuche statmechcrack
     
-Alternatively, a branch can be directly installed using
-
-::
-
-    pip install git+https://github.com/sandialabs/statmechcrack.git@<branch-name>
-
-or after cloning a branch and executing ``python setup.py install``. Any installation is tested by executing ``python -m statmechcrack.tests``.
+Any installation is tested by executing ``python -m statmechcrack.tests``.
 
 ********
 Citation
@@ -51,11 +45,11 @@ Copyright 2022 National Technology & Engineering Solutions of Sandia, LLC (NTESS
 ..
     Badges ========================================================================
 
-.. |build| image:: https://img.shields.io/github/actions/workflow/status/sandialabs/statmechcrack/main.yml?branch=main&label=GitHub&logo=github
-    :target: https://github.com/sandialabs/statmechcrack
+.. |stable| image:: https://img.shields.io/badge/Docs-stable-8CA1AF?logo=readthedocs
+   :target: https://statmechcrack.readthedocs.io/en/stable
 
-.. |docs| image:: https://img.shields.io/readthedocs/statmechcrack?logo=readthedocs&label=Read%20the%20Docs
-    :target: https://statmechcrack.readthedocs.io/en/latest/
+.. |latest| image:: https://img.shields.io/badge/Docs-latest-8CA1AF?logo=readthedocs
+   :target: https://statmechcrack.readthedocs.io/en/latest
 
 .. |codefactor| image:: https://img.shields.io/codefactor/grade/github/sandialabs/statmechcrack?label=Codefactor&logo=codefactor
    :target: https://www.codefactor.io/repository/github/sandialabs/statmechcrack

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -26,7 +26,9 @@ def get_version():
 
 add_module_names = False
 bibtex_bibfiles = ['main.bib']
+bibtex_bibliography_header = ".. rubric:: References"
 bibtex_default_style = 'plain'
+bibtex_footbibliography_header = bibtex_bibliography_header
 extensions = [
     'matplotlib.sphinxext.plot_directive',
     'nbsphinx',
@@ -53,4 +55,5 @@ def get_version():
 plot_include_source = True
 plot_rcparams = {'font.size': 10}
 plot_formats = [('png', 300)]
+suppress_warnings = ["bibtex.duplicate_label"]
 templates_path = ['_templates']
diff --git a/docs/source/statmechcrack.core.rst b/docs/source/statmechcrack.core.rst
@@ -1,5 +1,5 @@
-statmechcrack.core module
-=========================
+statmechcrack.core
+==================
 
 .. automodule:: statmechcrack.core
    :members:
@@ -12,7 +12,5 @@ statmechcrack.core module
 
    <hr>
 
-**References**
-
 .. bibliography::
    :filter: docname in docnames
diff --git a/docs/source/statmechcrack.isometric.rst b/docs/source/statmechcrack.isometric.rst
@@ -1,5 +1,5 @@
-statmechcrack.isometric module
-==============================
+statmechcrack.isometric
+=======================
 
 .. automodule:: statmechcrack.isometric
    :members:

diff --git a/docs/source/statmechcrack.isotensional.rst b/docs/source/statmechcrack.isotensional.rst
@@ -1,5 +1,5 @@
-statmechcrack.isotensional module
-=================================
+statmechcrack.isotensional
+==========================
 
 .. automodule:: statmechcrack.isotensional
    :members:

diff --git a/docs/source/statmechcrack.mechanical.rst b/docs/source/statmechcrack.mechanical.rst
@@ -1,5 +1,5 @@
-statmechcrack.mechanical module
-===============================
+statmechcrack.mechanical
+========================
 
 .. automodule:: statmechcrack.mechanical
    :members:
@@ -12,7 +12,5 @@ statmechcrack.mechanical module
 
    <hr>
 
-**References**
-
 .. bibliography::
    :filter: docname in docnames
diff --git a/docs/source/statmechcrack.monte_carlo.rst b/docs/source/statmechcrack.monte_carlo.rst
@@ -1,5 +1,5 @@
-statmechcrack.monte\_carlo module
-=================================
+statmechcrack.monte\_carlo
+==========================
 
 .. automodule:: statmechcrack.monte_carlo
    :members:
@@ -12,7 +12,5 @@ statmechcrack.monte\_carlo module
 
    <hr>
 
-**References**
-
 .. bibliography::
    :filter: docname in docnames
diff --git a/docs/source/statmechcrack.rst b/docs/source/statmechcrack.rst
diff --git a/docs/source/statmechcrack.tests.__main__.rst b/docs/source/statmechcrack.tests.__main__.rst
diff --git a/docs/source/statmechcrack.tests.rst b/docs/source/statmechcrack.tests.rst
diff --git a/docs/source/statmechcrack.tests.test_boundary.rst b/docs/source/statmechcrack.tests.test_boundary.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_boundary module
-=========================================
+statmechcrack.tests.test\_boundary
+==================================
 
 .. automodule:: statmechcrack.tests.test_boundary
    :members:

diff --git a/docs/source/statmechcrack.tests.test_examples.rst b/docs/source/statmechcrack.tests.test_examples.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_examples module
-=========================================
+statmechcrack.tests.test\_examples
+==================================
 
 .. automodule:: statmechcrack.tests.test_examples
    :members:

diff --git a/docs/source/statmechcrack.tests.test_interface.rst b/docs/source/statmechcrack.tests.test_interface.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_interface module
-==========================================
+statmechcrack.tests.test\_interface
+===================================
 
 .. automodule:: statmechcrack.tests.test_interface
    :members:

diff --git a/docs/source/statmechcrack.tests.test_many.rst b/docs/source/statmechcrack.tests.test_many.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_many module
-=====================================
+statmechcrack.tests.test\_many
+==============================
 
 .. automodule:: statmechcrack.tests.test_many
    :members:

diff --git a/docs/source/statmechcrack.tests.test_one.rst b/docs/source/statmechcrack.tests.test_one.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_one module
-====================================
+statmechcrack.tests.test\_one
+=============================
 
 .. automodule:: statmechcrack.tests.test_one
    :members:

diff --git a/docs/source/statmechcrack.tests.test_style.rst b/docs/source/statmechcrack.tests.test_style.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_style module
-======================================
+statmechcrack.tests.test\_style
+===============================
 
 .. automodule:: statmechcrack.tests.test_style
    :members:

diff --git a/docs/source/statmechcrack.tests.test_zero.rst b/docs/source/statmechcrack.tests.test_zero.rst
@@ -1,5 +1,5 @@
-statmechcrack.tests.test\_zero module
-=====================================
+statmechcrack.tests.test\_zero
+==============================
 
 .. automodule:: statmechcrack.tests.test_zero
    :members:

diff --git a/docs/source/statmechcrack.utility.rst b/docs/source/statmechcrack.utility.rst
@@ -1,5 +1,5 @@
-statmechcrack.utility module
-============================
+statmechcrack.utility
+=====================
 
 .. automodule:: statmechcrack.utility
    :members: