From a4cfecb30925e7bbb6a962547181b7d850a2128e Mon Sep 17 00:00:00 2001 From: ronny hdezmora Date: Tue, 14 Apr 2026 15:55:42 -0600 Subject: [PATCH] Ref #427 Changes in TOC with first suggestion --- _quarto.yml | 336 +++++++++++++++++++++++++++++++++------------------- 1 file changed, 212 insertions(+), 124 deletions(-) diff --git a/_quarto.yml b/_quarto.yml index c5c34660..04e95c72 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -34,82 +34,29 @@ website: search: true collapse-level: 1 contents: - - text: "Welcome" - href: index.qmd - - text: "When To Cloud" - href: when-to-cloud.qmd - - section: "Our Cookbooks" - href: our-cookbooks.qmd + # ============================================================ + # SECTION 1: GETTING STARTED + # ============================================================ + - section: "Getting Started" contents: - - text: "Ocean, climate, and surface water data tutorials from PO.DAAC" - href: https://podaac.github.io/tutorials/ - - text: "Mission-specific tutorials for ASDC" - href: https://nasa.github.io/ASDC_Data_and_User_Services/ - - text: "Tutorials from the National Snow and Ice Data Center (NSIDC)" - href: https://nsidc.github.io/NSIDC-Data-Cookbook/ - - text: "Ocean Data Cookbook from OBDAAC" - href: https://nasa.github.io/oceandata-notebooks/ - - text: "Airborne Data Tutorials from ORNL DAAC" - href: https://ornldaac.github.io/airborne/ - - text: "GEDI Data Tutorials from ORNL DAAC" - href: https://ornldaac.github.io/gedi_tutorials/ - - text: "Glossary & Cheatsheets" - href: glossary.qmd - - text: "Cloud Environment Setup" - href: environment-setup/index.qmd - - section: "How do I..." - contents: - - section: "find data" - contents: - - text: "with Earthdata Search" - href: how-tos/find-data/earthdata_search.md - - text: "with Python" - href: how-tos/find-data/find-python.ipynb - - text: "with R" - href: how-tos/find-data/find-r.qmd - - text: "with R and STAC" - href: how-tos/find-data/CMR-STAC-Search.qmd - - section: "access data in cloud" - contents: - - text: "with Python" - href: how-tos/access-data/access-cloud-python.ipynb - # - text: "with R" - # href: how-tos/access-data/access-cloud-r.qmd - - section: "access data locally" - contents: - - text: "with Python" - href: how-tos/access-data/access-local-python.ipynb - - text: "with OPeNDAP" - href: how-tos/access-data/access-local-opendap.qmd - - text: "with command line" - href: how-tos/access-data/access-command-line.md - - text: "read data" - href: how-tos/read_data.qmd - - text: "subset data" - href: how-tos/subset.qmd - - text: "Store data in the cloud" - href: how-tos/using-s3-storage.ipynb - #- text: "reformat data files" - # href: how-tos/reformat.qmd - #- text: "reproject and regrid" - # href: how-tos/reproject_regrid.qmd - #- text: "aggregate data" - # href: how-tos/aggregate.qmd - #- text: "plot data" - # href: how-tos/plot.qmd - - section: "use APIs" - href: how-tos/use_apis.qmd - contents: - - text: "AppEEARS Cloud CSV Access " - href: external/appeears_csv_cloud_access.ipynb - - text: "parking lot" - href: how-tos/how_to_guide_parking_lot.qmd - - section: "Tutorials" + - text: "Welcome" + href: index.qmd + - text: "When To Cloud" + href: when-to-cloud.qmd + - text: "Cloud Environment Setup" + href: environment-setup/index.qmd + - text: "Glossary & Cheatsheets" + href: glossary.qmd + + # ============================================================ + # SECTION 2: TUTORIALS (Learn by Doing) + # ============================================================ + - section: "Tutorials (Learn by Doing)" href: tutorials/index.qmd contents: - text: "Earthdata Cloud Clinic" href: tutorials/Earthdata-cloud-clinic.ipynb - - text: "Multi-datasets" + - text: "Multi-datasets (Hurricanes)" href: tutorials/Hurricanes_Wind_and_Sea_Surface_Temperature.ipynb - text: "Sea Level Rise" href: tutorials/Sea_Level_Rise.ipynb @@ -119,74 +66,215 @@ website: href: tutorials/Observing_Seasonal_Ag_Changes.ipynb - text: "Subsetting Data with Harmony" href: tutorials/Harmony.ipynb - - text: "OPeNDAP Access" + - text: "OPeNDAP Access" href: tutorials/Earthdata_Cloud__Data_Access_OPeNDAP_Example.ipynb - text: "Pygeoweaver Workflow Demo" href: tutorials/fair-workflow-geoweaver-demo.ipynb - text: "MATLAB Access NetCDF" href: tutorials/matlab.qmd - - section: "Workshops & Hackathons" - href: workshops/index.qmd + - text: "ICESat-2 Visualization" + href: tutorials/make_atl03_figure.ipynb + - text: "Data Stories Template" + href: tutorials/Data_stories_template.ipynb + + # ============================================================ + # SECTION 3: HOW-TO GUIDES (Solve Specific Problems) + # ============================================================ + - section: "How-To Guides (Solve Specific Problems)" contents: - - text: "Workshop Setup" - href: workshops/setup.md - - section: "Access & Administration" - href: access-admin/index.qmd - contents: - - text: "2i2c Hub access" - href: access-admin/add-folks-to-2i2c-github-teams.qmd - - text: "Data storage" - href: access-admin/data-storage.qmd - - text: "Leading workshops" - href: access-admin/leading-workshops.qmd - - section: "In Development" - href: in-development/index.qmd + - section: "Find Data" + contents: + - text: "with Earthdata Search" + href: how-tos/find-data/earthdata_search.md + - text: "with Python" + href: how-tos/find-data/find-python.ipynb + - text: "with R" + href: how-tos/find-data/find-r.qmd + - text: "with R and STAC" + href: how-tos/find-data/CMR-STAC-Search.qmd + - text: "Programmatic Discovery" + href: how-tos/find-data/programmatic.qmd + - section: "Access Data in Cloud" + contents: + - text: "with Python" + href: how-tos/access-data/access-cloud-python.ipynb + - section: "Access Data Locally" + contents: + - text: "with Python" + href: how-tos/access-data/access-local-python.ipynb + - text: "with OPeNDAP" + href: how-tos/access-data/access-local-opendap.qmd + - text: "with Command Line" + href: how-tos/access-data/access-command-line.md + - section: "Work with Data" + contents: + - text: "Read Data" + href: how-tos/read_data.qmd + - text: "Subset Data" + href: how-tos/subset.qmd + - text: "Store Data in S3" + href: how-tos/using-s3-storage.ipynb + # - text: "Reformat Data Files" + # href: how-tos/reformat.qmd + # - text: "Reproject and Regrid" + # href: how-tos/reproject_regrid.qmd + # - text: "Aggregate Data" + # href: how-tos/aggregate.qmd + # - text: "Plot Data" + # href: how-tos/plot.qmd + - section: "Use APIs" + href: how-tos/use_apis.qmd + contents: + - text: "AppEEARS Cloud CSV Access" + href: external/appeears_csv_cloud_access.ipynb + - text: "Open Science Tutorial" + href: how-tos/Earthdata_Cloud__Open-Science-Tutorial.ipynb + - text: "Parking Lot" + href: how-tos/how_to_guide_parking_lot.qmd + + # ============================================================ + # SECTION 4: EXAMPLES BY DATA PROVIDER + # ============================================================ + - section: "Examples by Data Provider" + href: examples/index.qmd contents: - - text: "Search & Download NSIDC Cloud" - href: examples/NSIDC/ICESat2-CMR-OnPrem-vs-Cloud.ipynb - - text: "Access NSIDC Cloud w/ CMR" - href: examples/NSIDC/ICESat2-CMR-AWS-S3.ipynb - - text: "Direct Access & Harmony Workflow" - href: examples/Transform-workflow.ipynb - - text: "Search & Access USGS Landsat Cloud" - href: examples/USGS_Landsat/Landsat_C2_Search_Access.ipynb - - text: "Direct S3 Data Access: NetCDF - Daymet v4 Daily TMAX Example" - href: examples/ORNL/Data_Access__Direct_S3_Access__ORNL_DAYMET.ipynb - - text: "Access ECCO data via Harmony & the Zarr reformatter service" - href: external/cof-zarr-reformat.ipynb - - text: "zarr-eosdis-store example" - href: external/zarr-eosdis-store.ipynb - - section: "Example Workflows" - href: examples/index.qmd - contents: - - text: "GES DISC - MERRA2" + - section: "GES DISC" + contents: + - text: "MERRA2 with Kerchunk" href: examples/GESDISC/GESDISC_MERRA2_tavg1_2d_flx_Nx__Kerchunk.ipynb - - text: "LP DAAC ECOSTRESS" + - section: "LP DAAC" + contents: + - text: "HLS Point Buffer Search & Access" + href: examples/LPDAAC/Find_and_Access_HLS_PointBuffer.ipynb + - text: "ECOSTRESS with Kerchunk" href: examples/LPDAAC/LPDAAC_ECOSTRESS_LSTE__Kerchunk.ipynb - - text: "PO.DAAC ECCO SSH" + - section: "NSIDC" + contents: + - text: "ICESat-2 OnPrem vs Cloud" + href: examples/NSIDC/ICESat2-CMR-OnPrem-vs-Cloud.ipynb + - text: "ICESat-2 CMR & AWS S3" + href: examples/NSIDC/ICESat2-CMR-AWS-S3.ipynb + - section: "ORNL DAAC" + contents: + - text: "DAYMET Direct S3 Access" + href: examples/ORNL/Data_Access__Direct_S3_Access__ORNL_DAYMET.ipynb + - text: "DAYMET with Kerchunk" + href: examples/ORNL/ORNL_DAYMET__Kerchunk.ipynb + - section: "PO.DAAC" + contents: + - text: "ECCO SSH with Kerchunk" href: examples/PODAAC/PODAAC_ECCO_SSH__Kerchunk.ipynb - - text: "`earthdata`: Python-R Handoff" - href: in-development/earthdata-python-r-handoff.qmd - - section: "Contributing" - href: contributing/index.qmd + - section: "USGS" + contents: + - text: "Landsat C2 Search & Access" + href: examples/USGS_Landsat/Landsat_C2_Search_Access.ipynb + - text: "Direct Access & Harmony Workflow" + href: examples/Transform-workflow.ipynb + + # ============================================================ + # SECTION 5: EXTERNAL TUTORIALS + # ============================================================ + - section: "External Tutorials" contents: - - text: "Calendaring and Project Management" - href: contributing/calendar-project-management.qmd - - text: "Onboarding Mentors" - href: contributing/onboarding.qmd - - text: "Setup" - href: contributing/setup.qmd - - text: "Workflows" - href: contributing/workflow.qmd - - text: "Quarto Tutorial" - href: contributing/quarto-website-tutorial.md - - text: "Troubleshooting" - href: contributing/troubleshooting.md - - section: "Appendix" + - text: "NASA Earthdata Authentication" + href: external/nasa_earthdata_authentication.ipynb + - text: "CMR Data Discovery" + href: external/data_discovery_cmr.ipynb + - text: "CMR-STAC API Discovery" + href: external/data_discovery_cmr-stac_api.ipynb + - text: "Harmony Subsetting" + href: external/harmony_subsetting.ipynb + - text: "Direct S3 Access Patterns" + href: external/data_access_direct_S3.ipynb + - text: "On-Prem vs Cloud Workflows" + href: external/on-prem_cloud.ipynb + - text: "Zarr-EOSDIS-Store" + href: external/zarr-eosdis-store.ipynb + - text: "COF Zarr Reformat" + href: external/cof-zarr-reformat.ipynb + - text: "Xarray Fundamentals" + href: external/xarray.ipynb + - text: "Sentinel-6 OPeNDAP & Gridding" + href: external/sentinel-6_opendap_access_gridding.ipynb + + # ============================================================ + # SECTION 6: REFERENCE + # ============================================================ + - section: "Reference" href: appendix/index.md contents: - text: "Authentication" href: appendix/authentication.qmd + - section: "Alternate Access Methods" + contents: + - text: "Access COG" + href: appendix/appendix-alternate-in-cloud-access/Access_COG.qmd + - text: "Single File HTTPS COG" + href: appendix/appendix-alternate-in-cloud-access/Earthdata_Cloud__Single_File__HTTPS_Access_COG_Example.qmd + - text: "Single File Direct S3 NetCDF" + href: appendix/appendix-alternate-in-cloud-access/Earthdata_Cloud__Single_File__Direct_S3_Access_NetCDF4_Example.ipynb + - text: "Multi-File Direct S3 NetCDF" + href: appendix/appendix-alternate-in-cloud-access/Multi-File_Direct_S3_Access_NetCDF_Example.ipynb + + # ============================================================ + # SECTION 7: COMMUNITY & RESOURCES + # ============================================================ + - section: "Community & Resources" + contents: + - section: "Our Cookbooks" + href: our-cookbooks.qmd + contents: + - text: "PO.DAAC Tutorials" + href: https://podaac.github.io/tutorials/ + - text: "ASDC Mission Tutorials" + href: https://nasa.github.io/ASDC_Data_and_User_Services/ + - text: "NSIDC Data Cookbook" + href: https://nsidc.github.io/NSIDC-Data-Cookbook/ + - text: "OBDAAC Ocean Data Cookbook" + href: https://nasa.github.io/oceandata-notebooks/ + - text: "ORNL DAAC Airborne Tutorials" + href: https://ornldaac.github.io/airborne/ + - text: "ORNL DAAC GEDI Tutorials" + href: https://ornldaac.github.io/gedi_tutorials/ + - section: "Workshops & Hackathons" + href: workshops/index.qmd + contents: + - text: "Workshop Setup" + href: workshops/setup.md + - section: "Contributing" + href: contributing/index.qmd + contents: + - text: "Calendaring and Project Management" + href: contributing/calendar-project-management.qmd + - text: "Onboarding Mentors" + href: contributing/onboarding.qmd + - text: "Setup" + href: contributing/setup.qmd + - text: "Workflows" + href: contributing/workflow.qmd + - text: "Quarto Tutorial" + href: contributing/quarto-website-tutorial.md + - text: "Troubleshooting" + href: contributing/troubleshooting.md + - text: "Community Guidelines" + href: contributing/community.md + - text: "Environment" + href: contributing/environment.qmd + - text: "Privacy Policy" + href: privacy.qmd + + # ============================================================ + # SECTION 8: ADMINISTRATION (for maintainers/instructors) + # ============================================================ + - section: "Administration" + href: access-admin/index.qmd + contents: + - text: "2i2c Hub Access" + href: access-admin/add-folks-to-2i2c-github-teams.qmd + - text: "Data Storage" + href: access-admin/data-storage.qmd + - text: "Leading Workshops" + href: access-admin/leading-workshops.qmd format: