Octopress Catalog Structure

Question

I want to understand the whole Octopress directory structure. Each folder and how they fit into each other. Could not find any documents on the Internet.

ex: What is the difference between public folder and _deploy?

Help and pointers would be appreciated.

Answer 1

_deploy/ :

(After running rake generate rake deploy ). This will create your blog, copy the generated files to _deploy /, add them to git, commit and push them to the main branch. In a few seconds, you will receive an email from Github stating that your commit has been received and will be published on your site. via Deployment on Github Pages

public : the compiled directory of the site, your public directory will be synchronized with your remote page.

The difference: public/ is a rack agreement, and it breaks with each generator. _deploy/ contains a git repository for deploying gh pages. via @Brandon Mathis

 root: # Mapping for relative urls (default: /) source/ # Directory for site source files _includes/ # Main layout partials custom/ # <- Customize head, header, navigation, footer, and sidebar here asides/ # Theme sidebar partials post/ # post metadata, sharing & comment partials _layouts/ # layouts for pages, posts & category archives permalink: # Permalink structure for blog posts destination: # Directory for generated site files plugins: # Directory for Jekyll plugins code_dir: # Directory for code snippets (for include_code plugin) category_dir: # Directory for generated blog category pages 

Here is the list of files for configuring Octopress .

 _config.yml # Main config (Jekyll settings) Rakefile # Configs for deployment config.rb # Compass config config.ru # Rack config 

See full documentation at Octopress Documentation