Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hychen/octopress-admin

octopress blog management script
https://github.com/hychen/octopress-admin

Last synced: 27 days ago
JSON representation

octopress blog management script

Awesome Lists containing this project

README 

        
hychen's octopress admin script



# Requirement



- python (>=2.5)

- git

- sensible-editor

- python modules:

	- [UCLTIP](pypi.python.org/pypi/ucltip) (>= 0.6)



# Installation



## install dependecy for Ubuntu/Debian users



	user@host:~$ apt-get install git

	user@host:~$ apt-get install python-ucltip



## get source



	user@host:~$ git clone http://github.com/hychen/octopress-admin



## install script



	user@host:~$ cd octopress-admin

	user@host:octopress-admin$ python setup.py install



or just create a link



	user@host:octopress-admin$ ln -s ~/bin/blog $PWD/octopress-admin/bin/octopress-admin



*notice*: if you want to use command located in ~/bin, you need to add ~/bin to PATH variable, like this



	PATH=~/bin:$PATH



## How to use it



before using this tool, please setup your ruby enviroment for octopress



### create a new blog site



cloned octopress source



	$ octopress-admin new hyblog



### install bundle, do setup of github



setup for deploy to github



note: a user gh_page repository in github link is required



	$ octopress-admin new hyblog



### create a draft post



create a new post and commit in a git branch, every draft post is

mapping to a git branch name starts with a drafts prefix



	$ octopress-admin post 'this is a new post'

	---

	layout: post

	title: ""hello""

	date: 2011-12-04 05:15

	comments: true

	categories:

	---



here is how log look likes



	2011-12-04 Hsin-Yi Chen (hyc~ o [source] enable facebook like

	2011-12-04 Hsin-Yi Chen (hyc~ │ o [drafts/2011-12-04-hiello] start to write hiello

	2011-12-04 Hsin-Yi Chen (hyc~ I─┘ Finished github deploy settings



### list draft posts you have



list posts in drafts/* branchs



	$ octopress-admin drafts

	[1] source/_posts/2011-12-04-hello.markdown (branch: drafts/2011-12-04-hello)



### edit a draft post



checkout to a draft branch and use user favor editor to modify the draft post



	$ octopress-admin edit 1

	---

	layout: post

	title: ""hello""

	date: 2011-12-04 05:15

	comments: true

	categories:

	---



1 is a number as a index of draft branchs, it is recommand to use

`octopress-admin drafts` to know the index of drafts now, because branch index is not always the same.



### publish a draft post



merge a draft post to source and also delete a draft branch which means

the draft post will be include in next blog site building



	$ octopress-admin publish 1



1 is a number as a index of draft branchs



here is the commit log after publish the draft



	2011-12-04 Hsin-Yi Chen (hyc~ M─┐ [source] Merge branch 'drafts/2011-12-04-hello' into source

	2011-12-04 Hsin-Yi Chen (hyc~ │ o start to write hello

	2011-12-04 Hsin-Yi Chen (hyc~ o │ enable facebook like

	2011-12-04 Hsin-Yi Chen (hyc~ o─┘ Finished github deploy settings



### deploy blog



generate contents of blog site and push to github



	$ octopress-admin deploy



### upgrade blog



get lastest octopress source code and install



	$ octopress-admin upgrade



### preview blog



run `rake preview`



	$ octopress-admin preview