Home | ruhoh universal static blog generator Get Started With GitHub Pages (Plus Bonus Jekyll) ◆ 24 ways After several failed attempts at getting set up with GitHub Pages, I vowed that if I ever figured out how to do it, I’d write it up. Fortunately, I did eventually figure it out, so here is my write-up. Why I think GitHub Pages is cool Normally when you host stuff on GitHub, you’re just storing your files there. GitHub Pages accepts static HTML but can’t execute languages like PHP, or use a database in the way you’re probably used to, so you’ll need to output static HTML files. The main benefit of GitHub Pages is ease of collaboration. Before you get started If you’ve used GitHub before, already have an account and know the basics like how to set up a repository and clone it to your computer, you’re good to go. I also found this tutorial about GitHub Pages by Thinkful really useful, and it contains details on how to turn an existing repository into a GitHub Pages site. Although this involves a bit of using the command line, it’s minimal, and I’ll guide you through the basics. Make a page <!
Jekyll Quick Start | ruhoh universal static blog generator Host on GitHub in 3 Minutes Make sure to input your GitHub username so the instructions reflect the exact code you need to run to host your blog. 1. Create a New Repository Go to your and create a new repository named USERNAME.github.com 2. Enter these commands into your terminal in a directory you want your blog to be: git clone USERNAME.github.com cd USERNAME.github.com git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git git push origin master 3. Already have your blog on GitHub? I'll assume you have the Jekyll gem installed on your local machine. $ git clone cd jekyll-bootstrap$ jekyll serve See it in action at 2. In order to preview your blog locally you'll need to install the Jekyll ruby gem. $ gem install jekyll If you run into a problem please consult the original Jekyll installation documentation. 3. 4. Create a nested page: 5.
CEDVEL GitHub Pages How Jekyll Works | ruhoh universal static blog generator What is Jekyll? Jekyll is a parsing engine bundled as a ruby gem used to build static websites from dynamic components such as templates, partials, liquid code, markdown, etc. Jekyll is known as "a simple, blog aware, static site generator". Example Jekyll websites. What does Jekyll do? Jekyll is installed as a ruby gem local computer. Once parsed, Jekyll stores the result in a self-contained static _site folder. You can think of Jekyll as a normalish dynamic blog but rather than parsing content, templates, and tags on each request, Jekyll does this once beforehand and caches the entire website in a folder for serving statically. Jekyll is Not Blogging Software. Jekyll is a parsing engine. Jekyll does not come with any content nor does it have any templates or design elements. Why Should I Care? Jekyll is very minimalistic and very efficient. Therefore if you like to keep things simple and you prefer the command-line over an admin panel UI then give Jekyll a try. Heads up! Initial Setup Includes
Unit Verse | Unit Interactive's Design, Development, and Business Blog Project Launch: The Investment Center Redesign We are pleased to announce the redesign launch of The Investment Center (TIC) website, a broker/dealer site for investment advisors and their clients. Project Launch: Peeper’s Eyewear Redesign We’ve just launched a site for Peeper’s, a luxury eyewear seller in Dallas who has been in business for over 35 years, the longest in the area. Project Launch: Because Furman Matters Redesign We are pleased to announce the redesign launch of Furman University’s “Because Furman Matters” (BFM) campaign website. Project Launch: IOMA’s Institute of Finance & Management We are pleased to announce the launch of IOMA’s Institute of Finance & Management (IOFM). Project Launch: Xomba Redesign We are pleased to announce the redesign launch of Xomba, an online writing and social networking community. We’re Looking for a JS Developer We’re looking for a JavaScript developer to join us in our Plano, Texas office on a special project. What a Nice Thank-You Card
Writing posts One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, this means that you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change! The Posts Folder As explained on the directory structure page, the _posts folder is where your blog posts will live. Creating Post Files To create a new post, all you need to do is create a new file in the _posts directory. YEAR-MONTH-DAY-title.MARKUP Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. 2011-12-31-new-years-eve-is-awesome.md 2012-09-12-how-to-write-a-blog.textile ProTip™: Link to other posts Content Formats Be aware of character sets