Skip to content

Commit

Permalink
Merge pull request #143 from ProjectPythia/main
Browse files Browse the repository at this point in the history
[pull] main from ProjectPythia:main
  • Loading branch information
jukent committed Sep 17, 2024
2 parents ba0b8fc + 41524ae commit dffd172
Show file tree
Hide file tree
Showing 16 changed files with 513 additions and 1,215 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/update-resource-gallery.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ jobs:
run: |
python .github/workflows/collect-user-submission.py
- uses: actions/upload-artifact@v2
- uses: actions/upload-artifact@v4
with:
name: submission
path: resource-gallery-submission-input.json
Expand All @@ -72,7 +72,7 @@ jobs:
- uses: actions/setup-python@v2
with:
python-version: 3.8
- uses: actions/download-artifact@v2
- uses: actions/download-artifact@v4
with:
name: submission

Expand Down
2 changes: 2 additions & 0 deletions environment.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,5 @@ dependencies:
- pre-commit
- pyyaml
- sphinx-pythia-theme
- sphinx-design
- sphinx-copybutton
Binary file added portal/_static/images/1-actions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added portal/_static/images/2-actions-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added portal/_static/images/3-run-workflow.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added portal/_static/images/4-releases.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added portal/_static/images/5-release-new-tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
891 changes: 0 additions & 891 deletions portal/_static/images/logos/Unidata_logo_horizontal_1200x300.svg

This file was deleted.

Binary file removed portal/_static/images/unidata_150x150.png
Binary file not shown.
7 changes: 4 additions & 3 deletions portal/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,10 @@
# ones.
extensions = [
'resource_gallery_generator',
'ablog',
'myst_nb',
'sphinx_copybutton',
'sphinx_design',
'ablog',
'sphinx.ext.intersphinx',
]

Expand Down Expand Up @@ -119,8 +120,8 @@
'resource-gallery': 'page-standalone.html',
},
'footer_logos': {
'NCAR': '_static/images/logos/NSF-NCAR_Lockup-UCAR-Dark_102523.png',
'Unidata': '_static/images/logos/Unidata_logo_horizontal_1200x300.svg',
'NSF NCAR': '_static/images/logos/NSF-NCAR_Lockup-UCAR-Dark_102523.png',
'NSF Unidata': '_static/images/logos/NSF-Unidata_lockup_horizontal_2023.png',
'UAlbany': '_static/images/logos/UAlbany-A2-logo-purple-gold.svg',
},
'footer_start': ['footer-logos', 'footer-menu', 'footer-info', 'footer-extra'],
Expand Down
8 changes: 8 additions & 0 deletions portal/cookbook-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -258,6 +258,14 @@ As always, reach out to a Pythia team member for help with any of these steps!

### Initiate the Cookbook review process

If you haven't already, now is a great time to [contact the Project Pythia team](https://discourse.pangeo.io/c/education/project-pythia/60) to let them know about your new Cookbook. You will be assigned a Cookbook advocate from the Pythia maintenance team.
They will open an issue on your Cookbook repository with the [Cookbook Checklist](cookbook-tasklist.md) for you to document your completion of the above process, plus a few more GitHub-specific steps.
Once you complete this process, your Cookbook will be ready for review and publication!

### Submit your Cookbook to the Gallery

