rethoth 0.4.1

data/lib/thoth/public/js/thoth.js

@@ -0,0 +1,203 @@
+var Thoth = function () {
+  // Shorthand.
+  var d   = document,
+      Y   = YAHOO,
+      yut = Y.util,
+      yud = yut.Dom,
+      yue = yut.Event;
+
+  // -- Constants --------------------------------------------------------------
+
+  /**
+   * URLs for lazy-loaded JavaScript dependencies.
+   *
+   * @const js
+   * @type Object
+   * @private
+   */
+  var js = {
+    thoth: {
+      comments   : '/js/admin/comments.js',
+      name       : '/js/admin/name.js',
+      tagcomplete: '/js/admin/tagcomplete.js'
+    },
+    yui: {
+      anim     : 'http://yui.yahooapis.com/2.8.0/build/animation/animation-min.js',
+      conn_json: 'http://yui.yahooapis.com/combo?2.8.0/build/connection/connection-min.js&2.8.0/build/json/json-min.js'
+    }
+  };
+
+  // -- Private Variables ------------------------------------------------------
+  var hotKeys = {},
+      next, prev, token;
+
+  // -- Private Methods --------------------------------------------------------
+
+  /**
+   * Attaches keyboard shortcut event listeners.
+   *
+   * @method attachKeys
+   * @private
+   */
+  function attachKeys() {
+    var inputs    = d.body.getElementsByTagName('input'),
+        selects   = d.body.getElementsByTagName('select'),
+        textareas = d.body.getElementsByTagName('textarea');
+
+    next = yud.get('next_url');
+    prev = yud.get('prev_url');
+
+    hotKeys.ctrl_alt_a = new yut.KeyListener(d,
+        { ctrl: true, alt: true, keys: 65 }, Thoth.toggleAdminToolbar);
+
+    hotKeys.n = new yut.KeyListener(d, { keys: 78 }, handleKeyNext);
+    hotKeys.p = new yut.KeyListener(d, { keys: 80 }, handleKeyPrev);
+
+    // Stop listening for hotkeys when a form element gets focus.
+    yue.on(inputs, 'blur', enableKeys, Thoth, true);
+    yue.on(inputs, 'focus', disableKeys, Thoth, true);
+    yue.on(selects, 'blur', enableKeys, Thoth, true);
+    yue.on(selects, 'focus', disableKeys, Thoth, true);
+    yue.on(textareas, 'blur', enableKeys, Thoth, true);
+    yue.on(textareas, 'focus', disableKeys, Thoth, true);
+
+    enableKeys();
+  }
+
+  /**
+   * Disables all key listeners.
+   *
+   * @method disableKeys
+   * @private
+   */
+  function disableKeys() {
+    var key;
+
+    for (key in hotKeys) {
+      if (hotKeys.hasOwnProperty(key) && key !== 'ctrl_alt_a') {
+        hotKeys[key].disable();
+      }
+    }
+  }
+
+  /**
+   * Enables all key listeners.
+   *
+   * @method enableKeys
+   * @private
+   */
+  function enableKeys() {
+    var key;
+
+    for (key in hotKeys) {
+      if (hotKeys.hasOwnProperty(key)) {
+        hotKeys[key].enable();
+      }
+    }
+  }
+
+  // -- Private Event Handlers -------------------------------------------------
+
+  /**
+   * Handles the "next page" keyboard shortcut.
+   *
+   * @method handleKeyNext
+   * @private
+   */
+  function handleKeyNext() {
+    if (next) {
+      window.location = next.href;
+    }
+  }
+
+  /**
+   * Handles the "previous page" keyboard shortcut.
+   *
+   * @method handleKeyPrev
+   * @private
+   */
+  function handleKeyPrev() {
+    if (prev) {
+      window.location = prev.href;
+    }
+  }
+
+  return {
+    // -- Constants ------------------------------------------------------------
+
+    /**
+     * URLs for lazy-loaded JavaScript dependencies.
+     *
+     * @const js
+     * @type Object
+     */
+    js: js,
+
+    // -- Public Methods -------------------------------------------------------
+
+    /**
+     * Initializes the Thoth module.
+     *
+     * @method init
+     * @param {Boolean} admin (optional) whether or not we're in admin mode
+     * @param {String} formToken (optional) admin form token for this request
+     */
+    init: function (admin, formToken) {
+      var load = [];
+
+      attachKeys();
+
+      if (admin) {
+        token = formToken;
+
+        // Load the Name module if this page contains one or more name input
+        // elements.
+        if (yud.get('page-form') || yud.get('post-form')) {
+          load.push(js.thoth.name);
+        }
+
+        // Load the TagComplete module if this page contains one or more tag
+        // input elements.
+        if (yud.get('post-form')) {
+          load.push(js.thoth.tagcomplete);
+        }
+
+        // Load the Comments module if this page contains comments.
+        if (yud.get('comments')) {
+          load.push(js.thoth.comments);
+        }
+
+        if (load.length) {
+          load.unshift(js.yui.conn_json);
+          LazyLoad.js(load);
+        }
+      }
+    },
+
+    /**
+     * Gets the administrator form token for this request, if any.
+     *
+     * @method getToken
+     * @return {String|null} form token, or <i>null</i> if user is not an admin
+     */
+    getToken: function () {
+      return token;
+    },
+
+    /**
+     * Toggles the visibility of the admin toolbar.
+     *
+     * @method toggleAdminToolbar
+     */
+    toggleAdminToolbar: function () {
+      var toolbar  = yud.get('adminToolbar'),
+          username = yud.get('username');
+
+      if (yud.addClass(toolbar, 'hidden')) {
+        if (username) { username.blur(); }
+      } else if (yud.removeClass(toolbar, 'hidden')) {
+        if (username) { username.focus(); }
+      }
+    }
+  };
+}();

