설치 요구사항

하루프레스는 노드를 기반하여 모든 소스코드가 자바스크립트로 작성되었습니다. 하루프레스를 이용하기 위해서는 노드 최신버젼을 설치해 주어야 합니다. 노드 공식 사이트를 통해 설치방법과 레퍼런스를 얻을 수 있습니다. 하루프레스를 사용하시려면 nvm 와 같은 노드 버젼 메니저를 사용하기를 권장합니다.

하루프레스는 총 20여가지의 오픈소스와 2가지의 오픈 스펙을 기반으로 개발되었고 대부분의 오픈소스가 모두 Github.com 을 통해 관리 되어지고 있어 하루프레스는 이것들을 서브모듈로 사용하고 있습니다.

또한 하루프레스가 생성하는 정적 페이지를 웹에서 확인하기 위해서는 Github.com 에 본인의 계정과 공개(Publish)된 저장소가 존재해야 합니다. (저장소 생성)

Install haroopress from rhiokim on Vimeo.

설치

소스를 이용한 설치

$ git clone https://github.com/rhiokim/haroopress.git /path/to/yourblog.com
$ cd /path/to/yourblog.com
$ make init
... git submodule init ...

하루프레스 초기화가 완료되면 자동으로 다음(아래) 단계를 진행합니다. 대부분 필수 설정 정보를 입력 받기 때문에 모두 입력하면 됩니다. 혹 실수로 잘못 입력했더라도 수정할 수 있기 때문에 다시 설치하지 않아도 됩니다.

하루프레스 환경(메타정보)설정

haroo> Insert your site title (*) : 사이트 타이틀
haroo> Insert your site description (*) : 사이트 설명
haroo> Insert site url (*) : 사이트 주소
haroo> Insert you full name (*) : 이름
haroo> Insert you gravatar emaill address (*) : 이메일
haroo> Insert you site meta information (*) : 메타 정보
...

haroo> Save? [y/n] : y ¶

Github 계정이 없다면 먼저 생성한 후 본인의 아이디로 된 새로운 저장소를 생성한다. 저장소 명칭이 id.github.com 으로된 저장소를 생성한다.

e.g) 아이디가 haroopress 라면 haroopress.github.com 이라는 이름의 저장

배포를 위한 Github 저장소 지정

haroo> Enter the read/write url for your repository 
e.g) git@github.com:{github-id}/{github-id}.github.com.git

자세한 설치법 : 설치 퀵 가이드, 수동 환경설정 가이드

포스팅하기

하루프레스에서 새로운 콘텐츠를 생성하고 싶을땐 몇가지 명령어만 알면됩니다. 새로운 글 make new-post, 새로운 페이지 make new-page, 새로운 웹 슬라이드 make new-slide 를 실행하면 됩니다.

새로운 포스트

$ make new-post
haroo> Input article title : 기사 제목 ¶
haroo> Input article category : 카테고리 ¶
haroo> Input article tag (e.g tag1, tag2, tag3) : 태그 ¶
haroo> 파일 및 디렉토리 생성 정보

새로운 페이지

$ make new-post

새로운 웹슬라이드

$ make new-slide

생성하기

데이터베이스가 필요없는 하루프레스의 모든 데이터는 페이지로 생성됩니다. make gen 명령어로 정적 페이지를 생성할 수 있습니다.

정적 페이지 생성

$ make gen
... 생성 정보 ...

퍼블리싱하기 전 작성한 기사나 페이지가 어떻게 표시되는지 확인하고 싶다면 간단한 명령어만으로 내 컴퓨터에서 바로 볼 수 있습니다.

배포 전 미리보기

$ make preview
haroo> Start server at http://localhost:8081 ¶
Do you want check on the browser? [y(es)/n] : 

생성과 미리보기 동시에

$ make gen && make preview

퍼블리싱하기

하루프레스는 make deploy 라는 명령어로 설치 과정에서 지정한 Github 저장소로 퍼블리싱을 해줍니다. 이 과정에서는 Github.com 에 저장소 생성이 필수입니다.

Github 저장소로 배포

$ make deploy
... 배포 진행 과정 ...
haroo> open http://yourblog.com ? [y/n]

하루프레스는 Github의 Pages 서비스를 이용하여 사이트가 운영되기 때문에 생성된 정적 파일들을 설치 시 지정한 Github 저장소로 자동으로 배포를 진행합니다.

배포 메세지 지정하기

$ make deploy msg="커밋메세지"
... 배포 진행 과정 ...
haroo> open http://yourblog.com ? [y/n]