Giter VIP home page Giter VIP logo

clean-blog-theme's Introduction

Clean blog theme

Clean blog theme is a ported theme to Spress designed by Start Bootstrap.

Live demo.

Spresso theme preview

Features

  • Fully responsive.
  • Distraction free blog text optimized for legibility.
  • Support for tags and categories in posts.
  • Contact form powered by getsimpleform.
  • Comments powered by Disqus.
  • Code highlighted thanks to highlight.js.

Installation

You can create a site based on Clean blog or install this one as a theme of a pre-existing site.

Requirements:

  • Spress >= 2.2.0

Creating a new site based on this theme

Performs the following command and clean-blog theme will be installed in mysite folder:

$ spress new:site mysite spress-add-ons/clean-blog-theme

Install as a theme

Go to your site folder and performs the following command:

$ spress add:plugin spress-add-ons/clean-blog-theme

And add this line to the config.yml file of your site:

themes:
    name: "spress-add-ons/clean-blog-theme"

How to update?

You can get the latest version of Clean blog theme with just run the following command:

$ spress update:plugin

Contents

Layouts

Refers to files within the ./src/layouts directory, that define the architecture of the content.

  • default.html: The base layout. The derived layouts inject their contents into this file at the line that says {{ page.content }}.
  • page.html: Layout for pages.
  • post.html: Layout for posts. They are located at ./src/content/posts.
  • collection.html: Layout used by collection pages: categories.html and tags.html.

Includes

Refers to snippets of code within the ./src/includes directory. These ones can be inserted in layouts and pages.

  • head.html: Defines the content of <head></head> in default layout.
  • footer.html: Defines the default footer section.
  • nav.html: Defines de top-menu based on pages with title.
  • paginator.html: Defines the pagination of the content.

Configuration

Comments

Comments are powered by Disqus and they need a disqus shortname. To get it, you need to create an account at this service. It's free.

comments:
  enabled: true
  disqus_shortname: "your-shortname"

Top menu

The top menu is composed by each of pages with title attribute. e.g: ./src/content/about.md:

title: "About me"

Contact form

The contact form is a AJAX form configured in config.yml:

forms:
    contact:
        getsimpleform_api_token:

You need a API key from getsimpleform service. It's free.

Writing a post

To create a new post, runs new:post command from Spress:

$ spress new:post

Each post could has a header and thumbnail image. You can configure your image and some data about it:

header_img:
  url: "assets/img/post-bg-07.jpg"
  author: "Yuri Samoilov"
  author_url: "https://flic.kr/p/mjhDwB"

Thumbnail images

The index.html page can display a thumbnail image for each post. This kind of images must be located at ./src/content/assets/img folder and the image may has the dimentions 100x100 px.

At the thumb_img key you can set the name of the image file like this:

thumb_img: spress.png

License

The theme is available as open source under the terms of the Apache 2.0.

clean-blog-theme's People

Contributors

yosymfony avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

clean-blog-theme's Issues

How to configure contact form?

Hello I am wondering if you can explain how to configure contact form? In the contact.html it is stated that some changes need to be done in line 19 of the file mail/contact_me.php but I can't find that file, it seems to me it doesn't exist.
Also as a theme feature it is stated that Contact form is powered by getsimpleform. But I am not sure how to make that work, it's not related to the existing form in the theme, contact.html?
Thanks in advance

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.