Themes
A whole new look for the same folder, a logo of your own, other languages.
Three to start from
Foldocs comes with three themes, and the same folder looks entirely different in each. This very site, in all three:
| Theme | Presents the folder as | See it |
| Default | A personal site: a headline, then a row per section | foldocs.com |
| Journal | A blog: one column, newest first | journal.foldocs.com |
| Index | The folder tree itself | index.foldocs.com |
Those two are variants: the same content, built again in another theme at the same moment, each at its own address. Handy for choosing a design with your own content in it.
Your own theme, in a few lines
A theme can extend another and change only what differs. A short file of settings and a few lines of CSS make a new look; a template of your own replaces any part of a page.
- A logo: put logo.svg (and logo-dark.svg) in the theme, and it replaces the name in the header, as on this site
- Icons: favicon.svg for the browser tab, apple-touch-icon.png for phone home screens
- A share image: share.png, 1200 by 630, shown when someone shares a page without a picture
- Analytics or a verification tag: _head.html goes into every page, as this site's privacy-friendly visitor count does
- Another language: every word the templates use, from See all to the month names, is set in the theme
The README shows how. One command checks a theme's contrast, in light and dark mode, against the accessibility guidelines.