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