Subtext 1.5 Nautilus R and R Edition Released!

0 comments suggest edit

IMPORTANT UPDATE: There was a security bug in Subtext 1.5 for multiblog setups that will allow the admin of one blog to login to another blog. If you are only using a single blog setup, you have nothing to worry about. For multiblog setups, please upgrade to Subtext 1.5.1. The change is a single line change in Subtext.Framework.dll so if you have already upgraded to Subtext 1.5, you can simply copy over the old Subtext.Framework.dll file with the new one instead of copying every file from the installation package. Sorry for the the inconvenience. Download Subtext 1.5.1.

Subtext Logo After much hard work, the Subtext team is proud to announce the release of Subtext 1.5, dubbed the Nautilus R&R Edition. This is primarily a bugfix release with a load of bug fixes, but there are a couple of significant new features as well as a bit of developer candy thrown in.

Release Notes

Rather than list all the bug fixes and new features here, I will point you to the release notes published online.

I will point out a few key changes.


Subtext now supports an HtmlEditorProvider. You can swap out the html editor used in the admin section by implementing a provider for your editor of choice. Providers that ship with Subtext include the FreeTextBoxProvider (default), FCKeditorProvider, and PlainTextProvider for you angle bracket jockeys.

For more information on how to change the text editor, read this.

Javascript BlogInfo object

By default now, Subtext emits a javascript object useful for client scripts to access information about the blog. This object is intentionally simple, but may be expanded as needed. The variable name for this object is subtextBlogInfo. The following is an example of its usage.

var imagesPath = subtextBlogInfo.getImagesVirtualRoot();

Improved Skin configuration {.clear}

If you write custom skins, the Skins.config file has a few new features. Here is a sample skin configuration that highlights several new features.

<SkinTemplate SkinID="Haackify" Skin="Haackify">
        <Script Src="~/Admin/Resources/Scripts/niceForms.js" />
        <Script Src="~/scripts/lightbox.js" />
        <Script Src="~/scripts/XFNHighlighter.js" />
        <Script Src="~/scripts/ExternalLinks.js" />
        <Script Src="~/scripts/LiveCommentPreview.js" />
        <Script Src="~/scripts/AmazonTooltips.js" />
        <Style href="~/scripts/XFNHighlighter.css" />
        <Style href="~/scripts/lightbox.css" />
        <Style href="niceforms-default.css" />
        <Style href="print.css" media="print" />

Notice that you can reference files using the tilde (~) syntax. Subtext now comes with several script files in the base Scripts directory that can be shared across skins. For example, if you want to add the LightBox JS effect to your skin, just reference the ~/scripts/lightbox.js in the Script section and the ~/scripts/lightbox.css section in the Style section as in the above example.

The root Scripts directory is a central repository for Subtext client script files that are accessible to all skins. Typically skins will include their own scripts. But occasionally the Subtext team will make popular scripts available to all skins. Some of these scripts have been modified to use the subtextBlogInfo object mentioned before.

Also notice that Style elements may now specifa a media. Thus you can add a stylesheet to a skin specifically for printing.

New Skins and Skin Controls

Checkout the new Submarine skin designed by our friends at TurboMilk. We have also added several new skin controls such as the Previous Next control which renders a link to the previous and next blog post. Note that not every blog uses every skin control, but it is quite easy to add such a control to the skin of your choice.

CSS Based Printing

Nearly every skin in Subtext now implements CSS based printing.

Upgrading from Subtext 1.0

Subtext 1.5 has an automatic web-based upgrade wizard that will upgrade your schema and stored procedures if you are currently running Subtext 1.0. We have made changes to web.config so if you have made any customizations, you will need to merge these changes yourself which should not be too hard. Please read the upgrade instructions carefully before upgrading.

If you are uncomfortable upgrading your database schema automatically, you can try the manual schema upgrade process outlined here. The steps in that process are the same ones that the automatic wizard takes on your behalf.


If you are installing Subtext for the first time, the web-based installation works as before. Just follow the instructions here.

Next Stop, Daedelus!

The next version of Subtext is code named Daedelus. It will simply be a straight upgrade to ASP.NET 2.0. We hope for a quick turnaround as we don’t plan to add a lot of features in this iteration. We just want to get up and running in ASP.NET 2.0. Afterwards we will start heavy work on Subtext 2.0 Poseidon. This will be a more ambitious release.

Please note that we may introduce a lot of breaking changes for skins in Subtext 2.0. We will try and keep you informed so that you will have advanced warning on how to upgrade your custom skins.

