seafoam


Nameseafoam JSON
Version 2.9.2 PyPI version JSON
download
home_pagehttp://blog.minchin.ca/label/seafoam/
SummaryPelican theme, first used for Minchin.ca.
upload_time2024-03-05 04:59:11
maintainer
docs_urlNone
authorW. Minchin
requires_python
licenseMIT License
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            =======
Seafoam
=======

.. image:: https://raw.githubusercontent.com/MinchinWeb/seafoam/master/docs/seafoam-logo-4x.png
    :align: center
    :alt: Seafoam Logo

``Seafoam`` is a theme for `Pelican <http://docs.getpelican.com/>`_,
a static site generator written in Python.

.. image:: https://img.shields.io/pypi/v/seafoam.svg?style=flat
    :target: https://pypi.python.org/pypi/seafoam/
    :alt: PyPI version number

.. image:: https://img.shields.io/badge/-Changelog-success
   :target: https://github.com/MinchinWeb/seafoam/blob/master/docs/changelog.rst
   :alt: Changelog

.. image:: https://img.shields.io/pypi/pyversions/seafoam?style=flat
    :target: https://pypi.python.org/pypi/seafoam/
    :alt: Supported Python version

.. image:: https://img.shields.io/pypi/l/seafoam.svg?style=flat&color=green
    :target: https://github.com/MinchinWeb/seafoam/blob/master/LICENSE.txt
    :alt: License

.. image:: https://img.shields.io/pypi/dm/seafoam.svg?style=flat
    :target: https://pypi.python.org/pypi/seafoam/
    :alt: Download Count


The ``seafoam`` theme is based on Bootstrap 3, and was first used at
`Minchin.ca <http://minchin.ca>`_. 

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/front_page.png
    :align: center
    :alt: Front Page


Installation
------------

The easiest way to install the ``seafoam`` theme is through the use
of pip. This will also install the required dependencies automatically.

.. code-block:: sh

  pip install seafoam

Alternatively, you can force the installation of ``lxml``, which is a HTML
parser that is often faster than the default, and will be used if installed:

.. code-block:: sh

  pip install seafoam[lxml]

If you are using Pelican v4.5 or newer and only namespace plugins, ``seafoam``
is set up as a namespace plugin and will automatically activate and configure
itself.

If you are using a version of Pelican older that v4.5 or non-namespace plugins,
you will need to add ``seafoam`` to your list of plugins:

.. code-block:: python

  # pelicanconf.py

  PLUGINS = [
      "pelican.plugins.seafoam",
      # others, as desired...
  ]

  # the rest of the your configuration file...


You may also need to configure the theme through the use of additional settings
(see below).


Requirements
------------

``Seafoam`` requires Pelican, the ``image_process`` plugin, the
``jinja filters`` plugin, ``beautifulsoup4``, and ``semantic_version``. If the
theme is installed from pip, these should be automatically installed. If
needed, they can be manually installed with pip:

.. code-block:: sh

   pip install pelican
   pip install pelican-image-process
   pip install pelican-jinja-filters
   pip install beautifulsoup4
   pip install semantic_version


Supported Plugins
-----------------

Seafoam also works with several other plugins for Pelican, but none of those
listed in this section are required.

- `microblogging <https://blog.minchin.ca/label/microblogging-pelican/>`_ --
  adds the ability to have "microposts", and tweaks the formatting of the theme
  based on their (assumed) shorter length.
- `readtime <https://pypi.python.org/pypi/pelican-readtime>`_ -- provides
  estimated reading time for articles. Available from PyPI as
  ``pelican-readtime``.
- `post-stats
  <https://github.com/getpelican/pelican-plugins/tree/master/post_stats>`_ --
  provides estimated reading time for articles if ``readtime`` is not available.
  Available in the `Pelican Plugins collection
  <https://github.com/getpelican/pelican-plugins/>`_.
- `neighbors <https://pypi.python.org/pypi/pelican-neighbors>`_ -- provides
  post-article links to the next and previous article on your blog and the
  next and previous article in that category. Available on PyPI as
  ``pelican-neighours``.
- `static-comments <https://blog.minchin.ca/label/static-comments/>`_ (or the
  older `pelican_comment_system
  <https://bernhard.scheirle.de/posts/2014/March/29/static-comments-via-email/>`_)
  -- add static comments to your blog. Available on PyPI as
  ``minchin.pelican.plugins.static-comments``.
- `Related Posts
  <https://github.com/getpelican/pelican-plugins/tree/master/related_posts>`_ --
  adds the ``related_posts`` variable to the article's context.
- Tipue Search


Additional Images
-----------------

Article with header image

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/article_with_header.png
    :align: center
    :alt: Article with Header Image

Main article body

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/article_body.png
    :align: center
    :alt: Article Body
    
Comments
    
.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/comments.png
    :align: center
    :alt: Comments

Comment Form

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/comment_form.png
    :align: center
    :alt: Comment Form

Main Archives

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives.png
    :align: center
    :alt: Main Archives

Yearly Archives

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives-year.png
    :align: center
    :alt: Yearly Archives

Monthly Archives

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives-month.png
    :align: center
    :alt: Monthly Archives

404 Error Page

.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/404.png
    :align: center
    :alt: 404 Error

.. add microblog post image

.. add Strathcona theme image


Additional Settings
-------------------

These settings can be set in your ``pelicanconf.py`` file (your Pelican settings
file) to alter the behavior of the theme.

If a value is given below, this represents the effective default value. If no
value is given, the effective default value is ``None``.

If you are using this theme on a sub-site (i.e a directory of the "main site"),
look at ``MENUITEMS_2``, ``MENUITEMS_2_AT``, and ``MENUITEMS_2_AT_LINK``
settings.

If you are using this theme on a subdomain, look at the ``SITE_ROOT_URL``
setting.

If you want to disable *Image Process* for local development, see
``SEAFOAM_DEV_MODE``.

Seafoam also auto-configures itself when possible.  If you need to manually
create the default configuration, you would need the following:

.. code-block:: python

  # pelicanconf.py

  from pelican.plugins import seafoam

  THEME = seafoam.get_path()
  BOOTSTRAP_THEME = "seafoam"

  # if PLUGINS is not defined on Pelican 4.5+, these plugins will autoload
  PLUGINS = [
      "pelican.plugins.seafoam",
      "pelican.plugins.jinja_filters",
      "pelican.plugins.image_process",
      # others, as desired...
  ]

  IMAGE_PROCESS = {
    "article-feature": ["scale_in 848 848 True"],
    "index-feature": ["scale_in 263 263 True"],
  }

  # Generate 404 error page
  TEMPLATE_PAGES = {
      "404.html": "404.htm"',
  }

  # the rest of the your configuration file...

This documentation has to be manually updated. If the settings no longer match
the theme's behavior, or a setting is missing from here, please open a ticket
on `GitHub <https://github.com/MinchinWeb/seafoam/issues>`_.

.. use the ".. data::" directive here for Sphinx output, but on GitHub, that just causes everything to disappear

ABOUT_ME
  You can show a short blurb of text about yourself and a picture. This setting
  is the paragraph. Raw HTML is accepted. See the ``AVATAR`` setting to set the
  picture.
ADAM
  These ADAM settings were originally set up to support my genealogy sub-site
  (the original name of the the pre-processor I was using as called "Adam"). If
  this is set to ``False``, the rest of the ``ADAM_*`` settings won't be active.
  These settings are probably generic enough that you could use these for any
  generator or outside program used to help generate your site.
ADAM_COPY_DATE
  Override the copyright date in the footer. (Provide a string).
ADAM_FOOTER
  An extra "page footer" to apply to all pages. (Provide an HTML string.)
ADAM_LINK
  Link target for the Adam version text.
ADAM_UPDATED
  Override the updated date.
ADAM_VERSION
  Reported name and version of "Adam". 
ADDTHIS_PROFILE
  You can enable sharing buttons through `AddThis <http://www.addthis.com/>`_
  by this setting to your AddThis profile-id. This will display a Tweet,
  Facebook Like and Google +1 button under each post.
ARCHIVES_URL
  Same as the regular Pelican setting.
ASSET_CSS
  Set to ``True`` if you want the ``asset`` plugin to compile your CSS.
ASSET_JS
  Set to ``True`` if you want the ``asset`` plugin to compile your Javascript.
AUTHOR
  Who to list as the copyright belonging to in the site footer.
AUTHORS_URL
  Same as the regular Pelican setting.
