Merge pull request #3 from jukent/doi

Doi infrastructure changes

Author: dopplershift

CITATION.cff

@@ -0,0 +1,13 @@
+cff-version: 1.2.0
+message: "If you use this cookbook, please cite it as below."
+authors:
+  # add additional entries for each author -- see https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md
+  - family-names: Camron
+    given-names: Drew
+    orcid: https://orcid.org/0000-0001-7246-6502
+    website: https://github.com/dcamron
+    affiliation: UCAR/Unidata
+  - name: "Metpy Cookbook contributors" # use the 'name' field to acknowledge organizations
+    website: "https://github.com/ProjectPythia/metpy-cookbook/graphs/contributors"
+title: "Metpy Cookbook"
+abstract: "A sample cookbook description."

README.md

@@ -7,13 +7,13 @@
    </div>
 </div>
 
-
 **:warning: THIS COOKBOOK IS UNDER CONSTRUCTION :warning:**
 
 # MetPy Cookbook
 
 [![nightly-build](https://github.com/ProjectPythia/metpy-cookbook/actions/workflows/nightly-build.yaml/badge.svg)](https://github.com/ProjectPythia/metpy-cookbook/actions/workflows/nightly-build.yaml)
 [![Binder](http://binder.projectpythia.org/badge_logo.svg)](http://binder.projectpythia.org/v2/gh/ProjectPythia/metpy-cookbook/main?labpath=notebooks)
+[![DOI](https://zenodo.org/badge/620944317.svg)](https://zenodo.org/badge/latestdoi/620944317)
 
 This Cookbook is the oversized recipe book for all your MetPy needs.
 We provide a gallery of real workflows centered around meteorological data,
@@ -34,7 +34,6 @@ MetPy Maintainers and the MetPy Community.
 
 ### The MetPy Example Gallery
 
-
 ## Running the Notebooks
 
 You can either run the notebook using [Binder](https://mybinder.org/) or on your local machine.

_config.yml

@@ -7,19 +7,6 @@ logo: pythia.png
 email: [email protected]
 copyright: "2024"
 
-description: A sample cookbook description.
-thumbnail: metpy.png
-tags:
-  domains:
-    - meteorology
-    - data access
-  packages:
-    - metpy
-    - siphon
-    - cartopy
-    - xarray
-    - pint
-
 execute:
   # To execute notebooks via a binder instead, replace 'cache' with 'binder'
   execute_notebooks: cache
@@ -50,7 +37,7 @@ sphinx:
     html_permalinks_icon: '<i class="fas fa-link"></i>'
     html_theme_options:
       home_page_in_toc: true
-      repository_url: https://github.com/ProjectPythia/cookbook-template/ # Online location of your book
+      repository_url: https://github.com/ProjectPythia/metpy-cookbook/ # Online location of your book
       repository_branch: main # Which branch of the repository should be used when creating links (optional)
       use_issues_button: true
       use_repository_button: true

_gallery_info.yml

@@ -0,0 +1,11 @@
+thumbnail: metpy.png
+tags:
+  domains:
+    - meteorology
+    - data access
+  packages:
+    - metpy
+    - siphon
+    - cartopy
+    - xarray
+    - pint

_toc.yml

@@ -1,12 +1,15 @@
 format: jb-book
 root: README
 parts:
+  - caption: Preamble
+    chapters:
+      - file: notebooks/how-to-cite
   - caption: The MetPy Gallery
     chapters:
       - file: notebooks/notebook-template
-        title: What organization 
+        title: What organization
         sections:
-        - glob: notebooks/gallery/*
+          - glob: notebooks/gallery/*
       - file: notebooks/gallery/index1
         title: do we want
       - file: notebooks/gallery/index2
@@ -20,4 +23,4 @@ parts:
       - file: notebooks/Skew-T_Analysis
       - file: notebooks/Sounding_LCL_Dataset
       - file: notebooks/Sounding_Plotter
-      - file: notebooks/Sounding_Calculations
+      - file: notebooks/Sounding_Calculations

notebooks/how-to-cite

@@ -0,0 +1,7 @@
+# How to Cite This Cookbook
+
+The material in Project Pythia's Metpy Cookbook is licensed for free and open consumption and reuse. All code is served under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0), while all non-code content is licensed under [Creative Commons BY 4.0 (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). Effectively, this means you are free to share and adapt this material so long as you give appropriate credit to the Cookbook authors and the Project Pythia community.
+
+The source code for the book is [released on GitHub](https://github.com/ProjectPythia/metpy-cookbook) and archived on Zenodo. This DOI will always resolve to the latest release of the book source:
+
+[![DOI](https://zenodo.org/badge/620944317.svg)](https://zenodo.org/badge/latestdoi/620944317)