2009-11-01 04:17:29 +00:00
# What is Octopress?
Octopress gives developers a well designed starting point for a Jekyll blog. It's easy to configure and easy to deploy. Sweet huh?
2009-10-31 18:02:47 +00:00
2009-11-01 05:17:17 +00:00
#### Octopress comes with
2009-11-01 05:21:05 +00:00
1. A nice, easy to configure theme that focuses on readability.
2009-11-01 05:17:17 +00:00
2. Built in support for Twitter, Delicious, and Disqus Comments.
3. Rake tasks that make development fast, and deployment easy.
2009-11-01 04:17:29 +00:00
## Why?
1. Building a Jekyll blog from scratch is a lot of work.
2. Jekyll doesn't have default layouts or themes.
3. Most developers don't want to do design.
2009-10-31 18:02:47 +00:00
2009-11-01 04:17:29 +00:00
## Octopress is made of
2009-10-31 18:02:47 +00:00
- [Jekyll ](http://github.com/henrik/jekyll ) a blog aware static site generator (Henrik's fork adds [HAML ](http://haml-lang.com ) support)
2009-11-01 05:17:17 +00:00
- [Compass ](http://compass-style.org ) an awesome [SASS ](http://sass-lang.com ) framework
- [FSSM ](http://github.com/ttilley/fssm/tree/master ) + a rake task, automatically regenerates the blog as you work
2009-10-31 18:02:47 +00:00
- [Serve ](http://github.com/jlong/serve ) for live previews of the site while in development
2009-11-01 05:17:17 +00:00
- [Rsync ](http://samba.anu.edu.au/rsync/ ) for easy deployment
2009-10-31 18:02:47 +00:00
2009-11-01 04:17:29 +00:00
## Setup
2009-11-13 18:54:32 +00:00
Setup is really simple.
1. Download Octopress: < code > git clone git://github.com/imathis/octopress.git</ code >
2. Install required gems:
2009-11-01 04:17:29 +00:00
sudo gem install henrik-jekyll
2009-11-13 18:54:32 +00:00
sudo gem install compass
2009-11-01 04:17:29 +00:00
sudo gem install fssm
sudo gem install serve
2009-11-13 18:54:32 +00:00
3. Run < code > rake preview</ code > to build the site and preview it in a local webserver.
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
You'll want to change some settings, so check out the [Setup & Configurations wiki page ](http://wiki.github.com/imathis/octopress/setup-configuration )
2009-11-01 04:17:29 +00:00
## Usage
2009-11-13 18:54:32 +00:00
Octopress is almost like a front-end for Jekyll. It provides some really handy rake tasks and automation to make blogging as simple as possible. With Octopress you can:
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
- Preview the site locally with the power of Serve.
- Automatically regenerate your blog while you work.
- Generate and deploy with a single command.
2009-11-01 05:17:17 +00:00
2009-11-13 18:54:32 +00:00
See the [usage wiki page ](http://wiki.github.com/imathis/octopress/usage ) to learn more.
2009-11-01 05:17:17 +00:00
2009-11-06 05:35:53 +00:00
## Third Party Integration
2009-11-13 18:54:32 +00:00
With search, comments, and analytics, you have no need for a database. This is what makes a statically generated blog possible.
2009-11-07 18:05:10 +00:00
2009-11-13 18:54:32 +00:00
- Twitter
- Disqus Comments
- Google Custom Search
- Google Analytics
- Delicious Bookmarks
2009-11-01 05:17:17 +00:00
2009-11-13 18:54:32 +00:00
If you already have an account with these services, you can get set up within seconds. [Check out the wiki ](http://wiki.github.com/imathis/octopress/third-party-integration ) to learn how to setup or remove these services.
2009-11-01 05:17:17 +00:00
2009-11-13 18:54:32 +00:00
## Octopress Style
- Stylesheets use [SASS ](http://sass-lang.com ) and [Compass ](http://compass-style.org )
- They're broken up into Layout, Typography, Theme (colors), and Partials
- Checkout [the wiki ](http://wiki.github.com/imathis/octopress/style-customization ) for help with customization.
2009-11-01 05:17:17 +00:00
2009-11-13 18:54:32 +00:00
## License
(The MIT License)
2009-11-01 05:17:17 +00:00
2009-11-13 18:54:32 +00:00
Copyright © 2009 Brandon Mathis
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘ Software’ ), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
THE SOFTWARE IS PROVIDED ‘ AS IS’ , WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
2009-11-01 04:17:29 +00:00
2009-11-13 18:54:32 +00:00
#### If you want to be awesome.
- Proudly display the 'Powered by Octopress' credit in the footer.
- Add your site to the wiki so we can watch the community grow.