Package: kpruss
This package is theSphinxtheme for use by my projects and website.
The base design started from theJekyll Nowthem I started with, but
I’ve modified some of the base styling, structural names, updated the
link images in the footer (based on the usage details for each website),
and adapted it to work withSphinx.Theme OptionsThe theme aims to be light weight and only has a few options.  These are
focused on my wants for my website.  These include:authorThe author of the website (me).  This is placed in the masthead of
each page with the project name beneath and is a link to the main
page.  If this is not give, the project name is used as the main
link.avatarThe URL to the author’sGravatar.  This logo is placed in the
masthead to the left of the author (or project).emailAn email address to use for the email link in the footer.githubThe author’s Github handle (creates a link to the profile using the
Github logo in the footer).linkedinThe author’s LinkedIn handle (creates a link to the profile using
the LinkedIn logo in the footer).stackoverflowThe author’s Stack Overflow user ID (creates a link to the profile
using the Stack Overflow logo in the footer).CustomizationThe theme relies primarily on CSS to manage the customization.  The new
classes it defines are “abstract” and “by-line” for the post layout (see
below).  It uses the following CSS variables to set the basic colors:--foregroundThe color of the main text.--backgroundThe background color of the websites.--headersThe color of the headers.--quotesThe color of block quotes and level four headers.--linksThe color of links.--footerThe background color of the footer, the border below the
masthead, and the admonitions.--main-fontThe list of fonts to use for the main text.--code-fontThe list of fonts to use for code blocks.To override these values (or redefine any other settings), create a
“custom.html” and place it on thehtml_static_path.  To see the default
settings, usepython-mkpruss {base,variables}.The theme defines an additional page for blog posts.  This is just a
normal page, but it defines an “abstract” class that should be the first
paragraph to summarize the post.  It will also typeset the author and
date from the metadata as a by-line after the post.  To create a post,
add the following metadata before the title of a post::author: A. Nonymous
:date: 2021-03-21
:template: post.html

Post Title
==========

.. container:: abstract

    The abstract of the post.

The content of the post.The key metadata value is the:template:.  The page.html template
will use this template to generate the page.  To add a custom template,
place it on thehtml_static_path.  This template should extend the
basic page.html template.This theme defines the template blockheadernavwithin the masthead
in the layout.  This placed at the end of the<header>and is
designed for the “Blog” and “About” navigation buttons from the originalJekyll Nowtemplate.  The following customlayout.htmlwould add
the links these to the header (mind the version skew regardingroot_doc):{%- extends !layout.html %}
{%- block headernav %}
<nav>
  <a href="{{ pathto(root_doc) }}/blog">Blog</a>
  <a href="{{ pathto(root_doc) }}/about">About</a>
</nav>
{{ super() }}
{%- endblock %}ContributingThank you for you interest in improving mySphinxtheme.  It is open
sourced under theBSD 2-Clause LicenselikeJekyll Now, and I
welcome feedback via bug reports, feature requests, and pull requests.
Please report all bug reports or request a feature by submitting an
issue on theGithubproject page.