Giter Club home page Giter Club logo

barber-jekyll's Introduction

Barber

Barber is a minimal blog theme built for Jekyll. The blog theme features a masonry grid, endless scrolling, and page transitions. ๐Ÿ’ˆ Barber is also available for Ghost.

Barber

Initial Setup

Customization

Additional Development

Installation

Jekyll requires all dependencies to be saved in the Gemfile. Run bundle install (Install Bundler if it is not already) on your command line after downloading or cloning the theme. You can then run bundle exec jekyll serve or npm start to see your development site. Run bundle exec jekyll build or npm run build to build a production ready site for deployment.

Update Settings

Almost everything to personalize your site is in the _config.yml.

# Site/SEO settings
email: [email protected]
baseurl: ""
paginate: 12
paginate_path: "/page/:num"
permalink: /:year/:month/:day/:title/
google_analytics: 

name: Thomas Vaeth
title: The Barber Theme
description: >
  Barber is a blog theme for Jekyll built by Thomas Vaeth for Samesies using HTML, Sass, and JavaScript.
url: http://barber.samesies.io
twitter_username: thomasvaeth
default_img: /assets/images/seo.jpg
social:
  - name: twitter
    url: https://twitter.com/thomasvaeth
  - name: instagram
    url: https://www.instagram.com/thomas.vaeth/
  - name: linkedin
    url: https://www.linkedin.com/in/thomasvaeth/
  - name: github
    url: https://github.com/samesies
  - name: codepen
    url: https://codepen.io/thomasvaeth/

# Contact settings
contact_img: /assets/images/placeholder-28.jpg
formcarry: https://formcarry.com/s/HkIo0nMb7

# Disqus settings
disqus: test-apkdzgmqhj

# MailChimp settings
mailchimp_action: https://samesies.us17.list-manage.com/subscribe/post-json?u=66ddf555dab480e6a8606430b&id=89b3ee034f
mailchimp_input: b_66ddf555dab480e6a8606430b_89b3ee034f

# Author settings
author:
  - name: Thomas Vaeth
    bio: Thomas Vaeth was born in New York, raised in Pennsylvania, and transplanted in Washington. He was a Web Developer at Urban Influence, but now he's a Software Engineer at Getty Images.
    url: http://thomasvaeth.com

You can change the URL the contact form is sent to, add Google Analytics, change the SEO settings, grow your website with additional authors, and much more.

Create Posts

All posts go upder the _posts directory. You can also have a _drafts directory with posts that will on your development page, but not in production.

---
layout: post
title: "Brunch Swag"
date: 2017-02-18
description: 
image: /assets/images/placeholder-15.jpg
author: Thomas Vaeth
tags: 
  - XOXO
  - La Croix
---

The front matter has to have a layout of page. All the other fields are completely optional. If you have an author variable, then it must match an author's name in _config.yml (see Update Settings). The tag variable will add a related section to the post and popular tags to the footer.

Create Pages

Creating a static page is the same as creating a post. The only difference is a page is in the root of the directory rather than the _posts directory.

---
layout: page
title: Style Guide
image: /assets/images/placeholder-18.jpg
---

You just have to make sure the front matter has a layout of page instead of post. If there is no title or image, then the page will default to the site configuration.

Create Navigation

You can create a navigation in _includes/navigation.html. Visitors can be linked directly to pages right on the top of your website.


Contact Form

The form uses Formcarry to send submitted messages straight to your inbox. The image on the popup is the the contact_img variable and the URL the forms sends to is the formcarry variable in _config.yml (see Update Settings).

Contact Form

This file can be found in _includes/formscarry.html. You can change the labels of the form here. After everything is set you will need to submit a message to yourself to confirm everything is correct.

Social Media Links

