nanoc Trac

Welcome to the Trac for nanoc! This trac contains a wiki as well as a bug tracker.

The wiki is a companion to the official nanoc site. You can find tips and tricks, sample sites, plugins, links to other nanoc-related sites, ... here. You're encouraged to add your own stuff, too—simply start writing!

Important: the repository has moved from Subversion to Mercurial (see this blog post for details) and Trac can no longer be used as a source code browser. Please use the Mercurial web interfaces instead.

Tips & Tricks

• Put a "last modified on/at" line on your site
• Enhancing your site typography
• Syntax-coloring your code
• Hiding pages
• Creating dynamic pages
• Previewing
• Adding header permalinks
• Using Sass
• Blogging
  • Creating an article template
• Rakefiles
  • Copying assets intelligently
  • Using an "upload" task
  • Using an omnipotent rakefile

Plugins

Most plugins are now bundled in the standard nanoc distribution. There are a few that aren't included (yet):

• Syntax coloring plugin

Samples

• The nanoc web site
• Stoneship

Also check out the showcase for a (small) list of nanoc-powered sites.

Contributing to this wiki

Feel free to add anything you want to this wiki, as long as it is relevant to nanoc. Please use the following namespaces for pages you create:

• Plugins/ for plugins (stuff you put in the lib directory)
• Samples/ for sample web sites (web sites whose source is publicly available)
• Tips/ for tips and tricks

Other resources

• English
  • The official site is no doubt the best resource for nanoc-related material.
  • Expanding the Power of nanoc with Rake is a useful resource for rake addicts.
  • Google group for discussion.
• Spanish
  • Maquetación Ágil con Ruby: nanoc y heel is a nanoc tutorial in the Spanish language by Ale Muñoz.
  • Maquetación Ágil con nanoc 2.1 is a more up-to-date version of the Spanish tutorial linked to above.
  • Spanish Google group for discussion in Spanish.