data/lib/thoth/public/robots.txt

@@ -0,0 +1,5 @@
+# robots.txt file for Thoth
+
+User-agent: *
+Disallow: /comment/new
+Disallow: /search

data/lib/thoth/version.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2017 John Pagonis <john@pagonis.org>
+# Copyright (c) 2010 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+module Thoth
+  APP_NAME      = 'Rethoth'
+  APP_VERSION   = '0.4.1'
+  APP_AUTHORS   = ['John Pagonis' ,'Ryan Grove']
+  APP_EMAIL     = 'john@pagonis.org'
+  APP_URL       = 'https://github.com/pagojo/rethoth'
+  APP_COPYRIGHT = 'Copyright (c) 2009 - 2012 Ryan Grove <ryan@wonko.com>,  2017 John Pagonis <john@pagonis.org>. All rights reserved.'
+end

data/lib/thoth/view/admin/index.rhtml

@@ -0,0 +1 @@
+<%= Thoth::AdminController.render_view(auth_key_valid? ? :welcome : :login) %>

data/lib/thoth/view/admin/login.rhtml

@@ -0,0 +1,23 @@
+<h2>Login</h2>
+
+<% if flash[:login_error] %>
+  <div class="flash error"><%== flash[:login_error] %></div>
+<% end %>
+
+<form id="login_page" action="<%= Thoth::AdminController.r(:login) %>" method="post">
+  <p>
+    <label for="username">Username</label><br />
+    <input type="text" name="username" id="username" maxlength="255"
+        tabindex="1" />
+  </p>
+
+  <p>
+    <label for="password">Password</label><br />
+    <input type="password" name="password" id="password" maxlength="255"
+        tabindex="2" />
+  </p>
+
+  <p>
+    <input type="submit" value="Login" tabindex="3" />
+  </p>
+</form>

data/lib/thoth/view/admin/toolbar.rhtml

