Giter Club home page Giter Club logo

lucascow.github.io's Introduction

Set up a Blog with Github Pages

Why use Github Pages

  • Free
  • Easy to install (No server or ssl cert needed)
  • Static Page (Fast)

How does it work

  1. First of all, Github let you to create a static website for you and also your projects, i.e. Github Pages.

  2. Github Pages has an embedded web engine called JekyII to let you build your blog on Github Pages.

  3. What does JekyII do or support:

    • Provide you a convient architecture to manage your sites, for example, you can set mostly all the site param in 1 .yaml file.
    • Act as an server to serve your site.
    • Support Liquid web template, i.e. load and pass parameter to the template.
    • Render your blog content based on Markdown syntax.
    • Support theme so possible to build an elagant webpage quickly.

How to start

Simply follow the tutorial: Minimal Mistakes
Tips for you:

Just simply fork or clone the preoject mmistakes/minimal-mistakes. Although it is a theme, it has evrything to set up your site.

How to write a blog

There is no embedded text editor like WordPress, but you don't need to learn or write the html code.

To blog, you need to use Markdown syntax, which can be mastered within 5 minutes, here are some resource:
Once You have a basic idea, you can play an write in the online editor Github Markdown Editor.

Some other note

Development

A better jeckyII doc

Page and post share the same structure i.e. yaml meta data + content

A web page = layout + _post / (_page + _include file)

If the extension is. md, the content can have a markdwon processing.

Navi Bar

To edit the navi bar, go to /_data/navigation.yml

Demo Site

/docs is another deploy directory, you can use it to build a demo site.

Analytics Provider

To enable google analytics, simply input the track id in _config.yml when using Minimal Mistakes

lucascow.github.io's People

Contributors

mmistakes avatar lucascow avatar maxheld83 avatar zenharbinger avatar fa-ribeiro avatar scot3004 avatar thoemmi avatar yihangho avatar rschaerer avatar tobie avatar jeremyvoltz avatar andreykurenkov avatar wilsonmar avatar vwchu avatar vlajos avatar soxyl avatar carpiediem avatar rriemann avatar ozdemirburak avatar gabor-meszaros avatar hbarudin avatar jcotton1123 avatar jpatters avatar justinrummel avatar kamilszymanski avatar kylemanna avatar martinliu avatar localstatic avatar sebcachia avatar t-richards 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.