Sha256: 863017aaf391324fc676b4d80d0d58d485c8a5eb20aa46cead0bc02f1ecf9d9f

Contents?: true

Size: 1.31 KB

Versions: 4

Compression:

Stored size: 1.31 KB

Contents

# Octopress Docs

If you have the Octopress gem installed, run `$ octopress docs` from the root of your Jekyll site, and a website will mount at `http://localhost:4444` with documentation for Octopress and any plugins which support this feature.

## Adding docs to your plugin

If your plugin is built on Octopress Ink, these documentation pages are added automatically. If not, use
the code below to automatically add your plugin's Readme, Changelog and any pages in your gem path under `assets/docs`.

```ruby
if defined? Octopress::Docs
  Octopress::Docs.add({
    name:        "Your Plugin",
    description: "This plugin causes awesomeness",
    path:        File.expand_path(File.join(File.dirname(__FILE__), "../")), # gem root
    slug:        "your-plugin",                      # optional
    source_url:  "https://github.com/some/project",  # optional
    website:     "http://example.com",               # optional
  })
end
```

It's a bit odd, but the `if defined? Octopress::Docs` allows you to register doc pages if possible, without having to add the octopress-docs gem as a dependency.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

4 entries across 4 versions & 1 rubygems

Version Path
octopress-docs-0.0.15 README.md
octopress-docs-0.0.14 README.md
octopress-docs-0.0.13 README.md
octopress-docs-0.0.12 README.md