@@ -0,0 +1,117 @@
+<div id="adminToolbar" class="toolbar robots-nocontent<%= ' hidden' unless auth_key_valid? %>">
+  <% if auth_key_valid? %>
+    <ul class="edit">
+      <li>
+        <a href="<%= Thoth::PostController.r(:new) %>"
+            title="Create a new blog post">
+          <span class="adminicon post-new"></span>
+        </a>
+      </li>
+
+      <% if @show_post_edit && @post %>
+        <li>
+          <a href="<%= Thoth::PostController.r(:edit, @post.id) %>#post-form"
+              title="Edit this blog post">
+            <span class="adminicon post-edit"></span>
+          </a>
+        </li>
+
+        <li>
+          <a href="<%= Thoth::PostController.r(:delete, @post.id) %>"
+              title="Delete this blog post">
+            <span class="adminicon post-delete"></span>
+          </a>
+        </li>
+      <% end %>
+
+      <li>
+        <a href="<%= Thoth::PageController.r(:new) %>"
+            title="Create a new page">
+          <span class="adminicon page-new"></span>
+        </a>
+      </li>
+
+      <% if @show_page_edit && @page %>
+        <li>
+          <a href="<%= Thoth::PageController.r(:edit, @page.id) %>#page-form"
+              title="Edit this page">
+            <span class="adminicon page-edit"></span>
+          </a>
+        </li>
+
+        <li>
+          <a href="<%= Thoth::PageController.r(:delete, @page.id) %>"
+              title="Delete this page">
+            <span class="adminicon page-delete"></span>
+          </a>
+        </li>
+      <% end %>
+
+      <li>
+        <a href="<%= Thoth::MediaController.r(:new) %>" title="Upload media">
+          <span class="adminicon media-new"></span>
+        </a>
+      </li>
+
+      <% if @show_file_edit && @file %>
+        <li>
+          <a href="<%= Thoth::MediaController.r(:delete, @file.id) %>"
+              title="Delete this file">
+            <span class="adminicon media-delete"></span>
+          </a>
+        </li>
+      <% end %>
+    </ul>
+
+    <ul class="tools">
+      <li>
+        <a href="<%= Thoth::PostController.r(:list) %>" title="List all blog posts and drafts">
+          <span class="adminicon post-list"></span>
+        </a>
+      </li>
+
+      <li>
+        <a href="<%= Thoth::PageController.r(:list) %>" title="List all pages">
+          <span class="adminicon page-list"></span>
+        </a>
+      </li>
+
+      <% if Thoth::Config.site['enable_comments'] %>
+        <li>
+          <a href="<%= Thoth::CommentController.r(:list) %>" title="List all comments">
+            <span class="adminicon comment-list"></span>
+          </a>
+        </li>
+      <% end %>
+
+      <li>
+        <a href="<%= Thoth::MediaController.r(:list) %>" title="List all media">
+          <span class="adminicon media-list"></span>
+        </a>
+      </li>
+    </ul>
+
+    <ul class="tools">
+      <li>
+        <a href="<%= Thoth::AdminController.r(:logout) %>" title="Log out">
+          <span class="adminicon logout"></span>
+        </a>
+      </li>
+    </ul>
+
+  <% else %>
+    <form id="login" action="<%= Thoth::AdminController.r(:login) %>" method="post">
+      <div>
+        <label for="username">Username:</label>
+        <input type="text" id="username" name="username" maxlength="64"
+            title="Enter your username" />
+
+        <label for="password">Password:</label>
+        <input type="password" id="password" name="password" maxlength="64"
+            title="Enter your password" />
+
+        <input type="submit" value="Login" />
+      </div>
+    </form>
+  <% end %>
+</div>

data/lib/thoth/view/admin/welcome.rhtml

