~sporiff/alabaster-solarised

A dark theme for Alabaster

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~sporiff/alabaster-solarised
read/write
git@git.sr.ht:~sporiff/alabaster-solarised

You can also use your local clone with git send-email.

Alabaster Solarised Dark Theme

Custom CSS for Alabaster

This CSS is designed to customise the Alabaster theme for Sphinx. It uses the Solarized Dark colour scheme for maximum comfort while reading.

This has been tested with Sphinx and Ablog. An example of the theme in action can be seen here

Special Features

  • Full syntax highlighting in solarized-dark colours
  • True solarized dark colour theme
  • Colours for blocks such as .. note:: and .. warning::

Requirements

To get the most out of this theme, the following is recommended:

Installation

To set the theme up, place the custom.css file in a folder called css within your html_static_path (usually _static) and add the following to your conf.py

# Tell the config file to look for a stylesheet in the css folder

   def setup(app):
    app.add_stylesheet('css/custom.css')

   # Tell Pygments to lex using the solarized dark theme

   pygments_style = 'solarized_dark'

   # Make sure your static path is set

   html_static_path = ['_static']

Now run sphinx-build or ablog build (depending on what you're using) and you should see the CSS take effect.