Git Cookin’ With Git’s Octopress

Posted by Flatiron School  /  October 8, 2013

The following is a guest post by Margaret Lee and originally appeared on her blog. Margaret is currently in the Ruby-003 class at The Flatiron School. You can follow her on Twitter here.

This is a journey of a housewife learning to code. Over the years, I’ve become quite a creative chef trying to feed two very picky eaters. Pureed cauliflower in mac-in-cheese, dates and quinoa in banana bread, and beets in raspberry sorbet. I thought code would be sort of like cooking. Start with a recipe, add a pinch of this and a little dash of that, and voila. Er uh, not really. Over the past few weeks, there are days where I feel as though I’ve been dropped in the middle Iron Chef-Japan and I don’t speak the language. What? Theme ingredient is sea urchin and the course is dessert? Hmmmmm.

Almost two weeks ago we started with Git. Very cool to clone and push. Although I am still afraid of Master. Took time, but ‘fork’ now has new meaning to me. As do ‘.slice,’ ‘.split,’ ‘.push,’ ‘.pop’ and ‘scrape’ after last week’s Ruby binge. Writing those words can make anyone feel like this week’s I.C. Master Hiroyuki Sakai.

This week we’re starting to blog. For years, I purposefully put off forming accounts for Facebook, LinkedIn and Twitter for fear that I would lose myself in a vortex of connecting with childhood friends vs. connecting with my own children. Plus, what did I have to say out there on the fringes of the web? Its a big step to be blogging. About code nonetheless.

Will get to Ruby in the next blog, but for now, lets talk about the matter at hand: Git’s Octopress. I was just trying to get a sense of the various blog engines out there and stumbled on this brief overview which lists Octopress’s pros.

Tealdi sums it up nicely: “Octopress is a simple framework designed for Jekyll, that is powering GitHub Pages. Jekyll is a simple, lightweight static site generator written in Ruby. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache or your favorite web server.” Wow, clear even to the foreigner!

There’s a neat little presentation called “Octopress: A blogging framework for hackers” by Akira Maeda. A propos. A little sad but while others are probably blogging about scraping websites with Nokogiri, I’m blogging about how to blog. Baby steps.

Within the Presentation, very simple guideposts: – Write Markdown – Generate – Deploy I love this word and use it to launch my children off to school

Octopress: A blogging framework for hackers

There are even 3rd Party Octopress Themes. I’m going to try one out now called ‘Whitespace’ by Lucas Lew. I’m still figuring out how to customize the markdown. I’m getting closer…. This link tells you where to go to customize other attributes in the header, aside etc., but i have a little more work to do.

Octopress utilizes the “usual” Git commands to commit your source code to the blog (git add/commit/push). I feel like I’m getting “bonus” practice on Git while I learn about blogging.

I bid you good eating. Next up, Ruby with guest appearance from I.C. octopodafeline.