@@ -0,0 +1,58 @@
+<div class="welcome">
+  <h2>Welcome to Thoth!</h2>
+  <span class="version">Version <%== Thoth::APP_VERSION %></span>
+
+  <h4>Getting Started</h4>
+
+  <p>
+    Use the icons in the admin toolbar above to create new blog posts and pages.
+    To edit an existing blog post or page, simply browse to it and an edit icon
+    will appear in the toolbar.
+  </p>
+
+  <p>
+    When you want to login again in the future, you can either return to
+    <a href="<%= rs() %>">this page</a> or use the keyboard shortcut
+    <kbd>Ctrl+Alt+A</kbd> to login quickly from any Thoth URL.
+  </p>
+
+  <h4>Customizing Thoth</h4>
+
+  <p>
+    Tired of the default template and want to design your own? Just fire up your
+    favorite text editor and open up these directories:
+  </p>
+
+  <dl class="customizing">
+    <dt>Default Views</dt>
+    <dd><code><%== @view_root %></code></dd>
+    <dt>Default CSS, JS, etc.</dt>
+    <dd><code><%== @public_root %></code></dd>
+
+    <dt>Custom Views</dt>
+    <dd><code><%== File.join(Thoth::HOME_DIR, 'view') %></code></dd>
+    <dt>Custom CSS, JS, etc.</dt>
+    <dd><code><%== File.join(Thoth::HOME_DIR, 'public') %></code></dd>
+  </dl>
+
+  <p>
+    To customise your blog, find the default view or static resource you
+    want to change and copy it to the corresponding custom directory, then make
+    your changes to the copy. Thoth looks for a customised file first, then
+    loads the default file if no customised version is found.
+  </p>
+
+  <p>
+    You'll need to know some XHTML and CSS (and a wee touch of Ruby wouldn't
+    hurt), but you should be able to figure it out. You seem like a smart sort
+    of bean.
+  </p>
+
+  <h4>Useful Linkage</h4>
+
+  <ul>
+    <li><a href="<%== Thoth::APP_URL %>">Thoth Website</a></li>
+    <li><a href="https://github.com/pagojo/rethoth/wiki">Thoth Wiki</a></li>
+    <li><a href="http://github.com/pagojo/rethoth/tree/master">Source Code</a></li>
+  </ul>
+</div>

data/lib/thoth/view/archive/index.rhtml

@@ -0,0 +1,24 @@
+<h2>Archived Posts</h2>
+
+<p class="robots-nocontent">
+  Displaying posts
+  <strong><%== @pager.current_page_record_range.first %></strong> -
+  <strong><%== @pager.current_page_record_range.last %></strong> of
+  <strong><%== @pager.record_count %></strong>
+</p>
+
+<%=
+Thoth::MainController.render_view('util/pager',
+    :prev_text => '&laquo; Newer stuff',
+    :next_text => 'Older stuff &raquo;')
+%>
+
+<% @posts.all do |post| %>
+  <%= Thoth::PostController.render_view(:compact, :post => post) %>
+<% end %>
+
+<%=
+Thoth::MainController.render_view('util/pager',
+    :prev_text => '&laquo; Newer stuff',
+    :next_text => 'Older stuff &raquo;')
+%>

data/lib/thoth/view/comment/comment.rhtml

@@ -0,0 +1,47 @@
+<div id="comment-<%= @comment.id %>" class="comment">
+  <div class="hd">
+    <% unless @comment.title.empty? %>
+      <h4>
+        <a href="<%== @comment.relative_url %>"><%== @comment.title %></a>
+      </h4>
+    <% end %>
+
+    <% if auth_key_valid? && !@comment.new? %>
+      <div class="toolbar mini">
+        <ul>
+          <li>
+            <a href="<%= Thoth::CommentController.r(:delete, @comment.id) %>"
+                title="Delete this comment">
+              <span class="adminicon comment-delete"></span>
+            </a>
+          </li>
+        </ul>
+      </div>
+    <% end %>
+  </div>
+
+  <div class="bd">
+    <%= @comment.body_rendered %>
+  </div>
+
+  <div class="ft">
+    <% if Thoth::Config.site['gravatar']['enabled'] && @comment.gravatar_url %>
+      <a class="gravatar" href="http://www.gravatar.com/" rel="nofollow"><img
+          src="<%== @comment.gravatar_url %>" alt="Gravatar icon" /></a>
+    <% end %>
+    <div class="author">
+      <% if @comment.author_url.empty? %>
+        <%== @comment.author %>
+      <% else %>
+        <a href="<%== @comment.author_url %>" rel="nofollow">
+          <%== @comment.author %>
+        </a>
+      <% end %>
+    </div>
+    <div class="date robots-nocontent">
+      <a href="<%== @comment.relative_url %>">
+        <%= @comment.created_at(Thoth::Config.timestamp['long']) %>
+      </a>
+    </div>
+  </div>
+</div>

