kenmercuslai / bt3-flat

A Bootstrap3 flat theme for pelican

BT3-Flat

For some reasons, I won't update this theme for a long time except for bug fix. And I'll try to rewrite it in AngularJS in next commit

BT3-Flat is a one of the best theme built on bootstrap 3 for Pelican 3.5.0.

demo

BT3-Flat configuration

• ARCHIVE_LIST Changes the right hand article listing from a tree representation to a list representation.
• ARTICLES_HOME_PAGE Switches the \ (index) page from the 'about me' page to the list of articles.

the following part is my config file:

#!/usr/bin/env python
# -*- coding: utf-8 -*- #
from __future__ import unicode_literals

AUTHOR = u'Ken Lai'
SITENAME = u'Network Tsukkomi'
SITEURL = ''

TIMEZONE = 'Asia/Hong_Kong'

DEFAULT_LANG = u'en'

# Do not publish articles set in the future
WITH_FUTURE_DATES = False
TEMPLATE_PAGES = {'blog.html': 'blog.html'}
STATIC_PATHS = ['images', 'extra/CNAME']
EXTRA_PATH_METADATA = {'extra/CNAME': {'path': 'CNAME'}}

# Feed generation is usually not desired when developing
FEED_RSS = 'feed/index.html'
FEED_ATOM = 'feed/atom/index.html'
FEED_ALL_RSS = False
FEED_ALL_ATOM = False
TRANSLATION_FEED_RSS = False
TRANSLATION_FEED_ATOM = False

# Blogroll
LINKS = (('Ken M. Lai\'s Note', 'http://kenmlai.blogspot.com'),
         ('Martian Z', 'http://blog.martianz.cn/'))

# Social widget
SOCIAL = (('google-plus', 'https://plus.google.com/+KenLaimercus'),
          ('linkedin', 'http://www.linkedin.com/in/kenmercuslai'),
          ('githuB', 'https://github.com/KenMercusLai'),
          ('envelope', 'mailto:[email protected]')
          )


DEFAULT_PAGINATION = True
PAGINATED_DIRECT_TEMPLATES = ('blog-index',)
DIRECT_TEMPLATES = ('categories', 'index', 'blog-index', 'blog')

POST_LIMIT = 3

# PAGINATION = False

# Uncomment following line if you want document-relative URLs when developing
#RELATIVE_URLS = True

# Formatting for dates

DEFAULT_DATE_FORMAT = ('%d/%b/%Y %a')

# Formatting for urls

ARTICLE_URL = "{date:%Y}/{date:%m}/{slug}/"
ARTICLE_SAVE_AS = "{date:%Y}/{date:%m}/{slug}/index.html"

# Plugins

PLUGIN_PATH = 'plugins'
PLUGINS = ['sitemap', 'neighbors', 'related_posts']


# Specify theme

# THEME = "theme/BT3-Flat"
THEME = "/Users/KenMercusLai/Documents/Projects/BT3-Flat"
# GOOGLE_SEARCH = '013542728820335073314:dcpel18vrey'
SWIFTYPE = ''
SITE_THUMBNAIL = 'https://dl.dropboxusercontent.com/u/299446/logo.png'
SITE_THUMBNAIL_TEXT = 'Network Tsukkomi'
SITESUBTITLE = 'Not only about network'

DISQUS_SITENAME = 'networktsukkomime'
GOOGLE_ANALYTICS = ''
GOOGLE_ANALYTICS_DOMAIN = 'networktsukkomi.me'

### Plugin-specific settings

RELATED_POSTS_MAX = 20

# TODO: align default SITEMAP config to http://wordpress.org/extend/plugins/google-sitemap-generator/stats/
SITEMAP = {
    'format': 'xml',
    'priorities': {
        'articles': 0.5,
        'indexes': 0.5,
        'pages': 0.5
    },
    'changefreqs': {
        'articles': 'monthly',
        'indexes': 'daily',
        'pages': 'monthly'
    }
}


#===theme settings===========================

