Skip to content

Latest commit

 

History

History
55 lines (30 loc) · 2.06 KB

README.md

File metadata and controls

55 lines (30 loc) · 2.06 KB

Description

Documentation for the (bio-)NMR instrument of the Structural Biology platform located in the department of biochemistry and molecular medicine of the Université de Montréal.

Tutorials and howtos are presented in this documentation, formatted using MkDocs, and the theme Cinder.

To access the site: http://airen.bcm.umontreal.ca/biostruct/NMR_tutorials/

Screenshot of the front page

How to serve locally

First install the required Python distribution packages:

pip install -r requirements.txt

This will install the following (and associated requirements):

  • MkDocs (mkdocs)
  • MkDocs Cinder theme (mkdocs-cinder)
  • Math extension for Python-Markdown (python-markdown-math)
  • MkDocs Bootstrap tables plugin (mkdocs-bootstrap-tables-plugin)

Then serve the website lcoally with MkDocs:

mkdocs serve

By default, the documentation will be available in your browser at this address: http://127.0.0.1:8000/.

How to deploy

First install the required Python distribution packages:

pip install -r requirements.txt

This will install the following (and associated requirements):

  • MkDocs (mkdocs)
  • MkDocs Cinder theme (mkdocs-cinder)
  • Math extension for Python-Markdown (python-markdown-math)
  • MkDocs Bootstrap tables plugin (mkdocs-bootstrap-tables-plugin)

Then build the website with MkDocs

mkdocs build

Finally, copy the static site files to the root folder of your webserver:

cp -r site/* /path/to/server/root

The site should then be available online. Make sure you adjust the /path/to/server/root to match the configuration of webserver.

More information here.