/docs-1

Documentation for Dune

Primary LanguageCSSMIT LicenseMIT

Dune Docs

Welcome to the Dune Docs!

Dune is a crypto analytics tool by and for the community.

These docs are open source and built with Material for MkDocs.

Any contributions are welcome, from spelling mistakes to entire guides on the EVM. Just submit a PR.

Install Dune Docs Locally

If you'd like to run the docs locally, follow these instructions.

Setup your local python 3 environment, e.g. with Miniconda.

Install the python libraries:

pip install -r requirements.txt

Run the docs locally:

mkdocs serve

Notes

Remember to use relative paths to markdown files for internal links (e.g. [link](../../relative/path/to/index.md)), otherwise the mkdocs compiler will not detect broken internal links - read more.

Translations

Dune docs are kindly translated by members of our community.

Currently they are available in English and Chinese.

Each translation is run as a separate mkdocs-material project. For example, with the Chinese docs navigate to zh and run mkdocs serve. The build process automatically merges together translations into a single docs site with language switcher.

To propose a new language, open an issue or reach out to us on Discord!

Upgrades

To upgrade mkdocs-material, you need to pin a new version of mkdocs-material and update the hard-coded value for stylesheets in overrides/main.html.

  • Update requirements.txt with new version of mkdocs-material
  • Upgrade your local environment
  • Find the auto-generated stylesheet file name, see example
  • Update in overrides/main.html
  • Do the same for the mkdocs-material-insiders
  • Update the mkdocs-material version on Vercel