Skip to content

Create a Distill theme CSS file

Source: R/theme.R
create_theme.Rd

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.