AVATAR
  You can show a short blurb of text about yourself and a picture. This setting
  is the path to the picture. See the ``ABOUT_ME`` setting to set the
  descriptive paragraph.
BOOTSTRAP_NAVBAR_INVERSE = False
  Apply inverse CSS setting to Navbar. Changing this will swap the top
  navigation bar between light and dark.
BOOTSTRAP_THEME = "seafoam"
  Use this to set the "colour scheme" of the framework. Valid values are
  ``seafoam`` and ``strathcona``. ``seafoam`` teal on darker green;
  ``strathcona`` is maroon on white. This is a Automatically set to ``seafoam``
  by the internal plugin if unspecified. Other values (including leaving this
  unset) are not expected to work correctly.
CATEGORIES_URL
  Same as the regular Pelican setting.
CATEGORY_IMAGES = {}
  Provide a default featured image by category. If an image is set in the
  article metadata, that will override this.

  Provide a dictionary where the key is the category name and the value is the
  path of the image, relative to the SITEURL.
CC_ATTR_MARKUP
  Optionally, you can include attribution markup in the CC license mark by
  setting this to ``True``.
CC_LICENSE
  Set a site-wide Creative Commons License by specify the "short name" of the
  license (like ``CC_BY``, or ``CC-BY-NC-ND``). Alternately, use
  ``CC_LICENSE_COMMERCIAL`` and ``CC_LICENSE_DERIVATIVES`` to "build a
  license".
CC_LICENSE_COMMERCIAL
  "yes" if commercial use is permitted, "no" otherwise. Use this in lieu of
  ``CC_LICENSE`` and in combination with ``CC_LICENSE_DERIVATIVES`` to "build a
  license".
CC_LICENSE_DERIVATIVES
  "yes" is derivatives are permitted, "no" otherwise. Use this in lieu of
  ``CC_LICENSE`` and in combination with ``CC_LICENSE_COMMERCIAL`` to "build a
  license".
CUSTOM_CSS
  Link, relative to SITEURL, to a custom CSS file.
CUSTOM_CSS_LIST = []
  Custom CSS to load; can be either absolute links, or relative links. If the
  listed item starts with ``//``, ``http://``, ``https://``, it is assumed to
  be absolute link and added as-is to the markup. Otherwise, the link is
  assumed to be relative to SITEURL.
CUSTOM_JS_LIST = []
  Custom Javascript to load; can be either scripts, absolute links, or relative
  links. If the listed item starts with ``<script``, then the item is assumed
  to be the contents of a script, including opening and closing tags, and so
  added to the pages' markup directly. If the listed item starts with ``//``,
  ``http://``, ``https://``, it is assumed to be absolute link and added as-is
  to the markup. Otherwise, the link is assumed to be relative to SITEURL.

  See also ``CUSTOM_JS_LIST_HEAD`` and ``JQUERY_JS_IN_HEAD``.
CUSTOM_JS_LIST_HEAD = []
  Exactly the same format as ``CUSTOM_JS_LIST``, but is added to the pages'
  ``<head>`` section rather than the end of the page. Generally, you will want
  to put your Javascript at the end of the page (i.e. in ``CUSTOM_JS_LIST``
  rather than here), as any Javascript referenced here must generally be
  completely loaded before the page will start being rendered.
  
  When ``JQUERY_JS_IN_HEAD == True`` (not the default), JQuery is listed before
  the other scripts listed here.
  
  See also ``CUSTOM_JS_LIST`` and ``JQUERY_JS_IN_HEAD``.
DEFAULT_LANG
  .
DISPLAY_ARCHIVES_ON_MENU = True
  Include archives on the main site menu.
DISPLAY_BREADCRUMBS = False
  Display Breadcrumbs on site.

  See also ``MENUITEMS_2_AT`` and ``MENUITEMS_2_AT_LINK`` settings.
DISPLAY_CATEGORIES_ON_MENU
  Include categories on the main site menu.
DISPLAY_CATEGORIES_ON_SIDEBAR
  Include a listing of categories on the sidebar (assuming the sidebar is
  active; see ``HIDE_SIDEBAR`` setting)
DISPLAY_PAGES_ON_MENU
  Include a listing of pages on the sidebar (assuming the sidebar is active;
  see ``HIDE_SIDEBAR`` setting)
DISPLAY_RECENT_POSTS_ON_SIDEBAR
  Include a listing of recent posts on the sidebar (assuming the sidebar is
  active; see ``HIDE_SIDEBAR`` setting). Also see the ``RECENT_POST_COUNT``
  setting.
DISPLAY_TAGS_INLINE
  .
DISPLAY_TAGS_ON_SIDEBAR = True
  Include a listing of tags on the sidebar (assuming the sidebar is active;
  see ``HIDE_SIDEBAR`` setting)
DISQUS_DISPLAY_COUNTS
  Display the number of comments (assuming Disqus comments are active; see
  ``DISQUS_SITENAME`` settings)
DISQUS_ID_PREFIX_SLUG
  Set this to ``True`` if you have configured your article URLs such that the
  slug alone will likely not be unique. Ignored if ``DISQUS_NO_ID`` is ``True``.
DISQUS_NO_ID
  This theme sets identifiers for each article's comment threads. If you are
  switching from a theme that doesn't (such as the Pelican built-in default)
  this will result in existing comments getting lost. To prevent this, set
  this setting to ``True``.
DISQUS_SITENAME
  Set to your Disqus sitename to activate Disqus comments on your site.

  You can also enable Disqus comments for pages. This is a per-page setting you
  can control by adding a field comments to you pages' metadata. Set it to
  enabled to enable comments for that page. Comment-threads for pages will have
  an id that is prefixed by ``page-``.

  You will probably only use this or the Pelican Comment System; odd results
  may come if you try to use both together. See the ``PELICAN_COMMENT_SYSTEM``
  setting.
DOCUTIL_CSS
  If you're using reStructuredText for writing articles and pages, you can
  include the extra CSS styles that are used by the docutils-generated HTML by
  setting this to ``True``. This can be done as a global setting or setting it
  in the metadata of a specific article or page.
FAVICON
  The location of your site's FavIcon, relative to the SITEURL.
FEED_ALL_ATOM
  Same as the regular Pelican setting. If set, a link to your Atom feed will
  appear in the site's HTML header and as a link in the footer of the site.
FEED_ALL_RSS
  Same as the regular Pelican setting. If set, a link to your RSS feed will
  appear in the site's HTML header.
GITHUB_REPO_COUNT = 5
  See ``GITHUB_USER`` setting.
GITHUB_SHOW_USER_LINK
  See ``GITHUB_USER`` setting.
GITHUB_SKIP_FORK = False
  See ``GITHUB_USER`` setting.
GITHUB_USER
  The theme can show your most recently active GitHub repos in the sidebar. To
  enable, set this to you GitHub username. Appearance and behavior can be
  controlled using the ``GITHUB_REPO_COUNT``, ``GITHUB_SKIP_FORK``, and 
  ``GITHUB_SHOW_USER_LINK`` variables.
GOOGLE_ANALYTICS
  Used to activate "classic" Google Analytics. Set this to your account's Google
  Analytics ID. Although this setting doesn't conflict with
  ``GOOGLE_ANALYTICS_UNIVERSAL``, you will in most cases only use one or the
  other. This has been deprecated by Google; see ``GOOGLE_ANALYTICS_V4``.
GOOGLE_ANALYTICS_UNIVERSAL
  Used to activate "universal" Google Analytics (this is the new version). Set
  this to your account's ID (a number). Also set
  ``GOOGLE_ANALYTICS_UNIVERSAL_PROPERTY``. Although this setting doesn't
  conflict with ``GOOGLE_ANALYTICS``, you will in most cases only use one or
  the other. This has been deprecated by Google (in June 2023); see
  ``GOOGLE_ANALYTICS_V4``.
GOOGLE_ANALYTICS_UNIVERSAL_PROPERTY
  Set this to the Google Analytics "property" this site represents. See also
  (and set) ``GOOGLE_ANALYTICS_UNIVERSAL``.
GOOGLE_ANALYTICS_V4
  Set this to activate Google Analytics v4.
HIDE_SIDEBAR = False
  Hides the sidebar, and all it's contents. Also review the settings
  ``DISPLAY_CATEGORIES_ON_SIDEBAR``, ``DISPLAY_RECENT_POSTS_ON_SIDEBAR``,
  ``DISPLAY_TAGS_ON_SIDEBAR``, ``GITHUB_USER``, ``LINKS``, and
  ``TWITTER_USERNAME``.
