Writing content

Creating a new page is easy:

  1. Open a new file in your editor.
  2. Enter some text (formatted as Markdown, Textile or Haml).
  3. Save the file in the content/pages/ directory with a .mdown, .textile or .haml extension.

There's slightly more to it than that, so let's look at some examples.

  1. Working with menus

    Menus are optional; not all themes will necessarily use a menu, and you don't have to fill it in if you don't want to. Having said that, if you do, you'll need to know what to do.

    Continue reading

  2. Metadata reference

    A full list of the Nesta metadata, which allows you to organise your site into categories and convert simple web pages into blog posts.

    Continue reading

Articles on Writing content

  1. Refresh the browser when you save a file

    Most of the pages on a Nesta site are written in a text editor, using Markdown or Textile. You don't get to see what your words look like on a web page you save the file to disk and reload your browser. Wouldn't it be nice if your browser automatically reloaded pages as you saved them? When designing a theme, what if changes to HTML and CSS were reloaded immediately?

    Continue reading

  2. Using a different Markdown processor

    There are a handful of Markdown processing libraries available for Ruby, each with different advantages and features. Since version 0.9.11, Nesta uses Ryan Tomayko's [Tilt][] library to work out which processor to use when rendering a file within your content folder, which will try and pick a suitable processor for you. This recipe shows you how to change it.

    Continue reading

  3. Adding author biographies to articles

    Imagine for a moment that you run a blog that frequently runs articles from guest bloggers. They provide the content, and in return get some publicity and a link back to their own site from the bottom of their article. What's the best way to do this with Nesta?

    Continue reading