S
Suraj Kurapati
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.
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.