# The Executable Books Project

This is the team documentation for the
[ExecutableBooksProject](https://github.com/executablebooks), an international
collaboration to build open source tools that facilitate publishing
computational narratives using the Jupyter ecosystem.
Below are two marquee projects that we steward.

<style>
  .marquee-projects .sd-card-header img {
      max-width: 1.5rem;
  }

  .marquee-projects .sd-card-body img {
    margin: auto;
  }

  .marquee-projects .jb-logo img {
      width: 100%;
  }

  .marquee-projects .myst-logo img {
      width: 75%;
  }

  .myst-logo-sq img {
    width: 1rem;
  }
</style>

::::{grid} 1 2 2 2
:gutter: 2
:class-container: marquee-projects

:::{grid-item-card}
:link: tools:jupyter-book
:link-type: ref
:class-body: jb-logo sd-d-flex-row sd-align-minor-center sd-text-center sd-mx-auto

Jupyter Book ![](https://jupyterbook.org/en/stable/_images/logo-square.svg)
^^^
![](https://jupyterbook.org/en/stable/_static/logo-wide.svg)

+++
A command-line interface for building beautiful, publication-quality books and documents from computational content.
:::

:::{grid-item-card}
:link: tools:myst
:link-type: ref
:class-body: myst-logo sd-d-flex-row sd-align-minor-center sd-text-center sd-mx-auto

MyST Markdown ![](https://myst-parser.readthedocs.io/en/latest/_images/logo-square.svg)
^^^
![](https://myst-parser.readthedocs.io/en/latest/_static/logo-wide.svg)

+++
An extensible, semantic, and community-driven flavor of markdown designed for scientific and computational narratives.

:::
::::

## Community links

::::{grid} 1 2 3 3
:class-container: landing-grid
:gutter: 2

:::{grid-item-card}
:link: contribute
:link-type: doc

Contributing Guide 🙌
^^^
Our contributing guide has some tips and pointers to help you learn where and how to contribute to the project.
:::

:::{grid-item-card}
:link: https://github.com/executablebooks/meta/discussions

Community forum 💬
^^^
A place for free-form discussion, brainstorming, and asking questions about how to use the tools in this ecosystem.

:::

:::{grid-item-card}
:link: feature-vote
:link-type: doc

Feature voting 👍
^^^

A voting board to aggregate ideas across our repositories and sort them by thumbs-up responses.

:::


:::{grid-item-card}
:link: tools
:link-type: doc

Tools we build 🔧
^^^

An overview of the tools and standards that this community stewards for communicating with computational narratives.

:::

:::{grid-item-card}
:link: https://compass.executablebooks.org

Our team compass 🧭
^^^

Our team policies, structure, practices, and contributing guides.
:::

:::{grid-item-card}
:link: https://mystmd.org
:class-header: myst-logo-sq

MyST Markdown overview ![](https://myst-parser.readthedocs.io/en/latest/_images/logo-square.svg)
^^^
An overview of MyST Markdown and the MyST ecosystem of tools.

:::

::::

```{toctree}
:hidden:
:caption: Our tools and standards
tools.md
feature-vote.md
gallery.md
```

```{toctree}
:caption: About our team
:hidden:
contribute
Team compass 🧭 <https://compass.executablebooks.org>
blog
```

## Blog posts

_Below is a list of recent blog posts from [our blog](blog.md)_

```{postlist}
```

## Acknowledgements

See our [organizational contributions page](inv:tc#contributions) as well as [our team members page](inv:tc#team) for a list of individuals and organizations that have made formal contributions to this community.