FAVICON = 'https://dl.dropboxusercontent.com/u/299446/logo.png'
ICON = 'https://dl.dropboxusercontent.com/u/299446/logo.png'
SHORTCUT_ICON = 'https://dl.dropboxusercontent.com/u/299446/logo.png'
HEADER_IMAGE = 'https://dl.dropboxusercontent.com/u/299446/logo-invert.png'
BACKGROUND_IMAGE = 'http://images.nationalgeographic.com/wpf/media-live/photos/000/763/cache/egret-fog-reflection_76312_990x742.jpg'
# COPYRIGHT = '2015 © All Rights Reserved.'
# Google fonts can be downloaded with
# https://neverpanic.de/downloads/code/2014-03-19-downloading-google-web-fonts-for-local-hosting-fetch.sh'
# Maybe you need to add missing mime types to your webserver configuration
# USER_FONT = '/theme/fonts/font.css'
# USER_BOOTSTRAP = '//maxcdn.bootstrapcdn.com/bootstrap/3.3.4'
# USER_FONTAWESOME = '//maxcdn.bootstrapcdn.com/font-awesome/4.3.0'
# USER_JQUERY = '//code.jquery.com/jquery-1.11.2.min.js'

# About ME
PERSONAL_PHOTO = "https://dl.dropboxusercontent.com/u/299446/thumb-400x400.png"
PERSONAL_INFO = """My name is Ken Lai, a network engineer who is working & living in Shenzhen, China. I've spent about 10 years in network industry from doing operational routines at first, to work as a tech consultant with my sales partner in one of the greatest company in this world. I also do program work a lot as a personal hobby in my part-time. I learnt variety of languages, like C, C++, ASM, Object-Pascal since 6th grade in elementary school. But Python has been my favorite since I knew it for the first time in 2006. Also, English is my second language while my mother tongue is Madrin. I can speak some Japanese, and now is  preparing for the official Japanese certification."""

# work
WORK_DESCRIPTION = ''
# items to descripe a work, "type", "cover-image link", "title", "descption", "link"
WORK_LIST = (('link', 'https://dl.dropboxusercontent.com/u/299446/BT3-Flat.png', 'BT3-Flat', 'A BT3 flat theme for pelican', 'https://github.com/KenMercusLai/plumage'),)

bt3-flat's Issues

CRITICAL: 'articles_page' is undefined

Having the same issue as noted in Issue 1 with a brand-new checkout and using your configuration (only having modified the plugin path and the path to your theme). Any direction on where I might look? This is on Pelican 3.5.0.

Failed to generate blog.html

Your theme is awesome, thanks for sharing it.

However I failed to generate the blog.html. It doesn't exist in the output directory. index2.html index3.html ... exist and I think they should not.

Maybe I need to setup something in my pelicanconf.py but I am not sure which variables I need to set.

I tried to add 'blog' to DIRECT_TEMPLATES, then I got "CRITICAL: slice indices must be integers or None or have an index method".

May I use this theme?

Hello KenMercusLai,

The BT3-Flat theme is awesome and easily the best Pelican theme out there. I'm not sure if I can use it for my personal site, however, since there is no license included with the theme. Did you intend for the theme to be used by others or is it on github for viewing purposes only?

Code highlighting isn't showing up.

Using the latest version of BT3-Flat, a article which contains code doesn't show syntax highlighting.

Example article snippet.

I’ll give you a hint

  empty_record = EMPTY_INDEX_RECORD
  Print(EMPTY_INDEX_RECORD)
  # prints {"dates":[], "files_to_ignore":{}} on 
  # the first function call.

  empty_record = EMPTY_INDEX_RECORD
  Print(EMPTY_INDEX_RECORD)
  # prints {"dates":[], "files_to_ignore":{“9”: 
  # “test”}} on the second function call.

blog.html missing

I did make html and make serve. All is working great but when i click on blog link it could not find that file.
Also, blog.html is not present in output folder.

I'm using pelican 3.3.0