HIDE_SITENAME = False
  Hides the sitename in the site navbar.
IMAGE_PROCESS = {"article-feature": ["scale_in 848 848 True"], "index-feature": ["scale_in 263 263 True"],}
  Used by the *image process* plugin. The "article-feature" and "index-feature"
  configurations are set by the included plugin if not set in your
  configuration to something else.
INDEX_COPY_DATE
  Copyright date to display on the index page (homepage) of the site.
JQUERY_JS_IN_HEAD = False
  Bootstrap depends on JQuery. Typically, good practice is to load all your
  Javascript from the end of your page. However, in certain cases, I've needed
  to load JQuery sooner. So this moves loading JQuery from the end of the page
  to the header. When active, JQuery is listed before the other scripts in
  ``CUSTOM_JS_LIST_HEAD``. See also ``CUSTOM_JS_LIST_HEAD``.
LINKS = []
  Extra links to display sidebar. Provide a list of tuples of the form
  ``('name', 'link')``.
MENUITEMS
  Extra items to add to the menu. Provide a list of tuples of the form
  ``(title, link, icon)``. ``link`` is absolute, so build them using SITEURL, 
  if needed. ``icon`` here is of the form of the CSS classes to be used; e.g.
  ``'fa fa-fw fa-pencil'``. ``icon`` can be set to ``None``.

  If this is set, the working assumption is that the site you are generating is
  a "sub-site".
MENUITEMS_2
  Extra items you want added as a sub-menu. Use in conjunction with the
  ``MENUITEMS_2_AT`` setting. Provide a list of tuples of the form
  ``(title, link, icon)``. ``link`` is absolute, so build them using SITEURL, 
  if needed. ``icon`` here is of the form of the CSS classes to be used; e.g.
  ``'fa fa-fw fa-pencil'``. ``icon`` can be set to ``None``.

  This setting is working on the assumption that your generated site in going
  into a subdirectory of your "main" site.
MENUITEMS_2_AT
  If ``MENUITEMS_2`` is set, under which (main) menu item are these to be
  displayed. This should match a "name" of one of the items on ``MENUITEMS``;
  if no match is found, these sub-menu items will not be displayed.

  When set and Breadcrumbs are enabled, all items on the site are shown to be
  under both "home" (linked to at the ``SITE_ROOT_URL``) and ``MENUITEMS_2_AT``
  (linked to at ``MENUITEMS_2_AT_LINK``).
MENUITEMS_2_AT_LINK
  When set and Breadcrumbs are enabled, all items on the site are shown to be
  under both "home" (linked to at the ``SITE_ROOT_URL``) and ``MENUITEMS_2_AT``
  (linked to at ``MENUITEMS_2_AT_LINK``).
MICROBLOG_DEV_URL
  The project url for the microblogging plugin. Provided by the plugin, when in
  use.
MICROBLOG_VERSION
  The version of the microblogging plugin. Provided by the plugin, when in use.
NAVBAR_ON_TOP = False
  If True, the navigation menu is on top. If False, the navigation menu is
  vertical on the left side of the page. Default is False.
NEIGHBORS
  Activates the links to the next and previous articles, both in the "all
  posts" index and the category-specific index. Requires the
  `neighbors <https://pypi.python.org/pypi/pelican-neighbors>`_ to be both
  installed and activated (i.e. listed under ``PLUGINS``).
OPEN_GRAPH_FB_APP_ID
  You can use this setting to provide a Facebook *app id*. See the
  ``USE_OPEN_GRAPH`` setting.
OPEN_GRAPH_IMAGE
  A default image to use with Open Graph. This is a filepath relative to your
  SITEURL. See the ``USE_OPEN_GRAPH`` setting.
PAGINATOR_LIMIT = 8
  Number of page number links to appear of the main "index" page of your
  blog. The default of 8 results in showing a link to page 1, links the
  three previous pages (8 divided by 2 and rounded down), a number
  representing the current page, links to the next three pages, and a link
  to the last page.
PDF_PROCESSOR
  .
PELICAN_COMMENT_SYSTEM = False
  Set this to ``True`` to active the
  `pelican_comment_system <https://bernhard.scheirle.de/posts/2014/March/29/static-comments-via-email/>`_.

  The Pelican Comment System has
  `further settings <https://github.com/Scheirle/pelican_comment_system/blob/master/doc/installation.md>`_
  that are not used directly by the theme.

  You will probably only use this or Disqus; odd results may come if you try to
  use both together. See also the ``DISQUS_SITENAME`` setting.
PELICAN_COMMENT_SYSTEM_DISPLAY_COUNTS = True
  Whether to display the number of comments
PELICAN_COMMENT_SYSTEM_EMAIL_DOMAIN
  The domain name of the email where you want the comments to be emailed to
  (i.e. the part after the ``@`` sign). See the
  ``PELICAN_COMMENT_SYSTEM_EMAIL_USER`` and ``PELICAN_COMMENT_SYSTEM``
  settings.
PELICAN_COMMENT_SYSTEM_EMAIL_USER
  The username of the email where you want the comments to be emailed to (i.e.
  the part before the ``@`` sign). See the
  ``PELICAN_COMMENT_SYSTEM_EMAIL_DOMAIN`` and ``PELICAN_COMMENT_SYSTEM``
  setting.
PELICAN_COMMENT_SYSTEM_FEED, PELICAN_COMMENT_SYSTEM_FEED_ALL
  Used internally to generate links to the Comment RSS/Atoms feeds.
PELICAN_COMMENT_SYSTEM_IDENTICON_SIZE = 72
  The size of the Identicons generated by the Pelican Comment System.
PIWIK_SITE_ID
  Used for Piwik site analytics.
PIWIK_SSL_URL = PIWIK_URL
  Used for Piwik site analytics.
PIWIK_URL
  Used for Piwik site analytics.
PLUGINS
  Same as the regular Pelican setting. If you set this, be sure to include the
  internal plugin ``pelican.plugins.seafoam`` to get the theme to
  auto-configure itself.
PRJCT
  Set to ``TRUE`` to active `prjct <https://github.com/MinchinWeb/prjct>`_
  support. Recommended segment to include in your ``pelicanconf.py``:

  .. code-block:: python

    # pelicanconf.py

    import prjct

    PRJCT = True
    PRJCT_TODO, PRJCT_DONE = prjct.todo_export.to_html_dicts()
    PRJCT_PROJECTS = prjct.multi_source.project_list()
    PRJCT_ACTIVE_PROJECTS = prjct.multi_source.active_project_list()
    PRJCT_SOMEDAY_PROJECTS = prjct.config.someday_projects()
    PRJCT_COMPLETED_PROJECTS = prjct.config.completed_projects()
    PRJCT_DESC = prjct.descriptions.to_html_dict(
        markdown_extension_config=MARKDOWN['extension_configs']
    )
    PRJCT_VERSION = prjct.__version__
    PRJCT_FOOTER_URL = prjct.__url__

  Also add prjct to our direct templates list.
PRJCT_ACTIVE_PROJECTS
  A list of *active* projects. Used to sort projects on the main prjct page.
  See the ``PRJCT`` setting.
PRJCT_COMPLETED_PROJECTS
  A list of *active* projects. Used to sort projects on the main prjct page.
  See the ``PRJCT`` setting.
PRJCT_DESC
  A dictionary of descriptions for each project, where the key is the name of
  the project, and will match the *tag* page where the output appears. The
  return value is assumed to be a valid HTML segment. See the ``PRJCT``
  setting.
PRJCT_DONE
  A dictionary of done to-do items for each project, where the key is the name
  of the project, and will match the *tag* page where the output appears. The
  return value is assumed to be a valid HTML segment. See the ``PRJCT``
  setting.
PRJCT_FOOTER_URL = 'https://github.com/MinchinWeb/prjct'
  *prjct* URL used for link displayed in footer. See the ``PRJCT`` setting.
PRJCT_SOMEDAY_PROJECTS
  A list of *active* projects. Used to sort projects on the main prjct page.
  See the ``PRJCT`` setting.
PRJCT_TODO
  A dictionary of open to-do items for each project, where the key is the name
  of the project, and will match the *tag* page where the output appears. The
  return value is assumed to be a valid HTML segment. See the ``PRJCT``
  setting.
PRJCT_VERSION = ''
  *prjct* version displayed in footer. See the ``PRJCT`` setting.
PYGMENTS_STYLE = 'native'
  This setting is currently ignored, and my preferred Pygments style is
  included directly into the Seafoam CSS.
