This is the quick start guide for setting up and running the documentation locally.
Ensure you download, install and set up all prerequisites.
Clone the repository to your computer. Then switch to the cloned directory. If you’re planning to contribute, fork the repo and clone your fork instead.
$ git clone https://github.com/WordPress/openverse.git # or your fork $ cd openverse/
If you followed the general setup guide and installed GitHub CLI, you can clone more simply using the
$ gh repo clone WordPress/openverse # or your fork $ cd openverse/
Install only the Python dependencies. You do not need to install any Node.js dependencies to run the documentation.
$ just documentation/install
Run the documentation live server. Once this is done, you should be able to see the documentation on http://127.0.0.1:50230.
$ just documentation/live
Sometimes, the documentation does not refresh to reflect changes in the table of contents or changes to the file system. In those cases, you can clean the caches and restart the live server.
$ just documentation/clean $ just documentation/live
You can press Ctrl + C to terminate the documentation live server.