_config.yml

# Book settings
# Learn more at https://jupyterbook.org/customize/config.html

title: Packaging Cookbook
author: the <a href="https://projectpythia.org/">Project Pythia</a> Community
logo: notebooks/images/logos/pythia_logo-white-rtext.svg
email: projectpythia@ucar.edu
copyright: '2024'

description: This Project Pythia Cookbook covers Python packaging.
thumbnail: thumbnail.png
tags:
  domains:
    - packaging
  packages:
    - 

# Execute the notebooks upon build
execute:
  execute_notebooks: cache
  timeout: 600
  allow_errors: False  # cells with expected failures must set the `raises-exception` cell tag

# Add a few extensions to help with parsing content
parse:
  myst_enable_extensions: # default extensions to enable in the myst parser. See https://myst-parser.readthedocs.io/en/latest/using/syntax-optional.html
    - amsmath
    - colon_fence
    - deflist
    - dollarmath
    - html_admonition
    - html_image
    - replacements
    - smartquotes
    - substitution

sphinx:
  config:
    html_favicon: images/icons/favicon.ico
    html_last_updated_fmt: '%-d %B %Y'
    html_theme: sphinx_pythia_theme
    html_permalinks_icon: '<i class="fas fa-link"></i>'
    html_theme_options:
      home_page_in_toc: true
      repository_url: https://github.com/ProjectPythia/packaging-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
      use_edit_page_button: true
      use_fullscreen_button: true
      analytics:
        google_analytics_id: G-T52X8HNYE8
      github_url: https://github.com/ProjectPythia
      twitter_url: https://twitter.com/project_pythia
      icon_links:
        - name: YouTube
          url: https://www.youtube.com/channel/UCoZPBqJal5uKpO8ZiwzavCw
          icon: fab fa-youtube-square
          type: fontawesome
      launch_buttons:
        binderhub_url: http://binder.mypythia.org
        notebook_interface: jupyterlab
      logo:
        link: https://projectpythia.org
      navbar_start:
        - navbar-logo
      navbar_end:
        - navbar-icon-links
      navbar_links:
        - name: Home
          url: https://projectpythia.org
        - name: Foundations
          url: https://foundations.projectpythia.org
        - name: Cookbooks
          url: https://cookbooks.projectpythia.org
        - name: Resources
          url: https://projectpythia.org/resource-gallery.html
        - name: Community
          url: https://projectpythia.org/index.html#join-us
      footer_logos:
        NCAR: notebooks/images/logos/NSF-NCAR_Lockup-UCAR-Dark_102523.svg
        Unidata: notebooks/images/logos/Unidata_logo_horizontal_1200x300.svg
        UAlbany: notebooks/images/logos/UAlbany-A2-logo-purple-gold.svg
      footer_start:
        - footer-logos
        - footer-info
        - footer-extra