/my-site

Primary LanguageCSS

Your first static site (with Jekyll!)

A starting frame for a Jekyll site.

Things this static site builder is using, that you should get familiar with

  • This project is a Jekyll site, which is a lightweight framework for building static sites. Jekyll documentation is here.
  • To make a copy of this project and to deploy it live, you'll need a Github account, and you'll need to have git installed in your development environment. Git resources are here.
  • Although this Jekyll site builds its pages in partial pieces, those pieces are still made out of HTML.
  • Styling is done with CSS, and the main stylesheet is assets/stylesheets/main.css.
  • JavaScript is also involved in this project, but only to manage hiding and showing the main navbar mobile menu icon.
  • Jekyll uses liquid, a templating language developed by Shopify. Check out _layouts/post.html to start to see how liquid works.

Installations

  1. Make a cloud9 account.

  2. Make a new workspace. Give it a name and a description.

Select the 'Public' option under 'Hosted Workspace'.

public_workspace

In the 'Clone from Git' input, put the link to this repository:

clone_to_cloud_9

Choose the 'blank template' option:

blank_template

Click 'Create workspace'.

  1. Run ./install-script.sh in the terminal to install all dependencies:

blank_template


Are you trying to get setup on your local computer instead of Cloud9? Come speak with me and I will help you with that.

Getting started

Check out the _config.yml file first, to set your variables. This config file is read only once when you start your server; so if you make changes to this file while your server is running, you will need to restart your server to see the changes.

On your local computer: Run jekyll server to serve locally.

On Cloud9: Run jekyll serve --host $IP --port $PORT --baseurl '' to serve on Cloud9.

This starts serving your site locally. To view, go to localhost:4000. You'll know your site is running locally if you see a nice site with a 'Hello, world!' heading.

Included goodies

Assets include:

  • A basic style frame based on skeleton.css
  • A simple JavaScript file that hides and shows the mobile navbar link when page is viewed on smaller screens
  • FontAwesome icons

Additional static pages

Add static pages to _static/, specifying frontmatter in each page. Example:

---
layout: page
title: My Awesome Page
static-page: true
permalink: /my-awesome-page/
---