[ANN] Rassmalog 12.0.0

Rassmalog is a static blog engine based on YAML, eRuby,
  and Rake. It transforms blog entries written in Textile
  or other formatting systems into valid XHTML files that
  you can view on your computer or upload to your website.

              http://rassmalog.rubyforge.org

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

HTML version of this release announcement is available here:
http://snk.rubyforge.org/web/2008-07-31-version-12-0-0.html

Version 12.0.0

Contents

  • 1 Caution
      □ 1.1 Entries
      □ 1.2 Configuration
  • 2 Features
  • 3 Repairs

This release features a redesigned user-interface that
improves navigability in graphical and text-mode web
browsers alike, localizes almost all of Rassmalog’s output
via translation files, and revisits the philosophies of
KISS, DRY, and YAGNI.

1 Caution

1.1 Entries

  • The text parameter in blog entry files has been renamed
    to body. You can update your existing blog entries by
    running the following command inside your Rassmalog
    installation directory:

    find entries/ input/ -name '*.yaml' -print0 |
    xargs -0 sed -i 's,^text:,body:,'

  • RedCloth 4.0.x is now required by the default
    implementation of config/format.rb. This version of
    RedCloth introduces the following incompatibilites
    because, unlike the previous 3.0.4 version, it no
    longer supports Markdown syntax:
      □ Lines indented by two or more spaces are no longer
        converted into a preformatted block (<pre>).
      □ The depth of a list item (<li>) is no longer
        influenced by the level of indentation.
      □ Four or more consequtive hyphens are no longer
        converted into a horizontal rule (<hr>).
      □ Line breaks are now converted into <br/> directly.
        So do not “hard wrap” your lines to a fixed number
        of columns, but instead write each paragraph as one
        long line and configure your text editor to perform
        “soft” word wrapping for readability.
      □ and so on…

1.2 Configuration

  • config/format.rb is now required to implement a String#
    to_inline_html method, which converts the string into a
    HTML expression composed of inline content (as opposed
    to block-level elements at the root of the expression).

  • In the config/blog.yaml blog configuration file:
      □ The following parameters have been removed:
          ☆ links — You can create custom menus in the
            input/about.yaml about page instead.
          ☆ new_entries — The “new entries” list has been
            removed. Instead, the default behavior is now
            to take the visitor directly to the newest
            entry in the blog (see entrance parameter
            below).
          ☆ summarize_entries — Entries are now always
            summarized in lists. You can still control
            whether they are summarized in RSS feeds via
            the last parameter of the feed method.
      □ The front_page parameter has been renamed to
        entrance. The default value of this parameter takes
        the visitor directly to the single newest entry in
        your blog, rather than to a listing of n newest
        blog entries.

  • Translation files for the Indonesian, Norwegian,
    Swedish, and Taiwanese languages have been removed
    because the new machine translation service I am using
    does not support translation of English text into those
    languages. Please do not be alarmed at this decision,
    for these particular files have always been the result
    of machine translation; no human has yet contributed
    corrections for them.

2 Features

  • More icons, less text.

  • Simple, consistent navigation.

  • Improved CSS styles for printing (and print preview).

  • Added instructions for using a Javascript-based
    commenting system into the user guide.

  • All English phrases emitted by Rassmalog are now
    translated using the LANG#[] facility, with the
    exception of input/search.yaml and input/about.yaml. So
    you no longer need to edit templates and such in order
    to localize Rassmalog: simply create or edit a
    translation file and update the language parameter in
    your blog configuration file accordingly.

  • An about page (found at input/about.yaml) has been
    added to the default configuration.

3 Repairs

  • Incorrect URLs were generated in config/feed.erb if the
    url parameter in the blog configuration file lacks a
    trailing slash.

  • Cleansed the CSS styles by removing unnecessary cruft
    and refactoring common styles between the screen.css
    and print.css into common.css.

Date 2008 July 31, Thursday 09:49 PM
Tags project · rassmalog
Comments You may send comments by e-mail.

···

--
Posted via http://www.ruby-forum.com/.