Creating a new design
If you want to create your own design you have two choices:
- Copy all the templates into your project (see the previous page), or
- Start from scratch.
This page is about starting from scratch.
Make yourself a
views directory in which to store your templates:
$ cd mysite.com $ mkdir -p views
The minimum files that you need are:
views/your-stylesheet.sass(call it whatever you like)
NOTE: We're using
.sass files in this example. If
you'd rather use different templating engines you can do, but you'll
need to follow the instructions on changing the templating
engine in order for them to work.
Build up your HTML and CSS as you go. As a rough guide you ought to put
any content that will appear on every page on your site in
layout.haml, and any content that only appears on some of your pages
page.haml. You can create alternative templates for different kinds
of page (e.g.
article.haml) and insert them into the same layout.
At some point your
layout.haml file should call
yield, which is
where the contents of
page.haml will be inserted. The
file needs to call the
@page.to_html(self) method to convert your
Markdown/Textile text into HTML.
Link to your stylesheet from within the layout (CSS files are
automatically created from Sass files when a page is loaded), and are
served up from
Drop your static assets (e.g. images) in the
public folder. If you
create a folder called
public/images then its contents will be
available at URLs like