lammps/doc/README.md

1.1 KiB

Generation of LAMMPS Documentation

The generation of all the documentation is managed by the Makefile inside the doc/ folder.

Usage:

make html         # generate HTML using Sphinx
make pdf          # generate PDF using htmldoc
make clean        # remove generated RST files
make clean-all    # remove entire build folder and any cached data

Installing prerequisites

To run the documention build toolchain, Python 3 and virtualenv have to be installed. Here are instructions for common setups:

Ubuntu

sudo apt-get install python-virtualenv

Fedora (up to version 21), Red Hat Enterprise Linux or CentOS (up to version 7.x)

sudo yum install python3-virtualenv

Fedora (since version 22)

sudo dnf install python3-virtualenv

MacOS X

Python 3

Download the latest Python 3 MacOS X package from https://www.python.org and install it. This will install both Python 3 and pip3.

virtualenv

Once Python 3 is installed, open a Terminal and type pip3 install virtualenv. This will install virtualenv from the Python Package Index.