README.rdoc in serious-0.2.2 vs README.rdoc in serious-0.2.3
- old
+ new
@@ -54,11 +54,13 @@
The directory basic directory structure of your Serious site would be something like this:
serious_blog/
- articles
- - articles/2010-02-14-will-you-be-my-valentine.txt
+ - 2010-02-14-will-you-be-my-valentine.txt
+ - pages
+ - about.txt
- config.ru
- .gems
- Rakefile
The config.ru is pretty straight-forward if you want to stick to the defaults:
@@ -71,18 +73,15 @@
The .gems file if you want to host on heroku:
serious
-Note that sinatra is not included in the gemfile since heroku has it installed by default, but serious
-will install it as a gem dependency on other systems as well.
+The Rakefile, which is obviously totally optional but highly recommended looks like this:
-The Rakefile, which is obviously totally optional but highly recommended.
-
require 'serious'
require 'serious/tasks'
-
+
== Creating heroku app manually
Assuming you've got the heroku gem installed and set up and you've set up git for your blog with
<code>git init</code> or sticked with the generator, which created your git repo, you can now do:
@@ -105,9 +104,17 @@
== Archives
The whole archives can be accessed at <code>/archives</code>. Archives by year, month and date
are available at <code>/2009</code> (all of 2009), <code>/2009/05</code> (May 2009),
<code>/2009/05/15</code> (May 15th 2009).
+
+== Static pages
+
+Static pages are quite similar to blog articles, in that their formatting and processing is the same.
+They have a yaml front matter, content that gets piped through the StupidFormatter and so on.
+The filename sans the extension serves as the permalink, pages can be reached via
+<code>/pages/PERMALINK</code>, so the content in pages/about.txt will be served at
+<code>/pages/about</code>
== Rake tasks
If you've set up the Rakefile in your site's main directory like mentioned above (this happens
automatically when generating with the <code>serious</code> executable), you have the following