Git Product home page Git Product logo

pelican-cid's Introduction

Cid

Cid is a simple theme for static site generator, Pelican. Demo: my site.

Features summary:

  • Disqus comment. DISQUS_SITENAME must be defined in configuration file.
  • Google Analytics. GOOGLE_ANALYTICS must be defined in configuration.
  • Obfuscated Email. CONTACT_EMAIL must be defined in the configuration file. Javascript is required to view the email address.
  • Responsive theme.
  • Landing Page template.
  • Pagination.

Screenshots

See in the scrshot/ directory.

Landing Page Template

Cid includes a landing page template that can be used to generate a landing page for your site. To use it, simply create a static page that uses the landing.html template and configure it to be the index page of your site.

Custom links on the landing page and footer

By default, the landing page and site footer will display the list of static pages configured on the site. To replace them with a list of links you want, specify a USE_CUSTOM_MENU configuration variable to be true, and create CUSTOM_MENUITEMS tuple in the (Title, url) format within your configuration file to contain the list of items you want to display. The url are specified relative to the SITEURL. Example:

USE_CUSTOM_MENU = True
CUSTOM_MENUITEMS = (('Blog', `blog`),
             ('Contact', 'contact'),
             ('Projects', 'pages/projects'))

Custom Site Footer

Define a SITEFOOTER in your configuration file to replace the site footer. Will default to Pelican and theme credit if not defined. The site footer can contains HTMl tags, but it's better to keep it simple as it will be printed inside a p tag.

Obfuscated Email

If CONTACT_EMAIL is configured, the theme will display the email address in a mailto link, but the email address will be printed through a Javascript ROT13 function in order to obfuscate the email addres. This means the email address won't be displayed if the site visitor doesn't have Javascript enabled.

Contacts Links

Additional contact information can be displayed in the same way as the custom menu item/ pages links. To use it, define a CONTACTS tuple in the configuration file.

CONTACTS = (('facebook', 'https://www.facebook.com/fbAcc'),
            ('twitter', 'https://twitter.com/twttrAcc'),)

Development Notes

The style sheet for this theme is written in SASS, located in the src/sass/cid.sass file, which are then compiled to static/css/cid.css. There is a package.json and gulpfile.json that I used during the development of the theme draft, which can be used to quickly set up a live reload server and auto-compile. Note that the you would still need to have the sass ruby gem installed. The design directory contains the static HTML draft that I used to help me decide on the design, the contents are no longer used and it is not kept updated to any design changes.

#LICENSE MIT

pelican-cid's People

Contributors

hdra avatar chemberger avatar

Watchers

James Cloos avatar  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.