sbt/sbt.github.com — pull request #15 by harrah (2012-02-26 23:05:36+00:00)
Title: Howto pages

The purpose of this branch is to add a set of pages following up the getting started guide. The main howto.md page pulls content from the topic howto pages into an index. This index is organized by category and then by a specific question. Often, there is a quick example answer for the specific question, but the question links to the full answer on the topic page. The current scope of the howto is mainly configuring the default tasks and settings and using the default commands.

There were several problems I encountered:

- Scala source highlighting is unreadable. A simpler, higher contrast scheme would be an improvement.
- Related, `{% highlight console %}` is unreadable because of a lack of contrast.
- Various formatting is disabled or messed up. See lists, inline code, and `h3/###`, for example. Adding standard markdown (like lists) should render normally without needing to modify the stylesheets.
- The individual howto pages should be single column. I know this is configured in the stylesheets, but I don't know how to do it
- I had to switch to rdiscount because maruku interprets markup in code blocks, which is not good for Scala code like `something[NotATitle](not.aLink)`
- Links, including css, should be root relative so that layouts and includes work for pages not in the root directory (like `howto/*.md`). The downside is that this requires running jekyll in order to preview the site.