Skip to content

M0nica/attila

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Pelican Attila Theme

A content focused responsive theme for Pelican.

It is ported from ghost theme attila

Demo

Demo blog source code

Install

The recommend way to install is using pelican-themes command.

  • Download latest zip from release
  • Unzip that file
  • Then sudo pelican-themes -U attila . Here attila is the extracted folder name
  • Now list all themes sudo pelican-themes -l
  • Use that theme name in your pelicanconf.py

Features

  • Responsive layout
  • Navigation support
  • Paralax cover images for posts, author archives and blog
  • Author informations for posts and author archives
  • Featured posts (via plugin)
  • Reading progress for posts
  • Automatic code syntax highlight
  • Disqus support
  • Google Analytics, GAUGES and PIWIKI
  • Sharing buttons
  • Open Graph
  • Rich Snippets (JSON-LD)
  • Multiple Code Highlight Styles

Docs

Wiki

Setup a blog

Refer more setting

Here are all configurations about this theme.

Header Covers

To define custom header cover, set the property HEADER_COVER in pelicanconf.py:

HEADER_COVER = 'static/my_image.png'

Header Color

To define a simple header background color, set the property HEADER_COLOR in pelicanconf.py:

HEADER_COLOR = 'black'

you can use any valid css color.

Social URLs

Github, Twitter and Facebook URLs set these properties:

SOCIAL = (('twitter', 'https://twitter.com/myprofile'),
          ('github', 'https://github.com/myprofile'),
          ('facebook','https://facebook.com/myprofile'),
          ('flickr','https://www.flickr.com/myprofile/'),
          ('envelope','mailto:my@mail.address'))

External feed URL

You can specify an external feed URL (e.g. FeedBurner) in SOCIAL using the rss or rss-square or feed icons. A <link> tag for the external feed will be placed in <head> instead of the default Pelican feeds.

Code highlights

This theme contains this color schemes:

  • Tomorrow - tomorrow.css;
  • Tomorrow Night - tomorrow_night.css;
  • Monokai - monokai.css;
  • Github (Default) - github.css;
  • Darkly - darkly.css;

To customize, define COLOR_SCHEME_CSS in pelicanconf.py with css filename. Example:

COLOR_SCHEME_CSS = 'monokai.css'

User defined CSS

Define CSS_OVERRIDE in pelicanconf.py to insert a user defined CSS file after theme CSS. Example:

Array of CSS you can give

CSS_OVERRIDE = ['css/myblog.css']

User defined script

JS_OVERRIDE = ['']

Author Bio

AUTHORS_BIO = {
  "zutrinken": {
    "name": "Zutrinken",
    "cover": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
    "image": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
    "website": "http://blog.arulraj.net",
    "location": "Chennai",
    "bio": "This is the place for a small biography with max 200 characters. Well, now 100 are left. Cool, hugh?"
  }
}

Analytics

Accept many analytics:

  • Google Analytics: GOOGLE_ANALYTICS;
  • Gauges: GAUGES
  • Piwik: PIWIK_URL and PIWIK_SITE_ID.

Other configuration

  • GOOGLE_SITE_VERIFICATION - Google site verification token;
  • Set SHOW_FULL_ARTICLE to True to show full article content on index.html instead of summary;
  • Set FACEBOOK_ADMINS to a list of Facebook account IDs which are associated with this blog. For example ['12345']. For more info see https://developers.facebook.com/docs/platforminsights/domains

Articles

  • To customize header cover to articles, insert the metadata header_cover.
  • To customize OpenGraph images, insert the metadata og_image, otherwise cover, HEADER_COVER or a default image is used.
  • To customize Twitter card images, insert the metadata twitter_image, otherwise header_cover, HEADER_COVER or a default image is used. Twitter cards are automatically generated if the twitter icon is configured in SOCIAL!

All image paths are relative from the site root directory. You can also use absolute URLs for og_image and twitter_image.

Development

refer this https://github.com/arulrajnet/attila-demo

Author Screen screenshot

Contributing

Always open an issue before sending a PR. Talk about the problem/feature that you want to fix. If it's really a good thing you can submit your PR. If you send an PR without talking about before what it is, you may work for nothing.

As always, if you want something that only make sense to you, just fork attila and start a new theme.

Donate

Did you liked this theme? Pay my bills and support new features.

Gratipay

PayPal

Copyright & License

Copyright (c) 2015-2016 Peter Amende - Released under The MIT License. Copyright (c) 2016 Arulraj V - Released under The MIT License.

Some background images used from https://github.com/gilsondev/pelican-clean-blog

Packages

No packages published

Languages

  • CSS 65.1%
  • HTML 33.2%
  • JavaScript 1.7%