RECENT_POST_COUNT = 5
  Number of recent posts to display on the sidebar. See the
  ``DISPLAY_RECENT_POSTS_ON_SIDEBAR`` setting.
RELATED_POSTS_TEXT = 'Related Posts:'
  Header for related posts listing. Requires that the
  `Related Posts Plugin <https://github.com/getpelican/pelican-plugins/tree/master/related_posts>`_
  be active.
SEAFOAM_DEV_MODE = False
  Enable this to speed local development by (effectively) disabling the *Image
  Process* plugin. If you disable this in your ``pelicanconf.py``, you'll
  likely want to activate it in your ``publishconf.py`` file.
SEAFOAM_ENCODING = "uft-8"
  The encoding that Beautiful Soup uses when run by the internal plugin.
SEAFOAM_PARSER = "html.parser"
  Will be set to "lxml" is it is installed (which is the case with the most
  recent versions of the required ``image-process`` plugin).

  This is the parser that Beautiful Soup uses when run by the internal plugin.
SEAFOAM_URL = "http://blog.minchin.ca/label/seafoam/"
  The project url of the theme (automatically provided by the bundled plugin).
SEAFOAM_VERSION = pelican.plugins.seafoam.__version__
  The version of the theme (automatically provided by the bundled plugin).
SITELOGO
  Link to the site logo (displayed in the navbar). This is relative to the
  SITEURL.
SITELOGO_SIZE
  The width of the site logo in the navbar. Can be set to any valid CSS value
  (i.e. %, em, px, etc). I have had good luck setting this to ``100%``.
SITENAME
  The name of your site, displayed in the navbar.
SITEURL
  Same as the Pelican setting. Set this to where this Pelican site is actually
  hosted. Also see the ``SITE_ROOT_URL`` setting.
SITE_ROOT_URL = SITEURL
  Use this if you're hosting a subsite of some sort. This is where the links in
  logo in the navbar and the home icon in the breadcrumbs will point to. See
  also the ``MENUITEMS_2_AT`` setting.
SOCIAL
  A list of your social media sites to be listed in the sidebar. Should be a
  list of tuples in the form ('social network name', 'full link to profile').
  The theme will display the logo of the network. See the ``HIDE_SIDEBAR``
  setting.