Click the button below to request addition of your Cookbook to the [Project Pythia Cookbook Gallery](https://cookbooks.projectpythia.org).

<span class="d-flex justify-content-center py-4">
<a href="https://github.com/ProjectPythia/cookbook-gallery/issues/new?assignees=ProjectPythia%2Feducation&labels=content%2Ccookbook-gallery-submission&template=update-cookbook-gallery.yaml&title=Update+Gallery+with+new+Cookbook" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none;">
Submit a new Cookbook
Expand Down
53 changes: 53 additions & 0 deletions portal/cookbook-tasklist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Cookbook Author Checklist Template

Project Pythia maintainers will provide this checklist to Cookbook authors to help get Cookbooks ready for publication.

```md
**I am your Cookbook advocate, and my GitHub handle is <my-username>. Please tag me in this issue with any problems getting your Cookbook published!**
Once we've marked this entire checklist, [click here to open an issue on ProjectPythia/cookbook-gallery to publish your Cookbook!](https://github.com/ProjectPythia/cookbook-gallery/issues/new?assignees=ProjectPythia%2Feducation&labels=content%2Ccookbook-gallery-submission&projects=&template=update-cookbook-gallery.yaml&title=Update+Gallery+with+new+Cookbook)

---

- [ ] **Confirm you’ve followed the entire Project Pythia [Cookbook Guide](https://projectpythia.org/cookbook-guide.html)**.
Take note especially of the [Develop your cookbook](https://projectpythia.org/cookbook-guide.html#develop-your-cookbook), [Authorship and the CITATION.cff file](https://projectpythia.org/cookbook-guide.html#authorship-and-the-citation-cff-file), and [Gallery tags](https://projectpythia.org/cookbook-guide.html#gallery-tags) sections. **Save the [Generate a DOI](https://projectpythia.org/cookbook-guide.html#generate-a-doi) step as the last step of this checklist.**
- [ ] **Confirm that the individual notebooks within your Cookbook adhere to the [notebook template](https://github.com/ProjectPythia/cookbook-template/blob/main/notebooks/notebook-template.ipynb)**.
If the template does not fit your Cookbook’s needs, that’s fine too! Simply let us know here in this issue.
- [ ] **Finalize your Cookbook repository name.**
We generally encourage the `<content>-cookbook` name structure.
- [ ] **Finalize your environment.yml.**
Specify the minimum number of packages needed to reproduce your content. Document any necessary conflicts and pinned package versions in an issue. In your Cookbook README or a content preamble, describe any unique dependencies handled outside the conda environment.
- [ ] **Sufficiently document your code** with markdown narrative text, supplementary media and references, and citations.
Declare any necessary prerequisite learning for each notebook at the top; these can be materials within your Cookbook, within other Cookbooks, or outside Project Pythia altogether.
- [ ] **Review whether your Cookbook needs an Appendix** of terms, definitions, or concepts.
Additionally, should your Cookbook reference other Cookbooks and learning materials to support your content? Could supporting content be added as updates to Foundations or other Cookbooks benefit your Cookbook?
- [ ] **Execute the `trigger-replace-links` action provided to your Cookbook.**
This will update any links to the Cookbook template to refer to your finalized repository name. See ProjectPythia/cookbook-template#183 for manual references to these links if needed.
- Click the Actions tab for your repository.
![GitHub Actions tab link](https://raw.githubusercontent.com/ProjectPythia/projectpythia.github.io/main/portal/_static/images/1-actions.png "Actions Tab")
- Highlight the `trigger-replace-links` action in the workflows sidebar.
![Sidebar list of workflows in GitHub Actions](https://raw.githubusercontent.com/ProjectPythia/projectpythia.github.io/main/portal/_static/images/2-actions-list.png "List of Workflows")
- On the right-hand side of the page, Run workflow > on Branch: Main.
![Prompt for manually running the workflow](https://raw.githubusercontent.com/ProjectPythia/projectpythia.github.io/main/portal/_static/images/3-run-workflow.png "Run Workflow prompt")
- [ ] **Fill in all template sections of your README**.
This will serve as your Cookbook homepage
- [ ] Title
- [ ] Cookbook description (brief, under title)
- [ ] Cookbook Motivation - use this as an opportunity to tell us how your Cookbook fits in the broader learning ecosystem. Who should use this book? Why is it needed? Where does its content begin and end relative to existing resources?
- [ ] Structure - this section is an optional roadmap for Cookbooks with more complicated structure. If you only have one main body of content that progresses linearly, you can leave this out.
- [ ] **Confirm that your Cookbook is successfully building and publishing via GitHub Actions.**
This can be seen in individual Pull Requests as green checkmarks ✅ for important automation, especially the trigger-book-build action. You can also view a historical list of any of these Actions in the Actions tab at the top of your Cookbook repository. Check out nightly-build and trigger-book-build of PRs, then the build/build jobs to identify code errors. Please comment in this thread if you have issues identifying the source of any build and publishing failures your Cookbook has. Common failures include
- Incorrectly specified environment.yml
- trigger-link-check will fail if links in your content can not be resolved. We can help ignore links that are broken even if they work on manual clicks.
- Code errors in your notebooks themselves
- [ ] **Identify a Maintainer team via GitHub handle(s) in this thread.**
This can be one or more people with availability to check in on this Cookbook, issue fixes to broken content, or with a vision for the future development of the Cookbook. This is typically (but not necessarily) one of the primary authors of the Cookbook.
- [ ] **Link your Cookbook repo to Zenodo for DOI generation**
Follow steps 1-4 under [Generate a DOI](https://projectpythia.org/cookbook-guide.html#generate-a-doi) in the Cookbook Guide. Return here for instructions on step 5, and your final step:
- [ ] **Release your Cookbook!**
- On the right-hand sidebar for your Cookbook repository, click “Create a new release”. If you don’t see this button, you may need to click on the “Releases” header first and “Create” or “Draft” a new release.
![GitHub Repository sidebar section titled "Releases"](https://raw.githubusercontent.com/ProjectPythia/projectpythia.github.io/main/portal/_static/images/4-releases.png "Releases")
- “Choose a tag”, enter a new tag name. This will be the git reference of the snapshot of code that represents this particular release of your Cookbook! We recommend using a name fitting the [CalVer](https://calver.org/) scheme, so something like v2024.06.13 for the date of the release, then choose “+ Create new tag: <your tag name> on publish” and make its Target main (unless you have the knowledge and desire to release from another branch!)
![Interface for generating a new tag on release](https://raw.githubusercontent.com/ProjectPythia/projectpythia.github.io/main/portal/_static/images/5-release-new-tag.png "Create a tag")
- From here you can use GitHub’s nifty “Generate release notes” button to automatically draft a summary of your Cookbook release based on merged Pull Requests! Feel free to further modify the title and body text of your release notes to fit your Cookbook and best represent your authors.
- Finally, `Publish release`!
```
6 changes: 3 additions & 3 deletions portal/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,8 @@

<span style="font-size: 2.6rem;">An education and training hub for the geoscientific Python community</span>

<a href="https://projectpythia.org/pythia-cookoff-2024/" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none; background-color: #ccc; border: rgba(var(--spt-color-dark), 1);">
Project Pythia is hosting a Cookbook Cook-Off June 11-14, 2024.<br>
Learn more here.
<a href="posts/fundraiser.html" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none; background-color: #ccc; border: rgba(var(--spt-color-dark), 1);">
Donate to support Project Pythia!
</a>

[Project Pythia](about) is the education working group for [Pangeo](https://pangeo.io)
Expand Down Expand Up @@ -225,6 +224,7 @@ maxdepth: 1
about.md
contributing.md
cookbook-guide.md
cookbook-tasklist.md
code_of_conduct.md
resource-gallery.md
blog.md
Expand Down
39 changes: 39 additions & 0 deletions portal/posts/fundraiser.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
blogpost: true
date: Jun 28, 2023
author: Julia kent
tags: fundraiser
---

# Donate to Support Project Pythia!

## You can make an impact on our community!
By donating to support Project Pythia you are investing in an important educational resource for the entire geoscience community, from students to late career. Project Pythia is an education working group helping geoscientists make sense of huge volumes of numerical scientific data using tools that facilitate open, reproducible science, and building an inclusive community of practice around these goals. Project Pythia is a home for Python-centered learning resources that are open-source, community-owned, geoscience-focused, and high-quality.

Donations contribute to outreach and community engagement activities, such as participant support at our annual hackathons.

## Friends of the National Center
Friends of the National Center is the fundraising arm of the University Corporation for Atmospheric Research (UCAR), which manages the National Science Foundation National Center for Atmospheric Research. UCAR is a non-profit organization, so all donations to Project Pythia are tax-deductible to the fullest extent allowed by law.

We accept donations through the following ways: <br>
**Online** – Click the Donate Button on the right (we accept credit cards, Paypal and ApplePay). <br>
**Check** – Mail your check made out to UCAR and send it to: <br>
UCAR – Friends of the National Center <br>
Attn: Sarah Swanson <br>
PO BOX 3000 <br>
Boulder, CO 80307 <br>
Please include in the memo: Donation for Project Pythia <br>
**Stock gifts, ACH Transfers, etc.** – Please reach out to Friends of the National Center at info@friendsofthenationalcenter.org

<script>
(function(f,u,n,r,a,i,s,e){var data={window:window,document:document,tag:"script",data:"funraise",orgId:f,uri:u,common:n,client:r,script:a};var scripts;var funraiseScript;data.window[data.data]=data.window[data.data]||[];if(data.window[data.data].scriptIsLoading||data.window[data.data].scriptIsLoaded)return;data.window[data.data].loading=true;data.window[data.data].push("init",data);scripts=data.document.getElementsByTagName(data.tag)[0];funraiseScript=data.document.createElement(data.tag);funraiseScript.async=true;funraiseScript.src=data.uri+data.common+data.script+"?orgId="+data.orgId;scripts.parentNode.insertBefore(funraiseScript,scripts)})('79cd49fa-a550-4baa-a6d9-1913aae826df','https://assets.funraise.io','/widget/common/2.0','/widget/client','/inject-form.js');
</script>

<script>
window.funraise.push('create', { form: 36005 }, {
selector: '#fr-placed-form-container-36005',
type: 'grow_contained',
});
</script>

<div id="fr-placed-form-container-36005" style="min-height: 816px;"></div>
Loading

0 comments on commit dffd172

Please sign in to comment.