reorganized docs a bit

This commit is contained in:
Brandon Mathis 2011-07-24 09:31:04 -04:00
parent 2f2578bb67
commit 81c07d858b
6 changed files with 7 additions and 12 deletions

View File

@ -7,8 +7,6 @@ comments: false
footer: false
---
[« Previous, Updating Octopress](/docs/updating)
Octopress offers some rake tasks to create post and pages preloaded with metadata and according to Jekyll's naming conventions.
## Blog Posts
@ -88,4 +86,4 @@ Jekyll's built in WEBrick server is handy, but if you're a [POW](http://pow.cx)
Now that you're setup with POW, you'll just run `rake watch` and load up `http://octopress.dev` instead.
Also, see [Sharing Code Snippets](/docs/blogging/code) and [Blogging with Plugins](/docs/blogging/plugins)
Also see [Sharing Code Snippets](/docs/blogging/code) and [Blogging with Plugins](/docs/blogging/plugins)

View File

@ -69,11 +69,10 @@ Import files on your file system into any blog post or page. For example, to emb
[Examples & documentation »](/docs/plugins/render-partials/)
Also see the [Octopress Plugin page](/docs/plugins) for more plugins.
## Excerpt Filter
When writing a post, you can add an HTML comment `<!--more-->` to split the post for an excerpt. Only the first section of the post, before the comment,
will show up on the blog index.
This filter is used in `source/_includes/article.html`
Also see the [Octopress Plugin page](/docs/plugins) for more plugins.

View File

@ -80,4 +80,4 @@ Here's an example for deploying the Octopress website to Github Project Pages:
For more info on deploying a Jekyll Blog, checkout [Jekyll's deployment wiki page](https://github.com/mojombo/jekyll/wiki/Deployment).
[Next, Theming & Customization &raquo;](/docs/theming)
[Next, Blogging Basics &raquo;](/docs/blogging)

View File

@ -17,8 +17,6 @@ This section will help you get set up, and explain how to configure Octopress fo
- [Initial setup](/docs/setup) - *get source and install dependencies*
- [Basic Configuration](/docs/configuring) - *enable third party services and personalize your blog*
- [Deploying Octopress](/docs/deploying) - *simple deploy instructions for Rsync and Github pages*
- [Theming & Customization](/docs/theming) - *guide to making changes to your Octopress theme*
- [Updating Octopress](/docs/updating) - *a guide to help you stay current with Octopress*
## Using Octopress
Your blog should be awesome. This should help.
@ -27,6 +25,8 @@ Your blog should be awesome. This should help.
- [Sharing Code Snippets](/docs/blogging/code) - *share code snippets with ease*
- [Syntax Highlighting Test](/docs/blogging/code/test) - *language highlighting tests*
- [Blogging With Plugins](/docs/blogging/plugins) - *overview of plugins for blogging*
- [Theming & Customization](/docs/theming) - *guide to making changes to your Octopress theme*
- [Updating Octopress](/docs/updating) - *a guide to help you stay current with Octopress*
## Octopress Plugins - Usage & Examples
{% render_partial docs/plugins/index.markdown %}

View File

@ -42,4 +42,4 @@ and you should be all set up to begin blogging with Octopress.
**Note:** If you already have a blog, check out [Jekyll's Migration page](https://github.com/mojombo/jekyll/wiki/blog-migrations) to help you get your content formatted for Jekyll blogging.
[Next, Deploying Octopress &raquo;](/docs/configuring)
[Next, Configuring Octopress &raquo;](/docs/configuring)

View File

@ -6,8 +6,6 @@ sidebar: false
footer: false
---
[&laquo; Previous, Deploying Octopress](/docs/deploying)
I hope to eventually release more themes, but for now Octopress ships with a single theme comprised of layouts, partials, pages, javascripts, and
Sass stylesheets located in `.themes/classic/source` and `.themes/classic/sass`.
When you install the Octopress theme, these directories are copied into `/source` and `/sass`. You are free to make any changes you like,
@ -87,4 +85,4 @@ customizations be taken care of [with configuration](/docs/configuring).
If you study the layouts and partials, you'll see that there's a lot of conditional markup. Logic in the view is lamentable, but a necessary
side effect of simple static site generation.
[Next, Updating Your Blog &raquo;](/docs/updating)
Also see [Updating Your Blog &raquo;](/docs/updating)