Coder Social home page Coder Social logo

sanjog152 / monochrome Goto Github PK

View Code? Open in Web Editor NEW

This project forked from dyutibarma/monochrome

0.0 2.0 0.0 254 KB

Minimal, responsive, SEO ready blogging template built for Jekyll. Demo -

Home Page: https://dyutibarma.github.io/monochrome/

License: Other

HTML 72.19% CSS 25.51% JavaScript 2.30%

monochrome's Introduction

About

Monochrome is a minimal, responsive, ready to use Jekyll theme for blogging. Demo (Built on top of Emerald Jekyll theme)

Features

  • Completely responsive and mobile first
  • Clean SEO friendly URLs, auto-generated from post title (no messy dates in the url)
  • SEO title/description integration
  • Sitemap ready
  • Pagination support
  • Mobile friendly navigation menu
  • Easy customization for header, footer, navigation links, colors, favicon etc
  • Default Monochrome Color Palette - black, white, greys
  • About page
  • 404 page
  • ..and a lot more

Install/Setup Jekyll

(Skip if you already have Jekyll 2.2)

  1. Make sure Ruby 2.2 is installed
sudo apt-get install ruby2.2
sudo apt-get install ruby2.2-dev
  1. Install bundle: sudo gem install bundler
  2. Install jekyll: sudo gem install jekyll

Resources

  • We found the jekyll tutorials on youtube very quick and useful to get started
  • Jekyll documentation

Install Monochrome dependencies

sudo gem install jekyll-paginate
sudo gem install jekyll-sitemap

Get Started with Monochrome

Option 1

  • Fork this repository
  • (Optional) Change the 'baseurl' value in the 'config.yml' file, from '/blog' to your preferred directory/project name (example '/xyz' or '/' to install in root)
  • Clone the forked repository to your local machine to make changes
  • Run 'jekyll serve' and open browser to 'localhost:4000/blog/' to see your changes
  • (Optional) Host with github pages

Note: If you fork the repository, your version of the repository will not be searchable. If you want searchability, we suggest you use the next option.

Option 2

  • Simply download the .zip folder from the repository github page
  • Extract the contents from the .zip folder into your local folder
  • cd into monochrome/
  • Run 'jekyll serve' and open browser to 'localhost:4000/blog/' to see your changes
  • Create a repository in github and push the files
  • (Optional) Host with github pages

Write a Post

  • cd into _posts/
  • create new file with format yyyy-mm-dd-title-of-post.md
  • add title/description (refer any of the test posts)
  • add markdown and save

Customization Options

You can customize this layout using instructions below.

Header/Footer/Navigation

Set a custom header tag by setting the related option in the _config.yml file to "true". Then insert your custom code into the header-custom.html file. In the same way, you can customize the footer of the navigation menu, by setting to "true" the related option and put your code into the nav-footer-custom.html file. Moreover select a reverse option that allows to move the navigation menu to the left side, by setting it to "true".

Colors

The basic colors are set into the base.scss file:

  • $background-color: used for background and links in the navigation menu
  • $text-color: used for text and title in posts and pages
  • $text-light-color: used for text lighter than text-color
  • $text-dark-color: used for text darker than text-color

To customize the colors, just set the values in HEX, RGB (or RGBa) or any other format accepted by CSS.

Navigation menu

The links inside the navigation menu are autogenerated from pages having the layout set to page. You can set custom links, by putting in the <a> tag into the link.html file.

Branch

There are two branches:

  • master: is for development.
  • gh-pages: is only for demo site.

Baseurl

You can change the 'baseurl' value in the 'config.yml' file, from '/monochrome' to your preferred directory/project name (example '/xyz' or '/' to install in root)

Typography

To maintain the vertical rhythm, it has been applied a Typographic scale as a modular scale, with a baseline set to 24px. To maintain this rhythm you need to insert elements like image, video or other contents with a 24px (or multiple) height as refer.

Resources

  • We found the jekyll tutorials on youtube very quick and useful to get started
  • Jekyll documentation

Todo

  • Google Analytics integration
  • Footer to stick to bottom even when content is less

Author

TheReviewIndex

License

Released under MIT License.

monochrome's People

Contributors

dyutibarma avatar thereviewindex avatar

Watchers

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