respondage_vanilla/README.md

31 lines
1.5 KiB
Markdown
Raw Normal View History

Respondage Vanilla — LimeSurvey theme (version 6/7 compatible), extension of the core Vanilla theme.
This is the MOTHER theme. Client-specific variants (e.g. `<client>_vanilla`)
extend this theme via `<extends>respondage_vanilla</extends>` and contain only
a generated `config.xml` plus their own `files/` (logos). LimeSurvey inherits
all files (views, css, js, images, options page) from the mother theme, so any
change to a file in this theme automatically applies to all variants — no
copying of files needed.
## What's in here
- `config.xml` — theme manifest incl. all theme options (colors, fonts, font
sizes/weights/colors, header logos, ...).
- `views/` — twig overrides (header with left/center/right logos and navbar
menu color, survey list, question, group description).
- `sass/` → `css/plain.css` — theme styles (keep both in sync; plain.css is
the compiled output of sass/plain.sass).
- `css/custom.css`, `scripts/custom.js` — loaded last, safe for project
tweaks.
- `options/` — options page assets.
(`variants/*.json`) hold confidential house-style values, are gitignored
(see `.gitignore`) and live in the private variants repo, not here.
## Header logos (left / center / right)
Three independent logo options in the Images category: `brandlogo`(+`brandlogofile`)
left, `centerlogo`(+`centerlogofile`) center, `rightlogo`(+`rightlogofile`)
right. The center logo is absolutely centered in the navbar (see
`sass/plain.sass`). Logo files are looked up in the theme's own `files/`
folder first, then in the mother theme's `files/` folder.