Giter Club home page Giter Club logo

martinbour.com's Introduction

martinbour.com

This is the web site application for Martin Bour To view the live site visit:
http://www.martinbour.com
or
http://shadygrove.github.io/martinbour.com/

Info

Markdown
GitHub Pages
GitHub Pages Dependencies
Jekyll - Jekyll Variables
Bourbon - CSS Mixins for SASS
NEAT - grid framework for Bourbon
Bitters - html tag styling Pygments - syntax highlighting

About This Project

Who is this for?

It's really just for Martin so he can have a web page using GitHub pages and not pay for hosting

What is it?

It's just a static web application started with a GitHub pages template and running Jekyll

When was it created?

Started in April of 2015 when Martin decided to shut down his old programming blog that was running on BlogEngine.NET.

Why is this here?

It's really just for me. If you are looking at this, I can't think of any real reason why you would want to fork my code, but whatever.

Documentation

This site was setup using GitHub Pages.
The Jekyll platform is used for posts and pages
Posts are created using Markdown formatting
SASS is used to organize CSS

Notes from setup

Run site locally with Jekyll - “bundle exec jekyll serve”

Basic setup instructions - you can use a pre-built template and a “gh-pages” branch will automatically be identified and serve as a web page

Jekyll - a simple, static, blog-aware web framework built on Ruby-on-Rails Every GitHub page is run through Jekyll, so “Simply start committing Jekyll formatted files and you'll be using Jekyll in no time.”

Install Jekyll locally for development

Basics:
Install Ruby: I used RVM (Ruby Version Manager)
Install Bundler for Ruby “gem install bundler”

Add Jekyll to project

Create gem file “bundler init”
Add “gem 'github-pages” to the GemFile
Run “bundle install”:
I received an error here and had some problems that really held me up. I was using Ruby 1.9.3 and installed 2.2.2 using RVM (version mgr). This still did not work. In the end, I had to install xcode developer tools…
xcode-select --install which will create install dialog for XCode

To run site locally with Jekyll

bundle exec jekyll serve

Design and Layout (CSS)

Jekyll uses makes use of SASS, so I decided to use (Bourbon)[http://bourbon.io/] for some high-level CSS features, and (NEAT)[http://neat.bourbon.io/] for a grid framework.

How to Setup Bourbon

I have already generated Bourbon .scss in the "_sass" directory. These are the steps I took to do that...
Add gem 'bourbon to the Gemfile
Run bundle install - this will install the gem in your Ruby install
cd to the _sass directory, and
bourbon install - this will create a bourbon directory with all the necessary .scss files
Add import to "assets/css/styles.scss": @import 'bourbon/bourbon'

Jekyll configures SASS default directory to _sass, but I decided to be explicit and define it in the _config.yml anyway...
sass:
sass_dir: _sass

How to Setup Neat

Add gem 'neat' to the Gemfile
Run bundle install
Now we need to create the directory in _sass similar to how we did Bourbon...
cd to the _sass directory, and neat install
Import neat in the master .scss file at "assets/css/styles.scss"
@import "neat/neat"

Note: make sure you can still compile the project:
jekyll build from the root directory

Domain Name Setup

The most helpful page on setting this up was… Configuring A Record with DNS Provider Create CNAME file Setup DNS account Article on Go Daddy Setup

Final GoDaddy configuration looks this… A Names:
@ = 192.30.252.153
@ = 192.30.252.154
CNAME:
www = shadygrove.github.io

Other Notes:

Text Editor - Sublime Text 2 (supports simple projects)

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.