Fossil SCM
| ardoise | Merge trunk into ui-local-diff branch, resolving one merge … | 1 year, 5 months ago | |
| black_and_white | Merge trunk into ui-local-diff branch, resolving one merge … | 1 year, 5 months ago | |
| blitz | Sync with trunk. | 8 months, 3 weeks ago | |
| darkmode | Sync with trunk. | 8 months, 3 weeks ago | |
| default | Sync with trunk. | 8 months, 3 weeks ago | |
| default1 | Extracted built-in skins from skins.c and put into skins su… | 15 years, 8 months ago | |
| default2 | Extracted built-in skins from skins.c and put into skins su… | 15 years, 8 months ago | |
| default3 | Extracted built-in skins from skins.c and put into skins su… | 15 years, 8 months ago | |
| dense | Resurrect the "default" skin from the last release under a … | 2 years, 1 month ago | |
| eagle | Sync with trunk. | 8 months, 3 weeks ago | |
| etienne | Merge trunk into ui-local-diff branch, resolving one merge … | 1 year, 5 months ago | |
| khaki | Merge trunk into ui-local-diff branch, resolving one merge … | 1 year, 5 months ago | |
| original | Sync with trunk. | 8 months, 3 weeks ago | |
| plain_gray | Merge trunk into ui-local-diff branch, resolving one merge … | 1 year, 5 months ago | |
| xekri | Sync with trunk. | 8 months, 3 weeks ago | |
| README.md | Merge trunk into ui-local-diff branch, resolving one merge … | 2.0 KB | 1 year, 5 months ago |
Built-in Skins
Each subdirectory under this folder describes a built-in "skin". There are five key files in each subdirectory:
css.txt→ The CSS for the skindetails.txt→ Skin-specific settingsfooter.txt→ Text of the Content Footer for each pageheader.txt→ Text of the Content Header for each pagejs.txt→ Javascript included in the Content Footer
To improve an existing built-in skin, simply edit the appropriate files and recompile.
To add a new skin:
-
Create a new subdirectory under skins/. (The new directory is called "skins/newskin" below but you should use a new original name, of course.)
-
Add files skins/newskin/css.txt, skins/newskin/details.txt, skins/newskin/footer.txt, skins/newskin/header.txt, and skins/newskin/js.txt. Be sure to "fossil add" these files.
-
Go to the tools/ directory and rerun "tclsh makemake.tcl". This step rebuilds the various makefiles so that they have dependencies on the skin files you just installed.
-
Edit the BuiltinSkin[] array near the top of the src/skins.c source file so that it describes and references the "newskin" skin.
-
Type "make" to rebuild.
See the custom skin documentation for more information.
Development Hints
One way to develop a new skin is to copy the baseline files (css.txt, details.txt, footer.txt, header.txt, and js.txt) into a working directory $WORKDIR then launch Fossil with a command-line option "--skin $WORKDIR". Example:
cp -r skins/default newskin
fossil ui --skin ./newskin
When the argument to --skin contains one or more '/' characters, the appropriate skin files are read from disk from the directory specified. So after launching fossil as shown above, you can edit the newskin/*.txt files using your favorite text editor, then press Reload on your browser to see immediate results.