/documentation

Documentation site for Decidim project built with Antora

Primary LanguageCSS

Decidim Documentation

Netlify Status

This is the new repository for the Decidim Documentation website:

Is built with Antora, although for this version we're going to try to not have multi-repositories, as it's a hassle to work with. The idea is to have all the documents living on this same repository.

This project is on active development and it's not on production yet.

For working with it, you can do it several ways:

Install locally

Manually

Install antora with software dependencies.
# Install Node & npm using nvm
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
nvm install node

# Install Antora and dependencies
npm install

If antora installation succeed, antora -v will return antora's version.

Clone repository and build documentation website.
git clone https://github.com/decidim/documentation
cd documentation
./bin/build

Website source code will be create under documentation/build/site/decidim folder. Serve index.html with any application or http server.

xdg-open build/site/index.html

Docker

You can check this locally and install with Docker.

git clone https://github.com/decidim/documentation
cd documentation
docker run -u $(id -u) -v $PWD:/antora:Z --rm -t antora/antora antora-playbook.yml
xdg-open build/site/index.html

Roadmap

This is a work in progress. This will be on production when we finish all the issues on the MVP Milestone.