Code Monkey home page Code Monkey logo

pelican-cait's Introduction

Cait

Cait is a theme for static site generator, Pelican

Cait is a simple responsive (kind of) theme consisting of mostly black, gray, and white.

Features:

  • Disqus comment. DISQUS_SITENAME must be defined in configuration file.
  • Google Analytics. GOOGLE_ANALYTICS must be defined in configuration.
  • Responsive theme.
  • Landing and Contact Page.
  • Pagination.

Landing and Contact Page

** Only works on the latest version of Pelican. ( > 3.1.1 ) Cait includes templates for a landing page and a contact page. In order to use it, the template name needs to be included in itself. The page also need to include a metadata property for heading and subheading. An example of the landing page:

Title: Landing
Heading: Hello! My Name is John Doe
Subheading: Some subheading sentence to put int.
Template: landing

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quidem, quia, modi suscipit deleniti veniam voluptatum corporis neque sit error earum recusandae velit alias unde laudantium explicabo veritatis laboriosam cum totam ipsum voluptatem dicta nemo necessitatibus! Repellat, laudantium, at deserunt velit similique natus quia quisquam ex tempore praesentium inventore quod eos.

For the contact page, change the 4th line to Template: contact.

In order to use the landing and contact template, several additional setting values must be specified in the configuration file.

USE_CUSTOM_MENU

The landing page and contact templates includes a link to the other part of the site. These are specified in the CUSTOM_MENUITEMS tuple. The links are included in the (Title, url) format. The url are specified relative to the SITEURL.

CUSTOM_MENUITEMS = (('Blog', `blog`),
             ('Contact', 'contact'),
             ('Projects', '[ages/projects'))

The blog templates aren't required to display the CUSTOM_MENUITEMS, in which case will display the links to the static pages of the site. To use CUSTOM_MENUITEMS, specify USE_CUSTOM_MENU = True in the configuration file. Please not that by using the CUSTOM_MENUITEMS, the links to the pages will not be displayed.

SOCIAL

The landing page can includes links to several social networks. The links are shown in icons, using icons font provided with FontAwesome. These are specified with the SOCIAL tuple in the configuration file, also in the (title, url) format. The title should be in lowercase, and it needs to corresponds with the icon-* classes of FontAwesome. The title is only used to display the icon and will not be displayed, so, any icons from FontAwesome can be used as the display icon. Example:

SOCIAL = (('twitter', 'https://twitter.com/example1'),
          ('facebook', 'https://www.facebook.com/example1'),
          ('google-plus', 'https://plus.google.com/example1'),
          ('google-plus-sign', 'https://plus.google.com/example2'),
          ('github-alt', 'https://github.com/example'),)

CONTACT_EMAIL and CONTACTS

The contact page shows a list of contact methods. One of them is the email address. To display email address, the CONTACT_EMAIL needs to be set in the configuration file. Additional contact information can be displayed in the same way as the social links, this time with the CONTACT_EMAIL tuple.

CONTACT_EMAIL = "[email protected]"
CONTACTS = (('facebook', 'https://www.facebook.com/fbAcc'),
            ('twitter', 'https://twitter.com/twttrAcc'),)

#Screenshots Post index screenshot

Landing page screenshot

Post index narrow screenshot

#LICENSE MIT

pelican-cait's People

Contributors

kelwin avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.