Octopress Themes - Salvador Theme

Salvador theme is a theme hand made for Octopress blogging framework. It is compatible with Octopress 2. Updates will be provided from this repository.

Installation

You can choose to install as a Git submodule. Or you can download as a zip archive and copy the files manually.

Install as Git submodule

These instructions will create a git submodule under the .themes/salvador directory. From your blog directory, run these commands.

git submodule add git://github.com/mauriciovieira/salvador.git .themes/salvador

You should then commit the changes.

git add .themes
git commit -m "added salvador theme"

Next, you should apply the theme to your blog and generate the stylesheets. Follow the install instructions.

Install from downloaded zip archive

If you are more comfortable with just the theme files, you can download our zip archives from my website.

1. Once you have downloaded the package, uncompress the archive.
2. Go to your Octopress blog's directory. There should be a hidden directory called .themes.
3. Your theme should be a single directory called salvador containing the theme files. Copy the salvador directory to the .themes directory on your Octopress blog's directory.

Next, you should apply the theme to your blog and generate the stylesheets. Follow the install instructions.

Updating the theme

With Git submodules

From your Octopress blog's directory, assuming your theme directory is called salvador.

cd .themes/salvador
git pull origin master

Next, you should apply the theme to your blog and generate the stylesheets. Follow the install instructions.

With downloaded packages

It is largely similar to the install process. We want to overwrite the theme with the new files. Lastly, to run install to apply the changes.

1. Download the new packages from my website.
2. Once you have downloaded the package, uncompress the archive.
3. Go to your Octopress blog's directory. There should be a hidden directory called .themes.
4. Your downloaded files should be a single directory called salvador containing the theme files. Copy the salvador directory to the .themes directory on your Octopress blog's directory.

Next, you should apply the theme to your blog and generate the stylesheets. Follow the install instructions.

Removing the theme

If you installed as a Git submodule

From your Octopress blog's directory,

Remove the theme entry from the .gitmodules file. The entry should look like this:

[submodule ".themes/salvador"]
  path = .themes/salvador
  url = https://github.com/mauriciovieira/salvador.git

Remove the theme from the .git/config file. The entry should look like this:

[submodule ".themes/salvador"]
  url = https://github.com/mauriciovieira/salvador.git

Remove the theme files with Git.

git rm  --cached .themes/salvador

Your files should be removed. If you want to go back to using the default theme, follow the Octopress default theme install instructions.

If you installed as a download package

From your Octopress blog's directory,

1. Remove the salvador directory from .themes/salvador.
2. Follow the Octopress default theme install instructions.

Applying the salvador theme to your blog

Follow this set of instructions whenever you made a new install or update to your themes.

rake install[salvador]
rake generate

Take a look at the changes using the in built Octopress local server at http://localhost:4000

rake preview

If everything looks ok, deploy it.

rake deploy

Applying the classic theme to your blog

Follow this set of instructions when you want to install the default Octopress theme. It is largely similar to the instructions for installing a new theme. Only the name of the theme has changed.

rake install[classic]
rake generate

Take a look at the changes using the in built Octopress local server at http://localhost:4000

rake preview

If everything looks ok, deploy it

rake deploy

Support

Should you have any problems, raise an issue on this repository.

Note

This theme was based on the Venice Octopress Theme.

Other themes

More themes are available on Octopress themes. Feel free to take a look.

License

Copyright © 2014. Mauricio Vieira. MIT License