Directory structure of Octopress

Question

I want to understand the entire directory structure of Octopress. Each and every folder and how they fit in together. Could not find any docs online.

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

Help and Pointers would be much appreciated.

Answer 1

_deploy/:

(After run rake generate rake deploy)This will generate your blog, copy the generated files into _deploy/, add them to git, commit and push them up to the master branch. In a few seconds you should get an email from Github telling you that your commit has been received and will be published on your site. via Deploying to Github Pages

public: compiled site directory,your public directory will be synced to your remote page.

Difference：public/ is a rack convention and it gets wiped with each generate. _deploy/ is contains a git repo for gh-pages deployment. 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’s a list of files for configuring Octopress.

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

See the full documentation at Octopress Documentation