About Author

Simon Kim
blog: http://simonkim.github.com
twitter: @kaoma
github: simonkim

Please! edit your profile

About this Article

Date Released:
Thursday, November 22 2012 3:01 PM

How it works - from user's perspective

Introduction

What is this about?

This article is to describe what you need to know to get started with setting up a Haroopress powered blog. Please find more information about Haroopress itself at http://haroopress.com

Getting started

The first step is to download a thing called Haroopress. It in form of bunch of files and stored at a github.com repository and you can reach it at https://github.com/rhiokim/haroopress.

There is a Quick Installation guide, written in Korean :(, at http://haroopress.com/post/haroopress-quick-guide/ that you can follow through from downloading the thing to set commands you would need to execute to publish the first set of static web pages to a web space (actually, it is a github's page) as well as the system requirement you need to fulfill.

So, how it works?

Once you have your copy of Haroopress in your local computer,

  • It allows you to
    • Setup the remote repository at github.com of your account
    • Add articles, categories, images as source of your blog
    • Based on the source, generate static pages such as .html and .css files. These are still in your local computer
    • Deploy the generated static pages to your github.com repository so anonymous Internet users can view your cool blog composed of only static web pages, which means they don't require any server-side scripting/processing
    • Any changes, addition to your source you would make timely, can be re-generated and deployed to the remote repository, or github.com page of yours over and over again, using the same sequence of commands: make gen; make deploy

What you need to know before

This information is only for quick/crash start of Haroopress setup. Once you've understood what's going on through the whole cycle, you can think of where and how to setup your blog such as Dropbox or your own web server and address.

You need to be aware of some items/points and give some of these to Haroopress setup in your local computer, mostly during make init phase. These include:

  • Github.com account. For example: yourid
    • Now you will see there is your own Github.com space at http://github.com/yourid, if it was your first time using Github.com. The more you understand Github.com, the easier your life with Haroopress
  • Github.com repository and it's page in a very special rule:

    • Normally, if you give myrepo as the name of repository, git@github.com:yourid/myrepo is the address for the repository. However, to make your life easier, Haroopress seems has defined the rule for the repository name to deploy the blog static pages, along with Github.com
    • Repository name yourid.github.com
    • Please note that you have to enter .github.com following yourid at the Repository name field in https://github.com/new
    • THIS IS VERY IMPORTANT
  • Github.com Page address associated with the account/repository

  • Your e-mail address associated to a http://gravatar.com account

Really, Get Started!

Now you are ready to give answers to questions pop-up from make init phase of Haroopress setup. Go ahead and enjoy Haroopress starting with Quick Installation Guide at http://haroopress.com/post/haroopress-quick-guide/

Alternatively, you can check http://simonkim.github.com/post/setup-progress-so-far/ to see what I've just been through to follow the Quick Installation Guide and issues I had to deal with, mostly summerized above in this article.


blog comments powered by Disqus