Styling

css/cdsoft*.css are simple and reusable CSS files designed to provide consistent styling across multiple projects. These stylesheets support both light and dark themes automatically, using the user's system preferences. They all implement the same style with various color accentuations.

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 css/cdsoft.css and its variants. See build.lua to see how to build an HTML file with:

• bang,
• ninja,
• ypp,
• and Pandoc.

Once bang, ninja, ypp and pandoc are installed:

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

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