Skip to content

JavaScript client to integrate with Read the Docs nicely

License

Notifications You must be signed in to change notification settings

readthedocs/addons

 
 

Repository files navigation

Empower your docs with Read the Docs

This repository contains a self-contained JavaScript client that will empower your docs, elevating them to the next level 🚀. All these features are enabled by default just by hosting your documentation in Read the Docs.

Features

Analytics

It uses the Read the Docs analytics backend to track page views and searches performed in your documentation.

Traffic analytics Search analytics
Traffic analytics Search analytics
Documentation Documentation

Docdiff

Shows PR changes embeded on the documentation pages themselves.

Docdiff example

PR warning banner

Shows a banner at the top of the documentation communicating the build was performed from a Pull Request.

PR warning banner

Flyout

Authentic Read the Docs' flyout that shows all the available versions, links to download the offline formats, view and edit on GitHub and more.

Flyout

Non-stable version warning banner

Shows a banner at the top telling readers they may be reading an outdated version.

Non-stable version warining banner

Latest version warning banner

Shows a banner at the top telling readers they are reading the latest un-released version of the documentation.

Latest version warning banner

Search as you type

Super powered search as you type using the Read the Docs's Server Side Search backend, powered by Elasticsearch.

Search as you type

Sponsorship

EthicalAds to support Read the Docs Community being free for everybody.

EthicalAds


Local Development

  • Make sure you have the correct version of Node.js installed (>= 18). You can use asdf or nvm for easier management of different Node.js versions.
  • Run npm install to install dependencies
  • Run npm run dev to start the local dev server. While this can run without a local Read the Docs development instance, not everything will work.
  • Run npm test to run the test suite, using web-test-runner. You can run also npm run test:dev to leave tests running in watch mode or npm run test:debug to manually test the suite in a browser.

Deployment

Deploy documentation is available in our published docs here: https://readthedocs-addons.readthedocs.io/releasing.html