Font Awesome is used for the social media icons. The icons in the theme can be found in _includes/share.html and _includes/social.html. The icons in _includes/share.html do not need to be edited unless you want to remove a certain website; however, the ones in _includes/social.html do have to be changed. You can follow the example that has been provided in _config.yml for you to link to all of your social media accounts (see Update Settings). The naming convention has not changed from the instructions provided on Font Awesome.

Disqus Comments

Comments can be enabled on every blog post in a few steps steps. The first step is to register your website with Disqus. Disqus will provide you with a shortname that you need for the next step. Once you have that the second step is to replace the disqus variable in _config.yml (see Update Settings). The third step is to open _includes/disqus.html and remove all the instructions. The final step is to visit a blog post and verify that your comments are there.


Source Code

The source code is broken down to make finding what you need as easy as possible. Almost everything runs through gulpfile.js, so you will need to run npm install on your command line before doing any additional development. You can then run gulp or npm run gulp to compile everything.

.
โ”œโ”€โ”€ _assets
|   โ”œโ”€โ”€ js
|       โ”œโ”€โ”€ components
|       โ”œโ”€โ”€ vendor
|       โ”œโ”€โ”€ _inits.js
|       โ””โ”€โ”€ app.js
|   โ””โ”€โ”€ scss
|       โ”œโ”€โ”€ base
|       โ”œโ”€โ”€ components
|       โ”œโ”€โ”€ fonts
|       โ”œโ”€โ”€ regions
|       โ”œโ”€โ”€ tools
|       โ”œโ”€โ”€ utils
|       โ”œโ”€โ”€ vendor
|       โ””โ”€โ”€ app.scss
โ”œโ”€โ”€ _includes
|   โ”œโ”€โ”€ contact.html
|   โ”œโ”€โ”€ disqus.html
|   โ”œโ”€โ”€ footer.html
|   โ”œโ”€โ”€ formcarry.html
|   โ”œโ”€โ”€ head.html
|   โ”œโ”€โ”€ header.html
|   โ”œโ”€โ”€ navigation.html
|   โ”œโ”€โ”€ pagination.html
|   โ”œโ”€โ”€ post-card.html
|   โ”œโ”€โ”€ share.html
|   โ”œโ”€โ”€ social.html
|   โ””โ”€โ”€ subscribe_form.html
โ”œโ”€โ”€ _layouts
|   โ”œโ”€โ”€ compress.html
|   โ”œโ”€โ”€ default.html
|   โ”œโ”€โ”€ page.html
|   โ”œโ”€โ”€ post.html
|   โ””โ”€โ”€ tag.html
โ”œโ”€โ”€ _plugins
โ”œโ”€โ”€ _posts
โ”œโ”€โ”€ _site
โ”œโ”€โ”€ assets
|   โ”œโ”€โ”€ css
|   โ”œโ”€โ”€ images
|   โ”œโ”€โ”€ js
โ”œโ”€โ”€ .eslintrc
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ .stylelintrc
โ”œโ”€โ”€ 404.html
โ”œโ”€โ”€ _config.yml
โ”œโ”€โ”€ Gemfile
โ”œโ”€โ”€ Gemfile.lock
โ”œโ”€โ”€ gulpfile.js
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ style-guidle.html
โ””โ”€โ”€ subscribe.html

The CSS is written in Sass. The JavaScript is written in ES6, so your code is up to date with the newest standards.

Donations

Barber has been released for free. Similar themes cost around $29 on ThemeForest. Any donations would be greatly appreciated after the work that went into releasing Barber.

  • PayPal โ€“ https://www.paypal.me/samesies
  • Bitcoin โ€“ 1PSzNmcfAFJY1PtBK5u9R5bTGfF7KAuLcq
  • Ethereum โ€“ 0x392F7116e4171F1D740397B6000EadD2e4bb9670
  • Litecoin โ€“ LSH9AnjcUTV5T7PUxXQuxPqb9W5aSR9GEP

Support

Email [email protected] if you need any additional support with Barber.

barber-jekyll's People

Contributors

thomasvaeth avatar

Watchers

 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.