Skip to contents

Setup

Source: vignettes/Setup.qmd

If you haven’t started a pkgdown site yet, initialize it.

usethis::use_pkgdown()

In ./_pkgdown.yml add the contributed package:

template:
  package: pkgdownconfig

Point to this repository in DESCRIPTION to download the theme automatically.

Config/Needs/website: stan-dev/pkgdown-config

Optionally, you should be able to pin a specific version of the template with a tag or commit:

Config/Needs/website: stan-dev/pkgdown-config@v1.0.1

Config/Needs/website: stan-dev/pkgdown-config@COMMITHASH

For local development, you need to install the package before you can build the site:

pak::pak("stan-dev/pkgdown-config")
pkgdown::build_site()

If you’re getting an error about dependency resolution when using a GitHub Action to automatically build your pkgdown site, remove the Config/Needs/website: line from DESCRIPTION and add use the R dependencies step like here:

      - uses: r-lib/actions/setup-r-dependencies@v2
        with:
          extra-packages: any::pkgdown, local::., stan-dev/pkgdown-config

By default, the theme has a navbar item which has other Stan R packages–this is not smart and won’t automatically drop the package you’re using the theme in. If you don’t want this, you should override that list in _pkgdown.yml. This example is taken from loo’s setup

navbar:
  title: "loo"

  structure:
    left: [home, vignettes, functions, news, pkgs, stan]
    right: [search, bluesky, forum, github, lightswitch]

  components:
    pkgs:
      text: Other Packages
      menu:
        - text: bayesplot
          href: https://mc-stan.org/bayesplot
        - text: cmdstanr
          href: https://mc-stan.org/cmdstanr
        - text: posterior
          href: https://mc-stan.org/posterior
        - text: projpred
          href: https://mc-stan.org/projpred
        - text: rstan
          href: https://mc-stan.org/rstan
        - text: rstanarm
          href: https://mc-stan.org/rstanarm
        - text: rstantools
          href: https://mc-stan.org/rstantools
        - text: shinystan
          href: https://mc-stan.org/shinystan

If for some reason the favicons don’t get copied over, download logo.svg, and run pkgdown::build_favicons() once to build the favicons. If you already have favicons, the template my overwrite them to save a copy and ping @Visruth on the Stan Slack.

Note that the favicons and logo should be copied into your build directory and ideally should be hooked in automatically. If you can’t find the logo, you can download it from here and follow the same steps above.

If you want the hex in your README, edit the README.MD. You can take a look at this package’s to get an idea of what you need to do (repeated below):

# pkgdownConfig <a href="https://mc-stan.org/pkgdown-config"><img src="man/figures/logo.svg" align="right" height="139" alt="pkgdownConfig website" /></a>

For any further concerns/help/anything, open an issue and/or ping @Visruth on the Stan Slack.