cdsoft.css

cdsoft.css is a simple and reusable CSS file designed to provide consistent styling across multiple CDSoft projects. This stylesheet supports both light and dark themes automatically, using the user's system preferences.

It is meant to be used with Pandoc.

How to Use

You can apply this stylesheet to any document you convert with pandoc, using the --css option. This file is self-contained and does not require any build tools or JavaScript to function. It adapts to the user's preferred color scheme (light or dark) using the prefers-color-scheme media query.

Example command

You have to add --standalone (-s) to generate a full HTML document with embedded metadata and optionally --embed-resources to embed everything in the HTML document (images, cdsoft.css...) to make it easier to distribute.

pandoc input.md -o output.html --standalone --embed-resources --css=cdsoft.css

Theme Support

The stylesheet automatically adjusts based on the user's system theme preference:

Light theme: default colors for readability during daytime.
Dark theme: reduced brightness for comfortable reading at night.

No configuration or JavaScript is required -- the switch is fully automatic via media queries.

Example

example/example.md is an example how to use cdsoft.css. See build.lua to see how to build an HTML file with:

Once bang, ninja, ypp and pandoc are installed:

$ bang      # generate build.ninja
$ ninja     # generate example.html in the .build directory

Better example

https://cdelord.fr uses cdsoft.css.

License

This file is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0). You may use it freely in your projects, including proprietary ones, as long as any modifications to this CSS file are published under the same license.

For full license terms, see the LICENSE file or visit: https://www.gnu.org/licenses/lgpl-3.0.html