Formatting updates and general clean up (#321)

* initial environment clean up

* remove unneeded version pin

* update project metadata and favicon

* set copyright year to start of project

* fix analytics

* turns out we needed the github_url config

* update blog formatting and minimize warnings

* update navbar link names

* add back in custom.css for the sidebar and minor config updates

* fix some link related warnings

Author: kafitzgerald

_templates/hello.html

@@ -1,11 +1,10 @@
 <div class="bio-info">
-  <div class="name">Earth System Data Science initiative at NSF NCAR</div>
+  <div class="name">Earth System Data Science (ESDS) at NSF NCAR & UCAR</div>
 
   <div class="whatido">
     <p>Building an inclusive sociotechnical network to promote effective synthesis
     and interpretation of data relevant to solving problems in Earth system
     science and supporting decisions within stakeholder communities.</p>
 
-    <p>The Earth System Data Science initiative follows these <a href="https://www.ucar.edu/accessibility">accsesibility guidelines</a></p>
   </div>
 </div>

about.md

@@ -1,4 +1,4 @@
-# About Us
+# About
 
 The Earth System Data Science (ESDS) initiative is a community
 with a common interest in advancing geoscientist’s ability to make
@@ -27,7 +27,7 @@ described in our [governance document](https://docs.google.com/document/d/1xjNzJ
 
 ## Vision
 
-_The Earth System Data Science initiative aims to profoundly increase the effectiveness of the NSF NCAR and UCAR workforce by promoting deeper collaboration centered on analytics, improving our capacity to deliver impactful, actionable, reproducible science and serve the university community by transforming how geoscientists synthesize and extract information from large, diverse data sets._
+The Earth System Data Science initiative aims to profoundly increase the effectiveness of the NSF NCAR and UCAR workforce by promoting deeper collaboration centered on analytics, improving our capacity to deliver impactful, actionable, reproducible science and serve the university community by transforming how geoscientists synthesize and extract information from large, diverse data sets._
 
 Effective synthesis and analysis of large datasets is a rate-limiting step to advancing science across NSF NCAR and UCAR and our community. Recent developments in open-source scientific software, notably those identified by the [Pangeo community](https://pangeo.io/), provide both inspiring technical solutions to Big Data geoscience problems and paradigms for large-scale collaboration. Analysis workflows across NSF NCAR and UCAR share much in common, despite disciplinary differences; thus, a focus on data and its transformation into useful information illuminates the potential for novel collaborations across the organization. Moreover, open, collaborative development focused on reproducible science holds transformative potential for how NSF NCAR and UCAR and the community approaches science.
 

communication.md

@@ -1,4 +1,4 @@
-# Communication and Meetings
+# Community
 
 ## Email List
 
@@ -49,7 +49,7 @@ Slack is an asynchronous messaging platform which can be used for both private m
 
 ## ESDS Forum
 
-Every other Monday from 2-3pm MT, we hold the ESDS Forum over [Google Meet](meet.google.com/mfb-whpi-tnj), which provides a venue for discussion, coordination and showcasing work in progress. Examples include:
+Every other Monday from 2-3pm MT, we hold the ESDS Forum over [Google Meet](https://meet.google.com/mfb-whpi-tnj), which provides a venue for discussion, coordination and showcasing work in progress. Examples include:
 
 - Workflow demos
 - Overview of packages and analysis tools

conf.py

@@ -17,9 +17,9 @@
 
 # -- Project information -----------------------------------------------------
 
-project = 'ESDS'
-copyright = '2024'
-author = 'Earth System Data Science (ESDS) community'
+project = 'ESDS Website'
+copyright = '2021, ESDS Community'
+author = 'ESDS Community'
 
 
 # -- General configuration ---------------------------------------------------
@@ -57,15 +57,28 @@
 #
 
 html_logo = "_static/esds_logo.png"
+html_favicon = "_static/esds_logo.png"
+html_sourcelink_suffix = ""
+html_last_updated_fmt = ""
+
+html_context = {
+    "github_user": "NCAR",
+    "github_repo": "esds",
+    "github_version": "main",
+    "doc_path": "",
+}
+
+html_static_path = ["_static"]
+html_css_files = ["custom.css"]
+html_show_sourcelink = False
 
 html_theme = 'pydata_sphinx_theme'
 
 # Add some more theme Options
 html_theme_options = {
-    'github_url': 'https://github.com/ncar/esds',
-    'google_analytics_id': 'UA-196809533-1',
-    'navbar_end': ['search-button', 'theme-switcher', 'navbar-icon-links'],
-    'navbar_persistent': [],
+    'use_edit_page_button': True,
+    'github_url': 'https://github.com/NCAR/esds',
+    'navbar_end': ['theme-switcher', 'navbar-icon-links'],
     'icon_links': [
         {
             "name": "YouTube",
@@ -76,6 +89,10 @@
     ],
 }
 
+html_theme_options["analytics"] = {
+    "google_analytics_id": "UA-196809533-1",
+}
+
 rediraffe_redirects = 'redirects.txt'
 
 
@@ -88,13 +105,10 @@
     'index': ['hello.html'],
     'about': ['hello.html'],
     'communication': ['hello.html'],
-    'blog': ['sidebar-nav-bs.html', 'tagcloud.html', 'archives.html'],
-    'posts/**': [
-        'sidebar-nav-bs.html',
-        'postcard.html',
-        'recentposts.html',
-        'archives.html',
-    ],
+    'office-hours': ['hello.html'],
+    'resources': ['hello.html'],
+    'blog': ['ablog/recentposts.html', 'ablog/archives.html', 'ablog/tagcloud.html'],
+    'posts/**': ['ablog/postcard.html', 'ablog/recentposts.html', 'ablog/archives.html'],
 }
 
 
@@ -114,10 +128,6 @@
 myst_enable_extensions = ['amsmath', 'colon_fence', 'deflist', 'html_image', 'dollarmath']
 myst_url_schemes = ['http', 'https', 'mailto']
 
-
 # Temporarily stored as off until we fix it
-jupyter_execute_notebooks = 'off'
-
+nb_execution_mode = 'off'
 
-# def setup(app):
-#     app.add_css_file('custom.css')

environment.yml

@@ -17,20 +17,17 @@ dependencies:
   - matplotlib
   - myst-nb>=0.12.0
   - netcdf4
-  - pip
   - pydata-sphinx-theme>=0.4.3
   - python-graphviz
-  - python=3.9
   - scipy
   - seaborn
   - sparse
   - sphinx
   - sphinx-autobuild
   - sphinx-comments
-  - sphinxcontrib-bibtex<2.0.0
+  - sphinxcontrib-bibtex
   - xarray>=0.18.2
   - sphinxext-rediraffe
   - sphinx-design
   - sphinx-copybutton
-  - pip:
-      - sphinxext-opengraph
+  - sphinxext-opengraph

index.md

@@ -1,4 +1,4 @@
-# Earth System Data Science (ESDS) Initiative
+# Earth System Data Science
 
 Hello! This is a place to store updates from the ESDS working group
 including a variety of blog posts and resources for the community

office-hours.md

@@ -10,7 +10,7 @@ If your question is about an error message you are raising in your workflow, hel
 
 ```{admonition} ESDS Collaboratory on Wednesday, June 25!
 :class: admonition
-ESDS is organizing in-person "Collaboratory" days to encourage outreach, engagement, and the sharing of ideas between teams. These sessions will rotate through the ML, CG, and FL libraries (each lab housing one event per quarter). For more information, check out [this blog post](posts/2025/collaboratory.html).
+ESDS is organizing in-person "Collaboratory" days to encourage outreach, engagement, and the sharing of ideas between teams. These sessions will rotate through the ML, CG, and FL libraries (each lab housing one event per quarter). For more information, check out [this blog post](../posts/2025/collaborary).
 ```
 
 <iframe

posts/2021/kay-et-al-cesm2-le.ipynb

@@ -14,7 +14,7 @@
    "metadata": {},
    "source": [
     "## Introduction\n",
-    "This Jupyter Notebook demonstrates how one might use the NCAR Community Earth System Model v2 (CESM2) Large Ensemble (CESM2-LE) data hosted on AWS S3. The notebook shows how to reproduce figure 2 from the Kay et al. (2015) paper describing the CESM LENS dataset ([doi:10.1175/BAMS-D-13-00255.1](doi:10.1175/BAMS-D-13-00255.1)), with the LENS2 dataset.\n",
+    "This Jupyter Notebook demonstrates how one might use the NCAR Community Earth System Model v2 (CESM2) Large Ensemble (CESM2-LE) data hosted on AWS S3. The notebook shows how to reproduce figure 2 from the Kay et al. (2015) paper describing the CESM LENS dataset ([doi:10.1175/BAMS-D-13-00255.1](https://doi.org:10.1175/BAMS-D-13-00255.1)), with the LENS2 dataset.\n",
     "\n",
     "There was a previous notebook which explored this use case, put together by Joe Hamman and Anderson Banihirwe, accessible on the Pangeo Gallery using [this link](http://gallery.pangeo.io/repos/NCAR/cesm-lens-aws/notebooks/kay-et-al-2015.v3.html). The specific figure we are replicating is shown below.\n",
     "\n",