Sign in
  • Blog
  • Archive
  • About
  • Contact

Welcome to rickardnilsson.net

rickardnilsson.net is a weblog and the online home of web developer and father of three, Rickard Nilsson... More

Rickard blogs about creating software solutions using ASP.NET and agile practices.

Sites I've visited recently

  • Scott Guthrie
  • Rtur.net
  • ASP.NET Forums
  • Karstad .NET User Group
  • JetBrains ReSharper
  • Scott Hanselman
  • dnrTV!
  • MIX 2009
  • BlogEngine.Net
  • YUI Theater

Categories

  • .NET
  • ASP.NET 2.0
  • BlogEngine.NET
  • C# 2.0
  • C# 3.0
  • CSS
  • Design by Contract
  • Design Patterns
  • JavaScript
  • TDD
  • User tip

Five most recent posts

  • ReSharper User tip #2: Refactor rename namespace
  • Building a Photo Album widget for BlogEngine.NET
  • Applying stylesheets dynamically with jQuery
  • ReSharper User tip: Refactor magical strings to variable
  • Blogging with MS Word 2007

Tag cloud

  • ajax
  • blog
  • blogengine.net
  • c#
  • css
  • dbc
  • design by contract
  • dom
  • douglas crockford
  • foto
  • getweekofyear
  • gregoriancalendar
  • highlight
  • html
  • humble dialog box
  • iso 8601
  • javascript
  • jquery
  • jscript
  • julian bucknall
  • metaweblog api
  • model-view-presenter
  • mvp
  • photo album
  • picasa
  • recent posts
  • refactor
  • refactoring
  • release
  • resharper
  • rhino mocks
  • syntax
  • syntax highlighter
  • tdd
  • test coverage
  • types
  • web service
  • week
  • widget
  • word 2007
  • yahoo
  • yui

Recent comments

  • Week and strong contracts in Design by Contact (3)
    Sulumits retsambew wrote: thanks nice tips RIckard [More]
  • Syntax highlighting in BlogEngine.NET (15)
    Sulumits retsambew wrote: great coding.. thanks for sharing it.. keep it up … [More]
  • Syntax Highlighter Release 0.2 Beta (17)
    SEO wrote: Nice post.I currently in a testing phase with this… [More]
  • Syntax highlighting in BlogEngine.NET (15)
    Max Glipmax wrote: Thanks for taking the time to discuss this, I feel… [More]
  • Building a Photo Album widget for BlogEngine.NET (11)
    tukang nggame wrote: nice widget, thanks for sharing download link [More]

Syntax highlighting in BlogEngine.NET

Saturday, 12 April 2008 00:22 by Rickard

BlogEngine.NET ships with an extension that automatically highlights source code in blog posts. All that is required is that the source code block is surrounded with [code:lang][/code] tags. The extension will markup the code with CSS classes and the default theme includes a default color scheme for code elements like keywords, comments, and so forth. The extension ships with support for HTML, C#, JavaScript, T-SQL, MSH, and Visual Basic.

In forums and blogs in the BlogEngine community issues with the syntax highlighter extension has been brought up. Some of it can be found here, here, and here. Many has complained about how hard it is to use and lack of proper documentation. To get the tags to be recognized by the extension you have to format your post in a really precise manor with a leading and trailing <p></p>. Besides taking up a lot of unnecessary space when editing the post, this is why so many has complained that they can't get it to work. If the block is not correctly surrounded with the right amount of line breaks two things can happen. Either the whole code block is masked or the code is shown but the tags are rendered as part of the code block.

My own experience with this is pretty much the same and the only way to find out how it works was for me to read and step through the code. Since the extension is open source there is no hinder for improving the code base, hence I've been working to improve it to meet the community need, as well as my own. In addition to the mentioned usability issues I missed highlighting of types in C#, that is class, interface, and struct names which we are used to see in Visual Studio colored in cyan.

New version

I'm about to present a new version of the extension which will include the following improvements:

  • Highlighting of types in C#
  • The code block is recognized anywhere in the blog post and does not require any special formatting before or after the code tags.

Leave a comment on this post if you wish to be notified when the new version is available.

Example of syntax highlighting in BlogEngine.NET using the improved version

ICustomer customer = new Customer("kalle");
RegEx regex;
ICollection<Customer> coll = new ICollection<Customer>();
Stack<Name.Space.Customer> stack = new Stack<Name.Space.Customer>();
stack.Put(customer);
customer.Age = 24;

[Serializable]
public class Customer : ICustomer , IComparable<ICustomer> {
    public Customer(string name) {
        this.name = name;
        person = new Person(name);
    }
    public int Age {
        get { return age; }
        set { age = value; }
    }
    IPerson _p = Person.CurrentUser;
    IPerson person;
    internal IPerson Person {
        get {
            return this.person;
        }
    }

    private ShopingCart cart = new ShopingCart();
    protected ShopingCart GetCart() { return cart; }
}

Related work
  • C# code format
    • by Jean-Claude Manoli
    • author of the syntax highlighter extension for BlogEngine.NET
    • Not the same code as shiped with BlogEngine.NET
    • does not support types in C# 
  • Syntax highlighter
    • by Wilco Bauwer
    • linked from the extensions list on dotnetblogengine.net
    • does not support types in C#

 

ac496c26-4832-4a53-ae23-d3917ea0689e|0|.0
Tags:   syntax, highlight, c#, blogengine.net
Categories:   ASP.NET 2.0 | BlogEngine.NET | C# 2.0 | CSS
Actions:   | Permalink | Kick it! | DZone it! | del.icio.us | Comments (15) | Comment RSSRSS comment feed
 
Copyright © 2008-2009 rickardnilsson.net