Home

csfam blog/official website##

http://www.thecsfam.com

(is hosted on github and runs octopress.org which is a git and jekyll based blog publishing um platform.)

i believe the idea is that we post up interesting stuff we come across there, whether it be links we like, or thoughts we have about coding or project design or whatnot. ray has more ideas about what exactly.

howto configure env

• follow the directions at http://octopress.org/docs/setup/rvm/ to get rvm (a ruby environment manager).
• git clone git@github.com:csfam/csfam.github.com.git -b source
• git clone git@github.com:csfam/csfam.github.com.git -b master csfam.github.com/_deploy
• _yes this seems weird with the master branch being checked out in a subdirectory... thats the way they octopress wants it, but yes it is weird. you end up always working in the source branch and never have to manually touch deploy or the master branch, just remember that.
• cd csfam.github.com
• ruby --version
• this should say you are using ruby 1.9.2blahblahblah if its not then rvm isn't doing something right
• if it is the right version then:
• gem install bundler
• bundle install

howto create a new post

bundle exec rake new_post["your post title here"]

this will create a file in source/_posts/ you can then edit this file which is your post. more about that here: http://octopress.org/docs/blogging/

just remember that in our environment you have to prepend bundle exec to any rake command.

for mac people a slightly decent markdown editor is: http://mouapp.com/ or you can get https://github.com/plasticboy/vim-markdown for vim if you prefer :-)

to preview the site you can do: bundle exec rake preview

which will start up a webserver on http://localhost:4000 and watch for any changes so you can see a live preview.

how to post

bundle exec rake generate

just in case to make sure its all generated (preview should be enough but in some cases (if you edit _config for instance) it won't pick up the change.

and then:

bundle exec rake deploy

which will merge your generated content into the master branch and push it to github automatically.

remember that the branch you are working on is source so when you want to commit the source changes you'll need to do:

git push origin source

edit look and feel

check out the sass directory for stylesheet stuffs, more info about how to change stuff here: http://octopress.org/docs/theme/