Merge pull request #168 from csdms/mcflugen/stable-update-references-…

…and-citations Update references and citations on stable branch
csdms · Nov 21, 2024 · 4c45986 · 4c45986
2 parents b144d1e + 394e752
commit 4c45986
Show file tree

Hide file tree

Showing 4 changed files with 77 additions and 61 deletions.
diff --git a/CITATION.rst b/CITATION.rst
@@ -4,33 +4,49 @@ Citation
 If you use the Basic Model Interface for work/research
 presented in a publication, we ask that you please cite:
 
-Peckham, S.D., Hutton, E.W., and Norris, B., 2013. A component-based approach to integrated modeling in the geosciences: The design of CSDMS. *Computers & Geosciences*, 53, pp.3-12, https://doi.org/10.1016/j.cageo.2012.04.002.
-
-Hutton, E.W.H., Piper, M.D., and Tucker, G.E., 2020. The Basic Model Interface 2.0: A standard interface for coupling numerical models in the geosciences. *Journal of Open Source Software*, 5(51), 2317, https://doi.org/10.21105/joss.02317
-
-BibTeX entries:
-
-::
-
-  @article{peckham2013component,
-   title={A component-based approach to integrated modeling in the geosciences: The design of CSDMS},
-   author={Peckham, Scott D and Hutton, Eric WH and Norris, Boyana},
-   journal={Computers \& Geosciences},
-   volume={53},
-   pages={3--12},
-   year={2013},
-   publisher={Elsevier}
-  }
-
-  @article{hutton2020basic,
-   doi = {10.21105/joss.02317},
-   url = {https://doi.org/10.21105/joss.02317},
-   year = {2020},
-   publisher = {The Open Journal},
-   volume = {5},
-   number = {51},
-   pages = {2317},
-   author = {Eric W.H. Hutton and Mark D. Piper and Gregory E. Tucker},
-   title = {The Basic Model Interface 2.0: A standard interface for coupling numerical models in the geosciences},
-   journal = {Journal of Open Source Software}
-  }
+.. tab-set::
+
+   .. tab-item:: APA
+
+      Peckham, S.D., Hutton, E.W., and Norris, B., 2013. **A component-based
+      approach to integrated modeling in the geosciences: The design of CSDMS**.
+      *Computers & Geosciences*, 53, pp.3-12,
+      https://doi.org/10.1016/j.cageo.2012.04.002.
+
+      Hutton, E.W.H., Piper, M.D., and Tucker, G.E., 2020. **The Basic Model
+      Interface 2.0: A standard interface for coupling numerical models in the
+      geosciences**. *Journal of Open Source Software*, 5(51), 2317,
+      https://doi.org/10.21105/joss.02317.
+
+   .. tab-item:: BibTeX
+
+      .. code:: bibtex
+
+        @article{peckham2013component,
+            title={
+                A component-based approach to integrated modeling in the
+                geosciences: The design of CSDMS
+            },
+            author={Peckham, Scott D and Hutton, Eric WH and Norris, Boyana},
+            journal={Computers \& Geosciences},
+            volume={53},
+            pages={3--12},
+            year={2013},
+            publisher={Elsevier}
+        }
+
+        @article{hutton2020basic,
+            doi={10.21105/joss.02317},
+            url={https://doi.org/10.21105/joss.02317},
+            year={2020},
+            publisher={The Open Journal},
+            volume={5},
+            number={51},
+            pages={2317},
+            author={Eric W.H. Hutton and Mark D. Piper and Gregory E. Tucker},
+            title={
+                The Basic Model Interface 2.0: A standard interface for coupling
+                numerical models in the geosciences
+            },
+            journal={Journal of Open Source Software}
+        }
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1,2 +1,3 @@
 furo
 sphinx
+sphinx_design
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -30,6 +30,7 @@
     "sphinx.ext.todo",
     "sphinx.ext.imgmath",
     "sphinx.ext.viewcode",
+    "sphinx_design",
 ]
 
 # Add any paths that contain templates here, relative to this directory.

diff --git a/docs/source/references.rst b/docs/source/references.rst
@@ -4,46 +4,44 @@ References
 ==========
 
 Community Surface Dynamics Modeling System (CSDMS)
+--------------------------------------------------
 
-  Syvitski, James P; Hutton, Eric; Piper, Mark; Overeem, Irina;
-    Kettner, Albert; Peckham, Scott (2014): "Plug and play component
-    modeling--the CSDMS 2.0 approach", *International Environmental
-    Modelling and Software Society (iEMSs), 7th International Congress
-    on Environmental Modelling and Software* (Ames DP, Quinn N., eds),
-    San Diego, CA, USA.
-    https://scholarsarchive.byu.edu/iemssconference/2014/Stream-B/4/ (retrieved 2023-11-23).
+Tucker, G. E., Hutton, E. W., Piper, M. D., Campforts, B., Gan,
+T., Barnhart, K. R., Kettner, A. J., Overeem, I., Peckham, S. D.,
+McCready, L., and Syvitski, J. (2022). **CSDMS: a
+community platform for numerical modeling of Earth surface
+processes**. Geoscientific Model Development, 15(4), 1413-1439,
+https://doi.org/10.5194/gmd-15-1413-2022.
 
 Basic Model Interface (BMI)
+---------------------------
 
-  Peckham, Scott D; Hutton, Eric WH; Norris, Boyana (2013): "A
-    component-based approach to integrated modeling in the
-    geosciences: The design of CSDMS", *Computers & Geosciences*,
-    **53**: 3-12, ISSN 0098-3004,
-    https://doi.org/10.1016/j.cageo.2012.04.002.
+Peckham, Scott D; Hutton, Eric WH; Norris, Boyana (2013): **"A
+component-based approach to integrated modeling in the
+geosciences: The design of CSDMS"**, *Computers & Geosciences*,
+**53**: 3-12, ISSN 0098-3004,
+https://doi.org/10.1016/j.cageo.2012.04.002.
 
-  Hutton, Eric WH; Piper, Mark D; Tucker, Gregory E (2020): "The Basic
-    Model Interface 2.0: A standard interface for coupling numerical
-    models in the geosciences", *Journal of Open Source Software*,
-    **5(51)**, 2317, https://doi.org/10.21105/joss.02317.
+Hutton, Eric WH; Piper, Mark D; Tucker, Gregory E (2020): **"The Basic
+Model Interface 2.0: A standard interface for coupling numerical
+models in the geosciences"**, *Journal of Open Source Software*,
+**5(51)**, 2317, https://doi.org/10.21105/joss.02317.
 
 Scientific Interface Definition Language (SIDL)
+-----------------------------------------------
 
-  Dahlgren, Tamara; Ebner, Dietmar; Epperly, Thomas; Kumfert, Gary;
-    Leek, James; Prantl, Adrian (2012): "Babel User's Guide: Part I
-    Foundation: SIDL Basics".
-    https://computing.llnl.gov/projects/babel-high-performance-language-interoperability/docs/users_guide/index008.html (retrieved 2019-10-09).
-
-  Epperly, Thomas GW; Kumfert, Gary; Dahlgren, Tamara; Ebner, Dietmar;
-    Leek, Jim; Prantl, Adrian; Kohn, Scott (2011): "High-performance
-    language interoperability for scientific computing through
-    Babel". *The International Journal of High Performance Computing
-    Applications*. **26** (3): 260–274.
-    https://doi.org/10.1177/1094342011414036
+Epperly, Thomas GW; Kumfert, Gary; Dahlgren, Tamara; Ebner, Dietmar;
+Leek, Jim; Prantl, Adrian; Kohn, Scott (2011): "High-performance
+language interoperability for scientific computing through
+Babel". *The International Journal of High Performance Computing
+Applications*. **26** (3): 260–274.
+https://doi.org/10.1177/1094342011414036
 
 Model grids
+-----------
 
-  Hoffmann, Klaus A; Chiang, Steve T (2000): Computational Fluid
-    Dynamics Volume I. Third edition. *Engineering Education System*.
+Hoffmann, Klaus A; Chiang, Steve T (2000): **Computational Fluid
+Dynamics Volume I**. Third edition. *Engineering Education System*.
 
-  Slingerland, Rudy; Kump, Lee (2011): Mathematical Modeling of
-    Earth's Dynamical Systems: A Primer. *Princeton University Press*.
+Slingerland, Rudy; Kump, Lee (2011): **Mathematical Modeling of
+Earth's Dynamical Systems: A Primer**. *Princeton University Press*.