This readme was first written on December 29th, 2008.

# Hanami Operating Manual

1. About
2. Installation
3. Replacing the Header Image
4. Special Formatting
5. Questions, Comments, Feature requests
6. Special Thanks

1. ## About

   Hanami is a two-column widget-ready theme inspired by the WordPress Admin palette (circa 2.6) and the Seed Conference font-stack. Simple and clean, the purpose of the design is to display content in clear and concise manner.

   In addition to a clean and simple design, Hanami also features:

   1. Support for child-pages, displayed as sub-navigation
   2. A widget-enabled sidebar
   3. Front page styling for sticky posts
   4. Special formatting, such as drop-caps and image captions
   5. Author comment highlighting
   6. Threaded comments for WordPress 2.7+

   Back to Top

2. ## Installation

   Hanami is installed in the same way as all other WordPress themes. Simply place the extracted theme in your themes directory (usually `/wp-content/themes`). Log-in to the WordPress administration panel, go to the "Design" section, and activate Hanami. If my explanation confused you, or you haven't installed a theme before, more detailed directions can be found in the WordPress Codex here.

   Back to Top

3. ## Replacing the Header Image

   The themes header is called `header.jpg` and is located in `hanami/images/header.jpg`. The dimensions are 960 by 125 pixels. To replace the header image, create your new image and name it `header.jpg`. Delete the old `header.jpg` and upload your new `header.jpg` to the same directory as the old one.

   Back to Top

4. ## Special Formatting

   Hanami has a number of options for special formatting for your posts.

   ### Captions

   Adding a caption to an image requires the addition of a caption class to the paragraph, like so:

   `<p class="caption"> This is a photo of us at a picnic, the bears look hungry but were quite nice. </p>`

   If you are using the WordPress image uploader, you can also add captions through the media interface.

   ### Drop-Caps

   Drop-caps are used to make the first letter of a post larger than the rest of the body copy. To use drop-caps, place a span around the first letter of a post, like so:

   `<span class="dropcaps">O</span>nce upon a time...`

   ### Blockquotes

   Blockquotes are added by wrapping `<blockquote>` tags around a chunk of text. In addition to the normal blockquote formatting, Hanami supports the `<cite>` tag within the blockquote as a way to distinguish the source of the quote. To use this extra formatting, create your blockquote as usual, and then wrap the source of the quote in the `<cite>` tag, like so:

   `<blockquote> Money is better than poverty, if only for financial reasons. <cite> Woody Allen</cite></blockquote>`

   ### Post Thumbnails

   Hanami supports thumbnails at the beginning of a post. To use post thumbnails simply add a class to the `<img>` tag like so:

   `<img src="./images/thisismyimage.jpg" class="thumbnail" alt="" />`

   Back to Top

5. ## Questions, Comments, Feature Requests

   I'm always happy to get feedback, so feel free to shoot me a line or ten at `themes@andreamignolo.com`. It might take me a while to get back to you depending on my schedule, so please be patient!

   Back to Top

6. ## Special Thanks

   Special thanks to Scott Allan Wallick's inspirationally detailed readme files. They are incredibly awesome.

   Back to Top