Merge pull request #30 from jukent/doi

doi infrastructure changes

CITATION.cff

@@ -0,0 +1,12 @@
+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: Morley
+    given-names: James
+    orcid: https://orcid.org/0009-0005-5193-7981 # optional
+    website: https://github.com/jnmorley
+  - name: "Intake Cookbook contributors" # use the 'name' field to acknowledge organizations
+    website: "https://github.com/ProjectPythia/intake-cookbook/graphs/contributors"
+title: "Intake Cookbook"
+abstract: "This cookbook shows examples of using and creating Intake catalogs to access data."

README.md

@@ -4,6 +4,7 @@
 
 [![nightly-build](https://github.com/ProjectPythia/intake-cookbook/actions/workflows/nightly-build.yaml/badge.svg)](https://github.com/ProjectPythia/intake-cookbook/actions/workflows/nightly-build.yaml)
 [![Binder](https://binder.projectpythia.org/badge_logo.svg)](https://binder.projectpythia.org/v2/gh/ProjectPythia/intake-cookbook/main?labpath=notebooks)
+[![DOI](https://zenodo.org/badge/512825541.svg)](https://zenodo.org/badge/latestdoi/512825541)
 
 This Project Pythia Cookbook covers using and creating Intake catalogs to access data.
 

_config.yml

@@ -4,19 +4,8 @@
 title: Intake Cookbook
 author: James Morley
 logo: notebooks/images/logos/pythia_logo-white-rtext.svg
-email: [email protected]
 copyright: '2022'
 
-description: This cookbook shows examples of using and creating Intake catalogs to access data.
-thumbnail: thumbnail.svg
-tags:
-  domains:
-   - Data access
-  packages:
-   - intake
-   - intake-xarray
-   - intake-markdown
-
 # Execute the notebooks upon build
 execute:
   execute_notebooks: cache

_gallery_info.yml

@@ -0,0 +1,8 @@
+thumbnail: thumbnail.png
+tags:
+  domains:
+   - Data access
+  packages:
+   - intake
+   - intake-xarray
+   - intake-markdown

_toc.yml

@@ -1,6 +1,9 @@
 format: jb-book
 root: README
 parts:
+  - caption: Preamble
+    chapters:
+      - file: notebooks/how-to-cite
   - caption: Intoduction to Intake
     chapters:
       - file: notebooks/intake_introduction

notebooks/how-to-cite.md

@@ -0,0 +1,7 @@
+# How to Cite This Cookbook
+
+The material in Project Pythia's Intake 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/intake-cookbook) and archived on Zenodo. This DOI will always resolve to the latest release of the book source:
+
+[![DOI](https://zenodo.org/badge/512825541.svg)](https://zenodo.org/badge/latestdoi/512825541)