Skip to content
forked from stan-dev/docs

Online documentation for Stan language and platform

License

Notifications You must be signed in to change notification settings

enbrown/stan-docs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

93 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Repository docs

Documentation for Stan language and platform

GitHub Pages

This repository uses GitHub Pages to serve the project pages site with URL https://mc-stan.org/docs. The publishing strategy is to serve the contents of the directory docs on branch master. The docs directory contains an empty file named .nojekyll so that GitHub will treat the contents as pre-generated HTML instead of trying to run jekyll.

Directory Structure

  • src : directory of source files for Stan manuals and book, each in its own named subdirectory.

  • docs: the directory docs on branch master is the publishing source for the project pages site. Whenever a verified member of the Stan organization pushes to docs on branch master, GitHub (re)builds and (re)deploys the website.

  • build.py: python script which compiles markdown files under src to html and pdf and populates the docs dir with the generated documentation.

    • arg 1: MAJOR Stan version, required (expecting number, should be positive int)
    • arg 2: MINOR Stan version, required (expecting number, should be positive int)
    • arg 3: name of document (optional - will build entire docset)
    • arg 4: output format, either "html" or "pdf" (optional - default builds both html and pdfs)
  • LICENSE: licensing terms.

Generating the static site

  1. Install R packages: bookdown

  2. Install on OS and ensure on PATH: pandoc, pandoc-citeproc, pdflatex

  3. Run python build.py <MAJOR> <MINOR> (<document> (<format>))

  4. The generated html and/or pdfs will be in the versioned subdirectory of docs.

About

Online documentation for Stan language and platform

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TeX 57.2%
  • Stan 31.4%
  • Python 5.4%
  • CSS 5.0%
  • R 1.0%