Skip to content

SpinalHDL/NaxRiscv-Rtd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NaxRiscv-RTD

The documentation is hosted here :

https://spinalhdl.github.io/NaxRiscv-Rtd/main/NaxRiscv/introduction/index.html

How to build this documentation

With venv

Requirements (system)

  • make
  • git

Create a virtual environment with pipenv (will use the Pipfile for installing the necessary packages)

python3 -m venv .venv

then you can activate the virtual envinroment (in bash) and install the dependencies

source .venv/bin/activate
pip install -r requirements.txt

and then you can use make the usual way

make html     # for html
make latex    # for latex
make latexpdf # for latex (will require latexpdf installed)
make          # list all the available output format

all the outputs will be in docs folder (for html: docs/html)

without virtualenv

Requirements (system):

  • make
  • git

Requirements (Python 3):

  • sphinx
  • sphinx-rtd-theme
  • sphinxcontrib-wavedrom
  • sphinx-multiversion

After installing the requirements you can run

make html     # for html
make latex    # for latex
make latexpdf # for latex (will require latexpdf installed)
make          # list all the available output format

you can create build multiple version of the doc via

sphinx-multiversion source docs/html

in the docs/html there will be a folder with the built doc for each branch and tag

Deploying the generated doc by hands

git clone https://github.com/SpinalHDL/SpinalDoc-RTD.git --branch gh-pages deploy_tmp
rm -rf deploy_tmp/*
cp -r docs/html/* deploy_tmp/
cd deploy_tmp/
git add --all
git commit -am "deploy"
git push
cd ..
rm -rf deploy_tmp

Continuous Integration(CI)

This repo use Travis for his CI needs. If you want have a gh-pages preview on your fork, you need to activate your repo on Travis admin page. After that you only need add GITHUB_TOKEN as Environment Variable with your Github personal token (you only need grant repo/public_repo access) More details here:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published