Skip to content

Create a theme CSS file and write it to the current working directory

Usage

create_theme(name = "theme", edit = TRUE)

Arguments

name

Name of theme file (will be written as name.css)

edit

Open an editor for the theme file

Details

How do you apply a custom theme to a Distill site or blog? You have two options:

  1. Apply it site-wide by adding a theme key to the top-level of your _site.yml configuration file:

    name: "distill"
    title: "Distill for R Markdown"
    theme: theme.css
    navbar:
      # (navbar definition here)

  2. Apply to an individual article by adding a theme key to your article’s YAML front-matter:

    ---
    title: "The Sharpe Ratio"
    output:
      distill::distill_article:
        toc: true
        theme: theme.css
    ---

The second option allows for you to apply your theme to individual articles, while using a different theme for the rest of your site. Note that this is only possible for stand-alone articles within a website — you cannot apply a theme to individual blog posts only.

More details

For further details about theming refer to the online documentation.