Readme files for example sites.

Author: ReFreezed

README.md

@@ -14,7 +14,7 @@
 Webpages are generated using HTML and Markdown *templates* with embedded Lua code.
 CSS files can also include code.
 
-[**Download latest release**](https://github.com/ReFreezed/LuaWebGen/releases/latest)
+[**>> Download latest release <<**](https://github.com/ReFreezed/LuaWebGen/releases/latest)
 
 - [Why?](#why)
 - [Example](#example)

examples/blog/README.txt

@@ -0,0 +1,20 @@
+Information
+Example Blog
+
+Blog posts are stored in content/posts/, categorized in subfolders by year and
+month. It doesn't matter how/if they're categorized, but this format is pretty
+common for blogs. All blog post pages specify that they should use the
+"blogPost" layout.
+
+The homepage, content/index.html, loops through all pages under the
+content/posts/ folder and shows a truncated version of them. Both this index
+file and the "blogPost" layout include the "_blogPost" layout which generates
+the actual HTML for the given blog post.
+
+We have given the "partial" layouts for this site a filename that starts with
+an underscore. It's a good idea to separate layouts that pages can use, and
+layouts used by other layouts. The "_header" and "_footer" layouts are both
+included by both the "blogPost" layout and the default "page" layout.
+
+The "_header" layout does a similar thing as the homepage - it loops through
+all posts and creates a small menu with links to each one.

examples/minimal/README.txt

@@ -0,0 +1,5 @@
+Information
+Minimal Example
+
+This site only has a single, pretty bare, page - the homepage. It uses uses a
+very simple layout.

examples/minimal/config.lua

@@ -1,4 +1,4 @@
 return {
 	title   = "Minimal Example Website",
-	baseUrl = "http://example.com/",
+	baseUrl = "http://minimal.example/",
 }

examples/testsite/README.txt

@@ -0,0 +1,4 @@
+Information
+Test site
+
+This site contains a bunch of random things used for testing purposes!

src/app.lua2p

@@ -1061,7 +1061,7 @@ local function setup()
 			scriptEnvironmentGlobals.echoRaw(s:format(...))
 		end,
 
-		include = function(htmlFileBasename, ...)
+		include = function(htmlFileBasename, ...) -- @Doc: Extra arguments.
 			assertContext("template", "include")
 			if htmlFileBasename:find"^/" then
 				errorf(2, "Filename is not valid: %s", htmlFileBasename)