pelican-bootstrap4-nero

Pelican-bootstrap4-nero is forked from pelican-bootstrap3 and pelican-bootstrap3-nero(v2.0.2) and customized. It is a dark theme. This theme is not aimed to be a complete pelican-bootstrap3 rewrite to support Bootstrap 4. You are welcome to clone it or reference it create a generic pelican-bootstrap4 theme.

My previous theme is called pelican-bootstrap3-nero. I created this theme so that I may use Bootstrap 4.

Use it at your own risk.

Demo site

Currently I don't have a demo site for this theme. It is becaused I moved to a new theme: pelican-kappa-nero

Screenshot

Usage

• Known problems

  • DISABLE_SIDEBAR_TITLE_ICONS may not be working because of code changes

• This theme uses Bootstrap 4.But the codes was copied from old theme, which uses Bootstrap 3. So some parts of the theme may not work.

  • DISPLAY_BREADCRUMBS is not working. Related code was not migrated to Bootstrap 4.

• Options that must be set in pelicanconf.py:

  • BOOTSTRAP_THEME = 'slate'
  • PLUGINS = ['i18n_subsites'] (required since pelican-bootstrap3)
  • JINJA_ENVIRONMENT = {'extensions': ['jinja2.ext.i18n']}

• We have new settings specific to this theme, also check CHANGELOG.rst

• Setup Cookie Consent 2

  • COOKIE_CONSENT2 = True
  • Set your URL to privacy policy with COOKIE_CONSENT2_PRIVACY_URL

• Setup your account id from IntenseDebate

  • INTENSEDEBATE_ACCOUNT = 'Your account id from IntenseDebate'

• Enable Google Analytics only if Cookie Consent 2 was consented and accepted

  • GOOGLE_ANALYTICS_UNIVERSAL_CHECK_CONSENT = True
  • Also need to configure parameters according to your setting
  • GOOGLE_ANALYTICS_UNIVERSAL = 'UA-XXXXXX-Y'
  • GOOGLE_ANALYTICS_UNIVERSAL_PROPERTY = 'auto'

• Options for sidebar bottom

  • OPTIONAL_SIDEBAR_BOTTOM = True
  • OPTIONAL_SIDEBAR_BOTTOM_TITLE = 'Disclaimer'
  • OPTIONAL_SIDEBAR_BOTTOM_ID= 'disclaimer'
  • OPTIONAL_SIDEBAR_BOTTOM_TEXT = 'Replace by your text for disclaimer'

• Display at bottom of articles. If you have ad-block software it may not be displayed Enable it in pelicanconf.py, TWITTER_CUSTOM = True

• JSON-LD

  • JSON_LD = True
  • Based on existing work from Flex. Thanks to Alexandre
  • Based on existing work from Emoji-gen. Thanks to Emoj-Gen and Pine.
  • For base / includes/json_ld.html;
  • If enabled, there would be JSON-LD blocks for
  • Type Blog for all html
  • Type Articles for all articles

• JSON-LD, article image and publisher logo are required by Google schema checking

  • SITE_LOGO = 'images/your-image.jpg'
  • PUBLISHER_LOGO = 'images/your-image.jpg'

• JSON_LD_BREADCRUMBLIST = True

  • If both JSON_LD is also enabled:
  • Add type BreadcrumbList for all html
  • Note: there is an option DISPLAY_BREADCRUMBS and have visible breadcrumbs and actually added some schema for breadcrumbs. Google search engine would take the value from that. I do not know clearly what is performed by search engine if both Breadcrumb support is enabled in both JSON-LD BREADCRUME and DISPLAY_BREADCRUMS are enabled.

• Copy button on the top right corner of all "div.highlight pre" elements

  • SPHINX_COPYBUTTON = True
  • Adopted from sphinx copybutton
  • Credits for the copy button goes to Chris Holdgraf

• Added option OTHER_PAGE_METATAG_DESCRIPTION

  • It is for html file that are not page or article
  • That would a meta tag description to the head section