data/lib/thoth/view/comment/delete.rhtml

@@ -0,0 +1,15 @@
+<h2>Delete Comment</h2>
+
+<p>
+  Are you sure you want to permanently delete the following comment?
+</p>
+
+<%= Thoth::CommentController.render_view(:comment, :comment => @comment) %>
+
+<form action="<%= Thoth::CommentController.r(:delete, @comment.id) %>" method="post">
+  <p>
+    <input type="hidden" name="token" value="<%== form_token %>" />
+    <button name="confirm" value="yes">Yes, delete this comment forever</button>
+    <button name="confirm" value="no">No, do not delete this comment</button>
+  </p>
+</form>

data/lib/thoth/view/comment/form.rhtml

@@ -0,0 +1,81 @@
+<form id="post-comment" class="robots-nocontent" method="post" action="<%== @form_action %>">
+
+  <% if @comment && @comment.valid? %>
+    <fieldset>
+      <%= Thoth::CommentController.render_view(:comment, :comment => @comment) %>
+    </fieldset>
+  <% end %>
+
+  <fieldset>
+    <legend>New comment</legend>
+
+    <p>
+      <label for="author">Name</label>
+      <input type="text" name="author" id="author" maxlength="32"
+          title="Enter your name" value="<%== @author %>" />
+    </p>
+
+    <% if @comment; @comment.errors.on_field(:author).each do |error| %>
+      <div class="flash error"><%== error %></div>
+    <% end; end %>
+
+    <p>
+      <label for="author_email">Email</label>
+      <input type="text" name="author_email" id="author_email" maxlength="255"
+          title="Enter your email address" value="<%== @author_email %>" />
+      <span class="tip">required, won't be displayed (but may be used for Gravatar)</span>
+    </p>
+
+    <% if @comment; @comment.errors.on_field(:author_email).each do |error| %>
+      <div class="flash error"><%== error %></div>
+    <% end; end %>
+
+    <p>
+      <label for="author_url">Website</label>
+      <input type="text" name="author_url" id="author_url" maxlength="255"
+          title="Enter the URL of your website (optional)"
+          value="<%== @author_url %>" />
+      <span class="tip">optional</span>
+    </p>
+
+    <% if @comment; @comment.errors.on_field(:author_url).each do |error| %>
+      <div class="flash error"><%== error %></div>
+    <% end; end %>
+
+    <p>
+      <textarea name="body" rows="15" cols="60"><%== @comment && @comment.body ? @comment.body : '' %></textarea>
+    </p>
+
+    <% if @comment; @comment.errors.on_field(:body).each do |error| %>
+      <div class="flash error"><%== error %></div>
+    <% end; end %>
+
+    <p class="noseeum">
+      Don't type anything here unless you're an evil robot:<br />
+      <input type="text" id="captcha" name="captcha" maxlength="50" />
+
+      <br /><br />
+      And especially don't type anything here:<br />
+      <textarea name="comment" rows="6" cols="60"></textarea>
+    </p>
+
+    <% if @comment_error %>
+      <div class="flash error"><%== @comment_error %></div>
+    <% end %>
+
+    <p>
+      <input type="submit" name="action" value="Preview Comment" />
+      <input type="submit" name="action" value="Post Comment" />
+      <input type="hidden" name="post_id" value="<%== @post.id %>" />
+      <input type="hidden" name="comment_id"
+          value="<%== @comment && @comment.id ? @comment.id : '' %>" />
+    </p>
+
+    <p class="tip">
+      Basic HTML (including links) is allowed, just don't try anything fishy.
+      Your comment will be auto-formatted unless you use your own
+      <code>&lt;p&gt;</code> tags for formatting. You're also welcome to use
+      <a href="http://redcloth.org/textile" target="_blank">Textile</a>.
+    </p>
+  </fieldset>
+</form>