Skip to content
Online documentation for Stan language and platform
TeX Stan Python CSS R
Branch: master
Clone or download
Pull request Compare This branch is 35 commits behind stan-dev:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
docs
src
.Rhistory
.gitignore
LICENSE
README.md
add_redirects.py
build.py

README.md

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.

You can’t perform that action at this time.