Skip to content

CSS Source Directory Readme

W. Bomar edited this page Feb 7, 2022 · 1 revision

How to Use

  • Author styles as modules in ./_imports/.
  • Import modules into entry point files here at ./.
  • Confirm built stylesheets are compiled to ../build/.

Rules

  1. Users must import styles from ./_imports/.
  2. Files must be named appropriately.
  3. Files must be documented appropriately.

Naming Format

Format Description
site(.*).css only for an entire website
template.*.css only for certain templates
page.*.css only for certain pages
app.*.css only for certain apps a.k.a. plugins

Documentation Format

/* DO NOT ADD STYLES HERE; ONLY IMPORT OTHER STYLESHEETS */

/* Organize via ITCSS */
/* SEE: https://confluence.tacc.utexas.edu/x/IAA9Cw */

/* SETTINGS */
/* … */

...

/* COMPONENTS */
/* … */

...