created:2021-05-14
author:Foobär
top:README:Styles
sort:015
title:Styles

<p>
The styles directory can contain several style sheet sets that are independent of each other. When generating a web site only one of these sets is used. By default
the style "style" is used unless a different style is specified either in the web site's settings file (see "Settings" section below) or through the command line
option <code>--style</code> (<code>-s</code>). That means that by defult all CSS files with a name starting with "style-"... and ending in .css as well as the file "style.css" will be
linked in the header of every generated HTML file. For example the following files will all be used if they exist:
style.css
style-colours.css
style-mobile.css
style-anything-that-you-want.css
</p><p>
If you want to make custom changes to the default style cheet, you can either edit the existing style.css or add a file named style-custom.css or similar.
</p><p>
If you want to create your own style set, you can specify its name in your web site's setting file or pass it with the --style option upon generation.
</p><p>
Example file names: If your style is set as "my_style" then the files
my_style.css
my_style-sidebar.css
my_style-awesomeness.css
my_style-something.css
</p><p>
and so on, will be linked in the header of every generated HTML file headers.
</p><p>
If you would like to link a CSS file on some but not all HTML file's headers or insert internal CSS into the header, you can use the hook <code>hook_head</code>. (See the
"Hooks" section above.)
</p>