Found a typo or error? Suggest an edit! If accepted, your contribution is listed automatically here.



17 responses

  1. Avatar for Rydal Williams
    Rydal Williams June 7th, 2006

    I'm loving it! Great work guys!!! I really appreciate it - my day to day blog use is only getting easier. I'll upgrade this weekend.

  2. Avatar for Bill Graziano
    Bill Graziano June 7th, 2006

    Fantastic! I'm looking forward to installing this.

  3. Avatar for Rydal Williams
    Rydal Williams June 7th, 2006

    Just wanted to let you guys know that I upgraded successfully!

  4. Avatar for Bang Lee
    Bang Lee June 8th, 2006

    Thank you for updating. I had a problem with add/edit posting but after re-uploading whole files, it works!! I'm already looking forward next version :)

  5. Avatar for Chandima
    Chandima June 8th, 2006

    Awesome job Phil, will be upgrading this weekend. :-)
    Keep up the good work.

  6. Avatar for Eric Ramseur
    Eric Ramseur June 9th, 2006
  7. Avatar for Eric Ramseur
    Eric Ramseur June 9th, 2006

    SubText 1.5 on .NET 2.0

    Damn Copy and paste....ignore first post

  8. Avatar for Danuz
    Danuz June 9th, 2006

    Nice Job! I have just made an update from the 1.0 version of subtext and everything has been great! Thank You So much! I am waiting for subtext 2.0 version !
    Keep up this very good work!

  9. Avatar for Waseem Sadiq
    Waseem Sadiq June 10th, 2006

    My upgrade to v1.5 didn't went as smooth as I had hoped.
    We are using Subtext as our internal blogging platform and have integrated this with our Windows auth model. Subtext 1.0 worked fine by changing the configs to use windows auth. Subtext 1.5 stopped working.
    I did some investigation and discovered that the following line has changed which caused this to break.
    return IsInRole("Admins") || StringHelper.AreEqualIgnoringCase(CurrentUserName, Config.CurrentBlog.UserName);
    This is in Subtext.Framework/Securiy.cs, line 273 (in the v1.0 codebase).
    In the v1.5 codebase this line has been reduced to:
    return IsInRole("Admins");
    My guess is that since we are not using the ASP.NET forms auth model, but rather the Windows auth model (and maybe even because our database originates from the dottext timeframe), the roles definition can't be found.
    Can you please advice on what would be the best way to fix this in order to be able to seemlessly upgrade to future versions?
    You can contact me at
    Thanks again for taking the time to develop such a fine product.
    - Waseem

  10. Avatar for Haacked
    Haacked June 10th, 2006

    Waseem, I'm sorry that the upgrade broke your implementation. This is obviously something we need to address in the next implementation. Are you using a multi-blog setup?

  11. Avatar for Waseem Sadiq
    Waseem Sadiq June 10th, 2006

    Yes indeed a multi-blog setup.
    Btw, changing that specific line of code back to as it was in the 1.0 codebase fixed this issue for the time being.

  12. Avatar for charlie
    charlie June 12th, 2006

    awesome work guys!
    love subtext, and can't wait for version 2.0!
    i should know better than to ask developers for timeframes, but any idea when 2.0 will be ready? :)
    waiting in anticipation
    - charlie

  13. Avatar for Joseph
    Joseph June 19th, 2006

    I live in HK and my server is in Time Zero GMT + 8, I've set the time zero correctly in the Blog Config, but everytime I pose a new post, the time is not correct, please have a look on this problem

  14. Avatar for JiltedCitizen
    JiltedCitizen June 19th, 2006

    Sweet I have it installed now. I can't seem to get the lightbox stuff to work. I added the scipt and css to the skin template. Any examples onhow to use?

  15. Avatar for Haacked
    Haacked June 19th, 2006

    Hey, I viewed source on your blog and I didn't see lightbox.css or lightbox.js referenced. Did you set it up correctly in Skins.config?

  16. Avatar for JiltedCitizen
    JiltedCitizen June 21st, 2006

    Ya it might not have because I was messing with the skins. The one I have up now should have the lightbox stuff. At least I put it in the skins.config like shown above. And I swear I typed this before, so if its a double post sorry. :)

  17. Avatar for Joseph
    Joseph June 29th, 2006

    Something I feel weird is that there is no link of "next page" and "last page" at the bottom of the page. I'll strongly suggest adding this feature to motivate the visitors for reading more posts.