mirror of
https://github.com/moparisthebest/android.moparisthebest.org
synced 2024-11-01 15:55:03 -04:00
101 lines
3.3 KiB
Markdown
101 lines
3.3 KiB
Markdown
---
|
|
layout: page
|
|
title: Deploying Octopress
|
|
date: July 18 2011
|
|
sidebar: false
|
|
footer: false
|
|
---
|
|
|
|
<h2 id="rsync">Deploying with Rsync via SSH</h2>
|
|
|
|
Add your server configurations to the `Rakefile` under Rsync deploy config. To deploy with Rsync, be sure your public key is listed in your server's `~/.ssh/authorized_keys` file.
|
|
|
|
``` ruby
|
|
ssh_user = "user@domain.com"
|
|
document_root = "~/website.com/"
|
|
deploy_default = "rsync"
|
|
```
|
|
|
|
Now if you run
|
|
|
|
``` sh
|
|
rake generate # If you haven't generated your blog yet
|
|
rake deploy # Syncs your blog via ssh
|
|
```
|
|
|
|
in your terminal, your `public` directory will be synced to your server's document root.
|
|
|
|
<h2 id="github_pages">Deploying to Github Pages</h2>
|
|
|
|
To setup deployment, you'll want to clone your target repository into the `_deploy` directory in your Octopress project.
|
|
If you're using Github user or organization pages, clone the repository `git@github.com:username/username.github.com.git`.
|
|
|
|
### With Github User/Organization pages
|
|
|
|
``` sh
|
|
git clone git@github.com:username/username.github.com _deploy
|
|
rake config_deploy[master]
|
|
```
|
|
|
|
### With Github Project pages (gh-pages)
|
|
|
|
``` sh
|
|
git clone git@github.com:username/project.git _deploy
|
|
rake config_deploy[gh-pages]
|
|
```
|
|
|
|
The `config_deploy` rake task takes a branch name as an argument and creates a [new empty branch](http://book.git-scm.com/5_creating_new_empty_branches.html), and adds an initial commit.
|
|
This also sets `deploy_default = "push"` in your `_config.yml` and prepares your branch for easy deployment. The `rake deploy` task copies the generated blog from the `public` directory to the `_deploy` directory, adds new files, removes old files, sets a commit message, and pushes to Github.
|
|
Github will queue your site for publishing (which usually occurs instantly or within minutes if it's your first commit).
|
|
|
|
Now you should be set up to deploy, just run
|
|
|
|
``` sh
|
|
rake generate # If you haven't generated your blog yet
|
|
rake deploy # Pushes your generated blog to Github
|
|
```
|
|
|
|
<h2 id="deploy_subdir">Deploying to a Subdirectory (Github Project Pages does this)</h2>
|
|
|
|
If you're deploying to a subdirectory on your site, or if you're using Github's project pages, make sure you set up your urls correctly in your configs.
|
|
You can do this *almost* automatically:
|
|
|
|
``` sh
|
|
rake set_root_dir[your/path]
|
|
|
|
# To go back to publishing to the document root
|
|
rake set_root_dir[/]
|
|
```
|
|
|
|
Then update your `_config.yml` and `Rakefile` as follows:
|
|
|
|
``` sh
|
|
# _config.yml
|
|
url: http://yoursite.com/your/path
|
|
|
|
# Rakefile (if deploying with rsync)
|
|
document_root = "~/yoursite.com/your/path"
|
|
```
|
|
|
|
To manually configure deployment to a subdirectory, you'll change `_config.yml`, `config.rb` and `Rakefile`.
|
|
Here's an example for deploying the Octopress website to Github Project Pages:
|
|
|
|
``` sh
|
|
# _config.yml
|
|
destination: public/octopress
|
|
url: http://imathis.github.com/octopress
|
|
subscribe_rss: /octopress/atom.xml
|
|
root: /octopress
|
|
|
|
# config.rb - for Compass & Sass
|
|
http_path = "/octopress"
|
|
http_images_path = "/octopress/images"
|
|
http_fonts_path = "/octopress/fonts"
|
|
css_dir = "public/octopress/stylesheets"
|
|
|
|
# Rakefile
|
|
public_dir = "public/octopress"
|
|
# If deploying with rsync, update your Rakefile path
|
|
document_root = "~/yoursite.com/your/path"
|
|
```
|