Documentation for building Zooniverse projects.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
.gitignore
Dockerfile
Jenkinsfile
README.md
docker-compose.yml
mkdocs.yml
requirements.txt

README.md

Welcome to Zooniverse's help docs

The documentation is built by MkDocs. For full documentation visit mkdocs.org.

Editting

It's perfectly acceptable to just edit Markdown files on Github and submitting pull requests directly from there. If you feel unsure if your syntax is correct, it's pretty easy to run the site locally though, see below.

Running locally

With Docker, it's a matter of simply docker-compose up.

Without Docker, you'll have to install the Python dependencies. Run pip install -r requirements.txt and then start the local server with mkdocs serve.

In both cases afterwards the site will be served from localhost:8000

Deploying

We're working to get Jenkins to deploy this automatically. In the mean time, mkdocs gh-deploy will deploy for you.