Skip to content
Snippets Groups Projects
README.md 810 B
Newer Older
  • Learn to ignore specific revisions
  • Whitney Armstrong's avatar
    Whitney Armstrong committed
    # IP6 Collaboration
    
    Sylvester Joosten's avatar
    Sylvester Joosten committed
    
    
    Main documentation for the EIC@IP6 collaboration
    
    Whitney Armstrong's avatar
    Whitney Armstrong committed
    https://eic.phy.anl.gov/ip6
    
    
    # Documentation
    
    To Build the documentation on your local machine:
    
    ## Requirments:
    
    - [Sphinx](http://www.sphinx-doc.org/en/master/) - Python documentation generator
    - [Read the Docs Sphinx Theme](https://sphinx-rtd-theme.readthedocs.io/en/stable/) - Theme for final output
    - [recommonmark](https://github.com/miyakogi/m2r) - Markdown to reStructuredText
    
    
    ```
    pip install sphinx sphinx_rtd_theme recommonmark sphinx-autobuild
    ```
    
    ## Building
    
    ```bash
    
    # from project root
    sphinx-autobuild docs docs/_build/html
    
    # from docs root
    sphinx-autobuild . _build/html
    ```
    
    
    ## Read the docs
    
    
    Whitney Armstrong's avatar
    Whitney Armstrong committed
    The documentation is available at https://eic.phy.anl.gov/ip6
    
    Whitney Armstrong's avatar
    Whitney Armstrong committed
    It updates automatically when changes are pushed do the repo