Initial checkin: basic functionality

Currently uses fixed replace-strings as opposed to a templating
engine: this requires a lot of polishing.  Posting from email is a
planned feature.

Author: artagnon

.gitignore

@@ -0,0 +1,2 @@
+*~
+imap-settings.private

README.md

@@ -0,0 +1,37 @@
+# clayoven
+
+An extremely simple website generator that operates on a very specific
+kind of repository.  It has no dependencies, and hand-parses
+everything using regular expressions.  Posts can optionally posted via
+email.
+
+## Repository format
+
+* There are two kinds of pages: index pages and content pages.  Index
+  pages are toplevel pages and (optionally) contain links to
+  corresponding content pages.  To specify which pages should go under
+  which "topic" (or index), content page filenames must look like
+  `<topic>:<permalink>`.
+
+* To generate HTML from the index and content files, the repository
+  should contain `design/template.index.html` (for index pages) and
+  `design/template.html` (for content pages).
+
+* Both index and content pages conform to the same format.  The first
+  line of file contains the title, followed by the body which is
+  intended to be enclosed in a \<pre\> (you can change this in your
+  template) pepper with [\d+] markers referring to links in the
+  footer.  The footer should contain "[\d+]: \<link\>" lines.  The
+  links will be turned into clickable links.
+
+## Posting via email
+
+clayoven includes clayovend, a daemon which constantly polls an IMAP
+server for new emails.  Copy `imap-settings.template` to
+`imap-settings.private` and configure.  The subject of the email
+should be suffixed with "# \<permalink\>".
+
+## Contributing
+
+Open issues and send pull requests on GitHub.  You can optionally
+email the author your patches, if you prefer that.

clayoven.rb

@@ -0,0 +1,79 @@
+def escape_htmlspecialchars(content)
+  # see: http://php.net/htmlspecialchars
+  replaces = {
+    "&" => "&",
+    "\"" => """,
+    "'" => "'",
+    "<" => "&lt;",
+    ">" => "&gt;"
+  }
+  replaces.each { |key, value| content.gsub!(key, value) }
+  content
+end
+
+def anchor_footerlinks(footer)
+  footer.gsub!(/^(\[\d+\]:) (.*)/, '\1 <a href="\2">\2</a>')
+end
+
+def main
+  # First, make sure that the required files are present
+  all_files = (Dir.entries(".") - [".", "..", "design", ".git"]).reject { |file|
+    /\.html$/ =~ file
+  }
+  if not all_files.include? "index"
+    puts "error: index file not found; aborting"
+    exit 1
+  end
+
+  ["template.index.html", "template.html"].each { |file|
+    if not Dir.entries("design").include? file
+      puts "error: design/#{file} file not found; aborting"
+      exit 1
+    end
+  }
+
+  # Next, look for stray files
+  index_files = ["index"] + all_files.select { |file| /\.index/ =~ file }
+  topics = index_files.map { |file| file.split(".index")[0] }
+  content_files = all_files - index_files
+  (content_files.reject { |file| topics.include? (file.split(":", 2)[0]) })
+    .each { |stray_file|
+    content_files = content_files - [stray_file]
+    puts "warning: #{stray_file} is a stray file; ignored"
+  }
+
+  # Generate all the pages
+  (index_files + content_files).each { |file|
+    if file == "index"
+      target = "index.html"
+      permalink = file
+      template = IO.read("design/template.index.html")
+    elsif index_files.include? file
+      target = file.sub(".index", ".html")
+      permalink = file.split(".index")[0]
+      template = IO.read("design/template.index.html")
+    else
+      target = "#{file.split(':', 2)[1]}.html"
+      permalink = file.split(":", 2)[0]
+      template = IO.read("design/template.html")
+    end
+    content = escape_htmlspecialchars(IO.read file)
+    title, rest = content.split("\n\n", 2)
+    begin
+      # Optional footer
+      body, partial_footer = rest.split("\n\n[1]: ", 2)
+      footer = "\n\n[1]: #{partial_footer}"
+    rescue
+    end
+    anchor_footerlinks footer if footer
+    ["permalink", "title", "body", "footer"].each { |template_var|
+      template.gsub!("\{% #{template_var} %\}", eval(template_var))
+    }
+    File.open(target, mode="w") { |targetio|
+      nbytes = targetio.write(template)
+      puts "[GEN] #{target} (#{nbytes} bytes out)"
+    }
+  }
+end
+
+main

clayovend.rb

@@ -0,0 +1,7 @@
+imap = Net::IMAP.new('mail.example.com')
+imap.authenticate('LOGIN', 'joe_user', 'joes_password')
+imap.examine('INBOX')
+imap.search(["RECENT"]).each do |message_id|
+  envelope = imap.fetch(message_id, "ENVELOPE")[0].attr["ENVELOPE"]
+  puts "#{envelope.from[0].name}: \t#{envelope.subject}"
+end

imap-settings.template

@@ -0,0 +1,4 @@
+username: publish@artagnon.com
+password: 
+server: imap.gmail.com
+port: 993