TAGS_TEXT = "Tags"
  Text used as the header to "Tags" (articles can be filed under multiple tags,
  but assumes to be under a single (or no) category. Assumed to be plural.
TAGS_URL
  Same as the Pelican setting.
TEMPLATE_PAGES = {"404.html": "404.html",}
  Same as the Pelican setting. Automatically set by the internal plugin to
  enable a 404 error page on GitHub pages (and perhaps elsewhere).
THEME = pelican.plugins.seafoam.get_path()
  Same as the Pelican setting. Automatically set by the internal plugin.
THEME_STATIC_DIR
  Same as the Pelican setting.
TWITTER_USERNAME
  You can optionally provide a this which will be used to set the Twitter
  username for the site and for the content creator.
TWITTER_WIDGET_ID
  The theme can show your twitter timeline in the sidebar. To enable, provide a
  ``TWITTER_USERNAME`` and a ``TWITTER_WIDGET_ID``.

  To get a ``TWITTER_WIDGET_ID``, go to:
  `https://twitter.com/settings/widgets <https://twitter.com/settings/widgets>`_
  and select *Create new*. You'll find the ``TWITTER_WIDGET_ID`` under the html
  or in the site url:

  https://twitter.com/settings/widgets/TWITTER_WIDGET_ID/edit
TYPOGRIFY
  Whether to activate Typography. Tyopgraphy is a library that automatically
  adds a number of typographical flourishes. The necessary CSS is automatically
  included in the *seafoam* CSS.

  The Typography Python library will needs to be installed, which is
  installable via pip: ``pip install typogrify``

  Note that with Pelican 3.6, activating both the Pelican Comment System and
  Typography at the same time cause issues. This issue was fixed in Pelican
  3.7.
USE_OPEN_GRAPH = True
  In order to make the Facebook "like" button and other social sharing options
  work better, the template contains Open Graph metatags like
  ``<meta property="og:type" content="article"/>``. You can disable them by
  setting this to ``False``.

  See also ``OPEN_GRAPH_FB_APP_ID``, and ``OPEN_GRAPH_FB_APP_ID``
  settings.

It may also be helpful to review the
`settings for Pelican itself <http://docs.getpelican.com/en/3.7.1/settings.html>`_.

On articles, the theme also looks for the ``image`` metadata setting to provide
the "featured image* for the article.


Known Issues
------------

- activating both Typogrify and the Pelican Comment System on Pelican 3.6
  causes issues. This issue has been fixed in Pelican 3.7.

Credits
-------

Original theme developed by `Daan Debie <http://dandydev.net/>`_.

The idea that a theme could be installed as a Python package by `Jeff
Forcier <http://bitprophet.org/>`_'s `Alabaster theme
<https://github.com/bitprophet/alabaster>`_ for Sphinx.

            

Raw data

            {
    "_id": null,
    "home_page": "http://blog.minchin.ca/label/seafoam/",
    "name": "seafoam",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "W. Minchin",
    "author_email": "w_minchin@hotmail.com",
    "download_url": "https://files.pythonhosted.org/packages/fc/38/94afdf36fdf2b7ed8915423ca4911193530eebe64e1aec9e0c3fb6c35cd8/seafoam-2.9.2.tar.gz",
    "platform": "any",
    "description": "=======\r\nSeafoam\r\n=======\r\n\r\n.. image:: https://raw.githubusercontent.com/MinchinWeb/seafoam/master/docs/seafoam-logo-4x.png\r\n    :align: center\r\n    :alt: Seafoam Logo\r\n\r\n``Seafoam`` is a theme for `Pelican <http://docs.getpelican.com/>`_,\r\na static site generator written in Python.\r\n\r\n.. image:: https://img.shields.io/pypi/v/seafoam.svg?style=flat\r\n    :target: https://pypi.python.org/pypi/seafoam/\r\n    :alt: PyPI version number\r\n\r\n.. image:: https://img.shields.io/badge/-Changelog-success\r\n   :target: https://github.com/MinchinWeb/seafoam/blob/master/docs/changelog.rst\r\n   :alt: Changelog\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/seafoam?style=flat\r\n    :target: https://pypi.python.org/pypi/seafoam/\r\n    :alt: Supported Python version\r\n\r\n.. image:: https://img.shields.io/pypi/l/seafoam.svg?style=flat&color=green\r\n    :target: https://github.com/MinchinWeb/seafoam/blob/master/LICENSE.txt\r\n    :alt: License\r\n\r\n.. image:: https://img.shields.io/pypi/dm/seafoam.svg?style=flat\r\n    :target: https://pypi.python.org/pypi/seafoam/\r\n    :alt: Download Count\r\n\r\n\r\nThe ``seafoam`` theme is based on Bootstrap 3, and was first used at\r\n`Minchin.ca <http://minchin.ca>`_. \r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/front_page.png\r\n    :align: center\r\n    :alt: Front Page\r\n\r\n\r\nInstallation\r\n------------\r\n\r\nThe easiest way to install the ``seafoam`` theme is through the use\r\nof pip. This will also install the required dependencies automatically.\r\n\r\n.. code-block:: sh\r\n\r\n  pip install seafoam\r\n\r\nAlternatively, you can force the installation of ``lxml``, which is a HTML\r\nparser that is often faster than the default, and will be used if installed:\r\n\r\n.. code-block:: sh\r\n\r\n  pip install seafoam[lxml]\r\n\r\nIf you are using Pelican v4.5 or newer and only namespace plugins, ``seafoam``\r\nis set up as a namespace plugin and will automatically activate and configure\r\nitself.\r\n\r\nIf you are using a version of Pelican older that v4.5 or non-namespace plugins,\r\nyou will need to add ``seafoam`` to your list of plugins:\r\n\r\n.. code-block:: python\r\n\r\n  # pelicanconf.py\r\n\r\n  PLUGINS = [\r\n      \"pelican.plugins.seafoam\",\r\n      # others, as desired...\r\n  ]\r\n\r\n  # the rest of the your configuration file...\r\n\r\n\r\nYou may also need to configure the theme through the use of additional settings\r\n(see below).\r\n\r\n\r\nRequirements\r\n------------\r\n\r\n``Seafoam`` requires Pelican, the ``image_process`` plugin, the\r\n``jinja filters`` plugin, ``beautifulsoup4``, and ``semantic_version``. If the\r\ntheme is installed from pip, these should be automatically installed. If\r\nneeded, they can be manually installed with pip:\r\n\r\n.. code-block:: sh\r\n\r\n   pip install pelican\r\n   pip install pelican-image-process\r\n   pip install pelican-jinja-filters\r\n   pip install beautifulsoup4\r\n   pip install semantic_version\r\n\r\n\r\nSupported Plugins\r\n-----------------\r\n\r\nSeafoam also works with several other plugins for Pelican, but none of those\r\nlisted in this section are required.\r\n\r\n- `microblogging <https://blog.minchin.ca/label/microblogging-pelican/>`_ --\r\n  adds the ability to have \"microposts\", and tweaks the formatting of the theme\r\n  based on their (assumed) shorter length.\r\n- `readtime <https://pypi.python.org/pypi/pelican-readtime>`_ -- provides\r\n  estimated reading time for articles. Available from PyPI as\r\n  ``pelican-readtime``.\r\n- `post-stats\r\n  <https://github.com/getpelican/pelican-plugins/tree/master/post_stats>`_ --\r\n  provides estimated reading time for articles if ``readtime`` is not available.\r\n  Available in the `Pelican Plugins collection\r\n  <https://github.com/getpelican/pelican-plugins/>`_.\r\n- `neighbors <https://pypi.python.org/pypi/pelican-neighbors>`_ -- provides\r\n  post-article links to the next and previous article on your blog and the\r\n  next and previous article in that category. Available on PyPI as\r\n  ``pelican-neighours``.\r\n- `static-comments <https://blog.minchin.ca/label/static-comments/>`_ (or the\r\n  older `pelican_comment_system\r\n  <https://bernhard.scheirle.de/posts/2014/March/29/static-comments-via-email/>`_)\r\n  -- add static comments to your blog. Available on PyPI as\r\n  ``minchin.pelican.plugins.static-comments``.\r\n- `Related Posts\r\n  <https://github.com/getpelican/pelican-plugins/tree/master/related_posts>`_ --\r\n  adds the ``related_posts`` variable to the article's context.\r\n- Tipue Search\r\n\r\n\r\nAdditional Images\r\n-----------------\r\n\r\nArticle with header image\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/article_with_header.png\r\n    :align: center\r\n    :alt: Article with Header Image\r\n\r\nMain article body\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/article_body.png\r\n    :align: center\r\n    :alt: Article Body\r\n    \r\nComments\r\n    \r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/comments.png\r\n    :align: center\r\n    :alt: Comments\r\n\r\nComment Form\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/comment_form.png\r\n    :align: center\r\n    :alt: Comment Form\r\n\r\nMain Archives\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives.png\r\n    :align: center\r\n    :alt: Main Archives\r\n\r\nYearly Archives\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives-year.png\r\n    :align: center\r\n    :alt: Yearly Archives\r\n\r\nMonthly Archives\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/archives-month.png\r\n    :align: center\r\n    :alt: Monthly Archives\r\n\r\n404 Error Page\r\n\r\n.. image:: https://github.com/MinchinWeb/seafoam/raw/master/docs/screenshots/2.6.0/404.png\r\n    :align: center\r\n    :alt: 404 Error\r\n\r\n.. add microblog post image\r\n\r\n.. add Strathcona theme image\r\n\r\n\r\nAdditional Settings\r\n-------------------\r\n\r\nThese settings can be set in your ``pelicanconf.py`` file (your Pelican settings\r\nfile) to alter the behavior of the theme.\r\n\r\nIf a value is given below, this represents the effective default value. If no\r\nvalue is given, the effective default value is ``None``.\r\n\r\nIf you are using this theme on a sub-site (i.e a directory of the \"main site\"),\r\nlook at ``MENUITEMS_2``, ``MENUITEMS_2_AT``, and ``MENUITEMS_2_AT_LINK``\r\nsettings.\r\n\r\nIf you are using this theme on a subdomain, look at the ``SITE_ROOT_URL``\r\nsetting.\r\n\r\nIf you want to disable *Image Process* for local development, see\r\n``SEAFOAM_DEV_MODE``.\r\n\r\nSeafoam also auto-configures itself when possible.  If you need to manually\r\ncreate the default configuration, you would need the following:\r\n\r\n.. code-block:: python\r\n\r\n  # pelicanconf.py\r\n\r\n  from pelican.plugins import seafoam\r\n\r\n  THEME = seafoam.get_path()\r\n  BOOTSTRAP_THEME = \"seafoam\"\r\n\r\n  # if PLUGINS is not defined on Pelican 4.5+, these plugins will autoload\r\n  PLUGINS = [\r\n      \"pelican.plugins.seafoam\",\r\n      \"pelican.plugins.jinja_filters\",\r\n      \"pelican.plugins.image_process\",\r\n      # others, as desired...\r\n  ]\r\n\r\n  IMAGE_PROCESS = {\r\n    \"article-feature\": [\"scale_in 848 848 True\"],\r\n    \"index-feature\": [\"scale_in 263 263 True\"],\r\n  }\r\n\r\n  # Generate 404 error page\r\n  TEMPLATE_PAGES = {\r\n      \"404.html\": \"404.htm\"',\r\n  }\r\n\r\n  # the rest of the your configuration file...\r\n\r\nThis documentation has to be manually updated. If the settings no longer match\r\nthe theme's behavior, or a setting is missing from here, please open a ticket\r\non `GitHub <https://github.com/MinchinWeb/seafoam/issues>`_.\r\n\r\n.. use the \".. data::\" directive here for Sphinx output, but on GitHub, that just causes everything to disappear\r\n\r\nABOUT_ME\r\n  You can show a short blurb of text about yourself and a picture. This setting\r\n  is the paragraph. Raw HTML is accepted. See the ``AVATAR`` setting to set the\r\n  picture.\r\nADAM\r\n  These ADAM settings were originally set up to support my genealogy sub-site\r\n  (the original name of the the pre-processor I was using as called \"Adam\"). If\r\n  this is set to ``False``, the rest of the ``ADAM_*`` settings won't be active.\r\n  These settings are probably generic enough that you could use these for any\r\n  generator or outside program used to help generate your site.\r\nADAM_COPY_DATE\r\n  Override the copyright date in the footer. (Provide a string).\r\nADAM_FOOTER\r\n  An extra \"page footer\" to apply to all pages. (Provide an HTML string.)\r\nADAM_LINK\r\n  Link target for the Adam version text.\r\nADAM_UPDATED\r\n  Override the updated date.\r\nADAM_VERSION\r\n  Reported name and version of \"Adam\". \r\nADDTHIS_PROFILE\r\n  You can enable sharing buttons through `AddThis <http://www.addthis.com/>`_\r\n  by this setting to your AddThis profile-id. This will display a Tweet,\r\n  Facebook Like and Google +1 button under each post.\r\nARCHIVES_URL\r\n  Same as the regular Pelican setting.\r\nASSET_CSS\r\n  Set to ``True`` if you want the ``asset`` plugin to compile your CSS.\r\nASSET_JS\r\n  Set to ``True`` if you want the ``asset`` plugin to compile your Javascript.\r\nAUTHOR\r\n  Who to list as the copyright belonging to in the site footer.\r\nAUTHORS_URL\r\n  Same as the regular Pelican setting.\r\nAVATAR\r\n  You can show a short blurb of text about yourself and a picture. This setting\r\n  is the path to the picture. See the ``ABOUT_ME`` setting to set the\r\n  descriptive paragraph.\r\nBOOTSTRAP_NAVBAR_INVERSE = False\r\n  Apply inverse CSS setting to Navbar. Changing this will swap the top\r\n  navigation bar between light and dark.\r\nBOOTSTRAP_THEME = \"seafoam\"\r\n  Use this to set the \"colour scheme\" of the framework. Valid values are\r\n  ``seafoam`` and ``strathcona``. ``seafoam`` teal on darker green;\r\n  ``strathcona`` is maroon on white. This is a Automatically set to ``seafoam``\r\n  by the internal plugin if unspecified. Other values (including leaving this\r\n  unset) are not expected to work correctly.\r\nCATEGORIES_URL\r\n  Same as the regular Pelican setting.\r\nCATEGORY_IMAGES = {}\r\n  Provide a default featured image by category. If an image is set in the\r\n  article metadata, that will override this.\r\n\r\n  Provide a dictionary where the key is the category name and the value is the\r\n  path of the image, relative to the SITEURL.\r\nCC_ATTR_MARKUP\r\n  Optionally, you can include attribution markup in the CC license mark by\r\n  setting this to ``True``.\r\nCC_LICENSE\r\n  Set a site-wide Creative Commons License by specify the \"short name\" of the\r\n  license (like ``CC_BY``, or ``CC-BY-NC-ND``). Alternately, use\r\n  ``CC_LICENSE_COMMERCIAL`` and ``CC_LICENSE_DERIVATIVES`` to \"build a\r\n  license\".\r\nCC_LICENSE_COMMERCIAL\r\n  \"yes\" if commercial use is permitted, \"no\" otherwise. Use this in lieu of\r\n  ``CC_LICENSE`` and in combination with ``CC_LICENSE_DERIVATIVES`` to \"build a\r\n  license\".\r\nCC_LICENSE_DERIVATIVES\r\n  \"yes\" is derivatives are permitted, \"no\" otherwise. Use this in lieu of\r\n  ``CC_LICENSE`` and in combination with ``CC_LICENSE_COMMERCIAL`` to \"build a\r\n  license\".\r\nCUSTOM_CSS\r\n  Link, relative to SITEURL, to a custom CSS file.\r\nCUSTOM_CSS_LIST = []\r\n  Custom CSS to load; can be either absolute links, or relative links. If the\r\n  listed item starts with ``//``, ``http://``, ``https://``, it is assumed to\r\n  be absolute link and added as-is to the markup. Otherwise, the link is\r\n  assumed to be relative to SITEURL.\r\nCUSTOM_JS_LIST = []\r\n  Custom Javascript to load; can be either scripts, absolute links, or relative\r\n  links. If the listed item starts with ``<script``, then the item is assumed\r\n  to be the contents of a script, including opening and closing tags, and so\r\n  added to the pages' markup directly. If the listed item starts with ``//``,\r\n  ``http://``, ``https://``, it is assumed to be absolute link and added as-is\r\n  to the markup. Otherwise, the link is assumed to be relative to SITEURL.\r\n\r\n  See also ``CUSTOM_JS_LIST_HEAD`` and ``JQUERY_JS_IN_HEAD``.\r\nCUSTOM_JS_LIST_HEAD = []\r\n  Exactly the same format as ``CUSTOM_JS_LIST``, but is added to the pages'\r\n  ``<head>`` section rather than the end of the page. Generally, you will want\r\n  to put your Javascript at the end of the page (i.e. in ``CUSTOM_JS_LIST``\r\n  rather than here), as any Javascript referenced here must generally be\r\n  completely loaded before the page will start being rendered.\r\n  \r\n  When ``JQUERY_JS_IN_HEAD == True`` (not the default), JQuery is listed before\r\n  the other scripts listed here.\r\n  \r\n  See also ``CUSTOM_JS_LIST`` and ``JQUERY_JS_IN_HEAD``.\r\nDEFAULT_LANG\r\n  .\r\nDISPLAY_ARCHIVES_ON_MENU = True\r\n  Include archives on the main site menu.\r\nDISPLAY_BREADCRUMBS = False\r\n  Display Breadcrumbs on site.\r\n\r\n  See also ``MENUITEMS_2_AT`` and ``MENUITEMS_2_AT_LINK`` settings.\r\nDISPLAY_CATEGORIES_ON_MENU\r\n  Include categories on the main site menu.\r\nDISPLAY_CATEGORIES_ON_SIDEBAR\r\n  Include a listing of categories on the sidebar (assuming the sidebar is\r\n  active; see ``HIDE_SIDEBAR`` setting)\r\nDISPLAY_PAGES_ON_MENU\r\n  Include a listing of pages on the sidebar (assuming the sidebar is active;\r\n  see ``HIDE_SIDEBAR`` setting)\r\nDISPLAY_RECENT_POSTS_ON_SIDEBAR\r\n  Include a listing of recent posts on the sidebar (assuming the sidebar is\r\n  active; see ``HIDE_SIDEBAR`` setting). Also see the ``RECENT_POST_COUNT``\r\n  setting.\r\nDISPLAY_TAGS_INLINE\r\n  .\r\nDISPLAY_TAGS_ON_SIDEBAR = True\r\n  Include a listing of tags on the sidebar (assuming the sidebar is active;\r\n  see ``HIDE_SIDEBAR`` setting)\r\nDISQUS_DISPLAY_COUNTS\r\n  Display the number of comments (assuming Disqus comments are active; see\r\n  ``DISQUS_SITENAME`` settings)\r\nDISQUS_ID_PREFIX_SLUG\r\n  Set this to ``True`` if you have configured your article URLs such that the\r\n  slug alone will likely not be unique. Ignored if ``DISQUS_NO_ID`` is ``True``.\r\nDISQUS_NO_ID\r\n  This theme sets identifiers for each article's comment threads. If you are\r\n  switching from a theme that doesn't (such as the Pelican built-in default)\r\n  this will result in existing comments getting lost. To prevent this, set\r\n  this setting to ``True``.\r\nDISQUS_SITENAME\r\n  Set to your Disqus sitename to activate Disqus comments on your site.\r\n\r\n  You can also enable Disqus comments for pages. This is a per-page setting you\r\n  can control by adding a field comments to you pages' metadata. Set it to\r\n  enabled to enable comments for that page. Comment-threads for pages will have\r\n  an id that is prefixed by ``page-``.\r\n\r\n  You will probably only use this or the Pelican Comment System; odd results\r\n  may come if you try to use both together. See the ``PELICAN_COMMENT_SYSTEM``\r\n  setting.\r\nDOCUTIL_CSS\r\n  If you're using reStructuredText for writing articles and pages, you can\r\n  include the extra CSS styles that are used by the docutils-generated HTML by\r\n  setting this to ``True``. This can be done as a global setting or setting it\r\n  in the metadata of a specific article or page.\r\nFAVICON\r\n  The location of your site's FavIcon, relative to the SITEURL.\r\nFEED_ALL_ATOM\r\n  Same as the regular Pelican setting. If set, a link to your Atom feed will\r\n  appear in the site's HTML header and as a link in the footer of the site.\r\nFEED_ALL_RSS\r\n  Same as the regular Pelican setting. If set, a link to your RSS feed will\r\n  appear in the site's HTML header.\r\nGITHUB_REPO_COUNT = 5\r\n  See ``GITHUB_USER`` setting.\r\nGITHUB_SHOW_USER_LINK\r\n  See ``GITHUB_USER`` setting.\r\nGITHUB_SKIP_FORK = False\r\n  See ``GITHUB_USER`` setting.\r\nGITHUB_USER\r\n  The theme can show your most recently active GitHub repos in the sidebar. To\r\n  enable, set this to you GitHub username. Appearance and behavior can be\r\n  controlled using the ``GITHUB_REPO_COUNT``, ``GITHUB_SKIP_FORK``, and \r\n  ``GITHUB_SHOW_USER_LINK`` variables.\r\nGOOGLE_ANALYTICS\r\n  Used to activate \"classic\" Google Analytics. Set this to your account's Google\r\n  Analytics ID. Although this setting doesn't conflict with\r\n  ``GOOGLE_ANALYTICS_UNIVERSAL``, you will in most cases only use one or the\r\n  other. This has been deprecated by Google; see ``GOOGLE_ANALYTICS_V4``.\r\nGOOGLE_ANALYTICS_UNIVERSAL\r\n  Used to activate \"universal\" Google Analytics (this is the new version). Set\r\n  this to your account's ID (a number). Also set\r\n  ``GOOGLE_ANALYTICS_UNIVERSAL_PROPERTY``. Although this setting doesn't\r\n  conflict with ``GOOGLE_ANALYTICS``, you will in most cases only use one or\r\n  the other. This has been deprecated by Google (in June 2023); see\r\n  ``GOOGLE_ANALYTICS_V4``.\r\nGOOGLE_ANALYTICS_UNIVERSAL_PROPERTY\r\n  Set this to the Google Analytics \"property\" this site represents. See also\r\n  (and set) ``GOOGLE_ANALYTICS_UNIVERSAL``.\r\nGOOGLE_ANALYTICS_V4\r\n  Set this to activate Google Analytics v4.\r\nHIDE_SIDEBAR = False\r\n  Hides the sidebar, and all it's contents. Also review the settings\r\n  ``DISPLAY_CATEGORIES_ON_SIDEBAR``, ``DISPLAY_RECENT_POSTS_ON_SIDEBAR``,\r\n  ``DISPLAY_TAGS_ON_SIDEBAR``, ``GITHUB_USER``, ``LINKS``, and\r\n  ``TWITTER_USERNAME``.\r\nHIDE_SITENAME = False\r\n  Hides the sitename in the site navbar.\r\nIMAGE_PROCESS = {\"article-feature\": [\"scale_in 848 848 True\"], \"index-feature\": [\"scale_in 263 263 True\"],}\r\n  Used by the *image process* plugin. The \"article-feature\" and \"index-feature\"\r\n  configurations are set by the included plugin if not set in your\r\n  configuration to something else.\r\nINDEX_COPY_DATE\r\n  Copyright date to display on the index page (homepage) of the site.\r\nJQUERY_JS_IN_HEAD = False\r\n  Bootstrap depends on JQuery. Typically, good practice is to load all your\r\n  Javascript from the end of your page. However, in certain cases, I've needed\r\n  to load JQuery sooner. So this moves loading JQuery from the end of the page\r\n  to the header. When active, JQuery is listed before the other scripts in\r\n  ``CUSTOM_JS_LIST_HEAD``. See also ``CUSTOM_JS_LIST_HEAD``.\r\nLINKS = []\r\n  Extra links to display sidebar. Provide a list of tuples of the form\r\n  ``('name', 'link')``.\r\nMENUITEMS\r\n  Extra items to add to the menu. Provide a list of tuples of the form\r\n  ``(title, link, icon)``. ``link`` is absolute, so build them using SITEURL, \r\n  if needed. ``icon`` here is of the form of the CSS classes to be used; e.g.\r\n  ``'fa fa-fw fa-pencil'``. ``icon`` can be set to ``None``.\r\n\r\n  If this is set, the working assumption is that the site you are generating is\r\n  a \"sub-site\".\r\nMENUITEMS_2\r\n  Extra items you want added as a sub-menu. Use in conjunction with the\r\n  ``MENUITEMS_2_AT`` setting. Provide a list of tuples of the form\r\n  ``(title, link, icon)``. ``link`` is absolute, so build them using SITEURL, \r\n  if needed. ``icon`` here is of the form of the CSS classes to be used; e.g.\r\n  ``'fa fa-fw fa-pencil'``. ``icon`` can be set to ``None``.\r\n\r\n  This setting is working on the assumption that your generated site in going\r\n  into a subdirectory of your \"main\" site.\r\nMENUITEMS_2_AT\r\n  If ``MENUITEMS_2`` is set, under which (main) menu item are these to be\r\n  displayed. This should match a \"name\" of one of the items on ``MENUITEMS``;\r\n  if no match is found, these sub-menu items will not be displayed.\r\n\r\n  When set and Breadcrumbs are enabled, all items on the site are shown to be\r\n  under both \"home\" (linked to at the ``SITE_ROOT_URL``) and ``MENUITEMS_2_AT``\r\n  (linked to at ``MENUITEMS_2_AT_LINK``).\r\nMENUITEMS_2_AT_LINK\r\n  When set and Breadcrumbs are enabled, all items on the site are shown to be\r\n  under both \"home\" (linked to at the ``SITE_ROOT_URL``) and ``MENUITEMS_2_AT``\r\n  (linked to at ``MENUITEMS_2_AT_LINK``).\r\nMICROBLOG_DEV_URL\r\n  The project url for the microblogging plugin. Provided by the plugin, when in\r\n  use.\r\nMICROBLOG_VERSION\r\n  The version of the microblogging plugin. Provided by the plugin, when in use.\r\nNAVBAR_ON_TOP = False\r\n  If True, the navigation menu is on top. If False, the navigation menu is\r\n  vertical on the left side of the page. Default is False.\r\nNEIGHBORS\r\n  Activates the links to the next and previous articles, both in the \"all\r\n  posts\" index and the category-specific index. Requires the\r\n  `neighbors <https://pypi.python.org/pypi/pelican-neighbors>`_ to be both\r\n  installed and activated (i.e. listed under ``PLUGINS``).\r\nOPEN_GRAPH_FB_APP_ID\r\n  You can use this setting to provide a Facebook *app id*. See the\r\n  ``USE_OPEN_GRAPH`` setting.\r\nOPEN_GRAPH_IMAGE\r\n  A default image to use with Open Graph. This is a filepath relative to your\r\n  SITEURL. See the ``USE_OPEN_GRAPH`` setting.\r\nPAGINATOR_LIMIT = 8\r\n  Number of page number links to appear of the main \"index\" page of your\r\n  blog. The default of 8 results in showing a link to page 1, links the\r\n  three previous pages (8 divided by 2 and rounded down), a number\r\n  representing the current page, links to the next three pages, and a link\r\n  to the last page.\r\nPDF_PROCESSOR\r\n  .\r\nPELICAN_COMMENT_SYSTEM = False\r\n  Set this to ``True`` to active the\r\n  `pelican_comment_system <https://bernhard.scheirle.de/posts/2014/March/29/static-comments-via-email/>`_.\r\n\r\n  The Pelican Comment System has\r\n  `further settings <https://github.com/Scheirle/pelican_comment_system/blob/master/doc/installation.md>`_\r\n  that are not used directly by the theme.\r\n\r\n  You will probably only use this or Disqus; odd results may come if you try to\r\n  use both together. See also the ``DISQUS_SITENAME`` setting.\r\nPELICAN_COMMENT_SYSTEM_DISPLAY_COUNTS = True\r\n  Whether to display the number of comments\r\nPELICAN_COMMENT_SYSTEM_EMAIL_DOMAIN\r\n  The domain name of the email where you want the comments to be emailed to\r\n  (i.e. the part after the ``@`` sign). See the\r\n  ``PELICAN_COMMENT_SYSTEM_EMAIL_USER`` and ``PELICAN_COMMENT_SYSTEM``\r\n  settings.\r\nPELICAN_COMMENT_SYSTEM_EMAIL_USER\r\n  The username of the email where you want the comments to be emailed to (i.e.\r\n  the part before the ``@`` sign). See the\r\n  ``PELICAN_COMMENT_SYSTEM_EMAIL_DOMAIN`` and ``PELICAN_COMMENT_SYSTEM``\r\n  setting.\r\nPELICAN_COMMENT_SYSTEM_FEED, PELICAN_COMMENT_SYSTEM_FEED_ALL\r\n  Used internally to generate links to the Comment RSS/Atoms feeds.\r\nPELICAN_COMMENT_SYSTEM_IDENTICON_SIZE = 72\r\n  The size of the Identicons generated by the Pelican Comment System.\r\nPIWIK_SITE_ID\r\n  Used for Piwik site analytics.\r\nPIWIK_SSL_URL = PIWIK_URL\r\n  Used for Piwik site analytics.\r\nPIWIK_URL\r\n  Used for Piwik site analytics.\r\nPLUGINS\r\n  Same as the regular Pelican setting. If you set this, be sure to include the\r\n  internal plugin ``pelican.plugins.seafoam`` to get the theme to\r\n  auto-configure itself.\r\nPRJCT\r\n  Set to ``TRUE`` to active `prjct <https://github.com/MinchinWeb/prjct>`_\r\n  support. Recommended segment to include in your ``pelicanconf.py``:\r\n\r\n  .. code-block:: python\r\n\r\n    # pelicanconf.py\r\n\r\n    import prjct\r\n\r\n    PRJCT = True\r\n    PRJCT_TODO, PRJCT_DONE = prjct.todo_export.to_html_dicts()\r\n    PRJCT_PROJECTS = prjct.multi_source.project_list()\r\n    PRJCT_ACTIVE_PROJECTS = prjct.multi_source.active_project_list()\r\n    PRJCT_SOMEDAY_PROJECTS = prjct.config.someday_projects()\r\n    PRJCT_COMPLETED_PROJECTS = prjct.config.completed_projects()\r\n    PRJCT_DESC = prjct.descriptions.to_html_dict(\r\n        markdown_extension_config=MARKDOWN['extension_configs']\r\n    )\r\n    PRJCT_VERSION = prjct.__version__\r\n    PRJCT_FOOTER_URL = prjct.__url__\r\n\r\n  Also add prjct to our direct templates list.\r\nPRJCT_ACTIVE_PROJECTS\r\n  A list of *active* projects. Used to sort projects on the main prjct page.\r\n  See the ``PRJCT`` setting.\r\nPRJCT_COMPLETED_PROJECTS\r\n  A list of *active* projects. Used to sort projects on the main prjct page.\r\n  See the ``PRJCT`` setting.\r\nPRJCT_DESC\r\n  A dictionary of descriptions for each project, where the key is the name of\r\n  the project, and will match the *tag* page where the output appears. The\r\n  return value is assumed to be a valid HTML segment. See the ``PRJCT``\r\n  setting.\r\nPRJCT_DONE\r\n  A dictionary of done to-do items for each project, where the key is the name\r\n  of the project, and will match the *tag* page where the output appears. The\r\n  return value is assumed to be a valid HTML segment. See the ``PRJCT``\r\n  setting.\r\nPRJCT_FOOTER_URL = 'https://github.com/MinchinWeb/prjct'\r\n  *prjct* URL used for link displayed in footer. See the ``PRJCT`` setting.\r\nPRJCT_SOMEDAY_PROJECTS\r\n  A list of *active* projects. Used to sort projects on the main prjct page.\r\n  See the ``PRJCT`` setting.\r\nPRJCT_TODO\r\n  A dictionary of open to-do items for each project, where the key is the name\r\n  of the project, and will match the *tag* page where the output appears. The\r\n  return value is assumed to be a valid HTML segment. See the ``PRJCT``\r\n  setting.\r\nPRJCT_VERSION = ''\r\n  *prjct* version displayed in footer. See the ``PRJCT`` setting.\r\nPYGMENTS_STYLE = 'native'\r\n  This setting is currently ignored, and my preferred Pygments style is\r\n  included directly into the Seafoam CSS.\r\nRECENT_POST_COUNT = 5\r\n  Number of recent posts to display on the sidebar. See the\r\n  ``DISPLAY_RECENT_POSTS_ON_SIDEBAR`` setting.\r\nRELATED_POSTS_TEXT = 'Related Posts:'\r\n  Header for related posts listing. Requires that the\r\n  `Related Posts Plugin <https://github.com/getpelican/pelican-plugins/tree/master/related_posts>`_\r\n  be active.\r\nSEAFOAM_DEV_MODE = False\r\n  Enable this to speed local development by (effectively) disabling the *Image\r\n  Process* plugin. If you disable this in your ``pelicanconf.py``, you'll\r\n  likely want to activate it in your ``publishconf.py`` file.\r\nSEAFOAM_ENCODING = \"uft-8\"\r\n  The encoding that Beautiful Soup uses when run by the internal plugin.\r\nSEAFOAM_PARSER = \"html.parser\"\r\n  Will be set to \"lxml\" is it is installed (which is the case with the most\r\n  recent versions of the required ``image-process`` plugin).\r\n\r\n  This is the parser that Beautiful Soup uses when run by the internal plugin.\r\nSEAFOAM_URL = \"http://blog.minchin.ca/label/seafoam/\"\r\n  The project url of the theme (automatically provided by the bundled plugin).\r\nSEAFOAM_VERSION = pelican.plugins.seafoam.__version__\r\n  The version of the theme (automatically provided by the bundled plugin).\r\nSITELOGO\r\n  Link to the site logo (displayed in the navbar). This is relative to the\r\n  SITEURL.\r\nSITELOGO_SIZE\r\n  The width of the site logo in the navbar. Can be set to any valid CSS value\r\n  (i.e. %, em, px, etc). I have had good luck setting this to ``100%``.\r\nSITENAME\r\n  The name of your site, displayed in the navbar.\r\nSITEURL\r\n  Same as the Pelican setting. Set this to where this Pelican site is actually\r\n  hosted. Also see the ``SITE_ROOT_URL`` setting.\r\nSITE_ROOT_URL = SITEURL\r\n  Use this if you're hosting a subsite of some sort. This is where the links in\r\n  logo in the navbar and the home icon in the breadcrumbs will point to. See\r\n  also the ``MENUITEMS_2_AT`` setting.\r\nSOCIAL\r\n  A list of your social media sites to be listed in the sidebar. Should be a\r\n  list of tuples in the form ('social network name', 'full link to profile').\r\n  The theme will display the logo of the network. See the ``HIDE_SIDEBAR``\r\n  setting.\r\nTAGS_TEXT = \"Tags\"\r\n  Text used as the header to \"Tags\" (articles can be filed under multiple tags,\r\n  but assumes to be under a single (or no) category. Assumed to be plural.\r\nTAGS_URL\r\n  Same as the Pelican setting.\r\nTEMPLATE_PAGES = {\"404.html\": \"404.html\",}\r\n  Same as the Pelican setting. Automatically set by the internal plugin to\r\n  enable a 404 error page on GitHub pages (and perhaps elsewhere).\r\nTHEME = pelican.plugins.seafoam.get_path()\r\n  Same as the Pelican setting. Automatically set by the internal plugin.\r\nTHEME_STATIC_DIR\r\n  Same as the Pelican setting.\r\nTWITTER_USERNAME\r\n  You can optionally provide a this which will be used to set the Twitter\r\n  username for the site and for the content creator.\r\nTWITTER_WIDGET_ID\r\n  The theme can show your twitter timeline in the sidebar. To enable, provide a\r\n  ``TWITTER_USERNAME`` and a ``TWITTER_WIDGET_ID``.\r\n\r\n  To get a ``TWITTER_WIDGET_ID``, go to:\r\n  `https://twitter.com/settings/widgets <https://twitter.com/settings/widgets>`_\r\n  and select *Create new*. You'll find the ``TWITTER_WIDGET_ID`` under the html\r\n  or in the site url:\r\n\r\n  https://twitter.com/settings/widgets/TWITTER_WIDGET_ID/edit\r\nTYPOGRIFY\r\n  Whether to activate Typography. Tyopgraphy is a library that automatically\r\n  adds a number of typographical flourishes. The necessary CSS is automatically\r\n  included in the *seafoam* CSS.\r\n\r\n  The Typography Python library will needs to be installed, which is\r\n  installable via pip: ``pip install typogrify``\r\n\r\n  Note that with Pelican 3.6, activating both the Pelican Comment System and\r\n  Typography at the same time cause issues. This issue was fixed in Pelican\r\n  3.7.\r\nUSE_OPEN_GRAPH = True\r\n  In order to make the Facebook \"like\" button and other social sharing options\r\n  work better, the template contains Open Graph metatags like\r\n  ``<meta property=\"og:type\" content=\"article\"/>``. You can disable them by\r\n  setting this to ``False``.\r\n\r\n  See also ``OPEN_GRAPH_FB_APP_ID``, and ``OPEN_GRAPH_FB_APP_ID``\r\n  settings.\r\n\r\nIt may also be helpful to review the\r\n`settings for Pelican itself <http://docs.getpelican.com/en/3.7.1/settings.html>`_.\r\n\r\nOn articles, the theme also looks for the ``image`` metadata setting to provide\r\nthe \"featured image* for the article.\r\n\r\n\r\nKnown Issues\r\n------------\r\n\r\n- activating both Typogrify and the Pelican Comment System on Pelican 3.6\r\n  causes issues. This issue has been fixed in Pelican 3.7.\r\n\r\nCredits\r\n-------\r\n\r\nOriginal theme developed by `Daan Debie <http://dandydev.net/>`_.\r\n\r\nThe idea that a theme could be installed as a Python package by `Jeff\r\nForcier <http://bitprophet.org/>`_'s `Alabaster theme\r\n<https://github.com/bitprophet/alabaster>`_ for Sphinx.\r\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Pelican theme, first used for Minchin.ca.",
    "version": "2.9.2",
    "project_urls": {
        "Bug Tracker": "https://github.com/MinchinWeb/seafoam/issues",
        "Changelog": "https://github.com/MinchinWeb/seafoam/blob/master/docs/changelog.rst",
        "Homepage": "http://blog.minchin.ca/label/seafoam/"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fc3894afdf36fdf2b7ed8915423ca4911193530eebe64e1aec9e0c3fb6c35cd8",
                "md5": "e977d3fe0978b8e453d0100b9f478fa1",
                "sha256": "103d295b52ee5a5b63af9a34c1b67bc834aad21611b2de496bab8f33e2adc90f"
            },
            "downloads": -1,
            "filename": "seafoam-2.9.2.tar.gz",
            "has_sig": false,
            "md5_digest": "e977d3fe0978b8e453d0100b9f478fa1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 2143508,
            "upload_time": "2024-03-05T04:59:11",
            "upload_time_iso_8601": "2024-03-05T04:59:11.382622Z",
            "url": "https://files.pythonhosted.org/packages/fc/38/94afdf36fdf2b7ed8915423ca4911193530eebe64e1aec9e0c3fb6c35cd8/seafoam-2.9.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-05 04:59:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MinchinWeb",
    "github_project": "seafoam",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "seafoam"
}
        
Elapsed time: 0.20952s