BlogEngine Extension: Copy Code to Clipboard

Troy Goode — Mon, 07 Jan 2008 22:22:00 +0000

Since I first started this blog I've been using Colin Coller's CopySourceAsHtml plugin for Visual Studio (which Guy Burstein updated for Visual Studio 2008's RTM). It was a nice little tool but as I started posting more and more code snippets to the blog I found myself wanting some additional features, specifically:

Easy to use. While it was perfectly simple to copy the source as html, it was a bit more cumbersome to paste it properly into Windows Live Writer. I wound up in HTML mode in WLW everytime I needed to paste some code.
CSS support. The Html generated by the VS plugin inlines all of the styles and makes it difficult to change the presentation of your code without tweaking the settings of the plugin at posting time.
Scrollable. This is mostly handled by the above feature, but I wanted to be able to limit the amount of screen real estate taken up by the code while still allowing my readers to view more of the code without having to download any files.
Copyable. Sometimes you see a piece of code that fits your situation perfectly, but when you copy it you wind up with a bunch of extra Html guck and line numbers at the front of every line you have to manually remove. I want to allow my readers to copy the code without any of that mess.

I found syntaxhighlighter on Google Code pretty quickly and was impressed. I'd seen it around on other people's blogs and loved the "copy to clipboard" feature, but I really wanted a server-side (or pre-posting) highlighter that would take some of the strain off the browser and wanted something with richer WLW integration.

After looking at a few more options I finally found Leo Vildosola's Code Snippet plugin, which matched up with all of my requirements except for the lack of a built-in "copy to clipboard" feature. With some help from clipboard copying javascript posted at WebChicanery I set out to build an extension for BlogEngine.net that would automatically tack on the copy feature to any code I posted via the Code Snippet plugin.

A few hours later, I present the CopyCodeToClipboard extension for BlogEngine.net! Below you will find an example of the extension displaying it's own code (mmm… dogfood) and the css I've used to style the code on my site. I've tried to make the extension css friendly so you can change it's presentation a great deal without modifying the code.

CopyCodeToClipboard.zip – Download (3.82 kb)
Contains all of the below files in one convenient package.

CopyCodeToClipboard.cs – Download (7.36 kb)
This is the actual extension and should be placed into your root/App_Code/Extensions/ folder.

   1: using System;

   2: using System.Text.RegularExpressions;

   3: using BlogEngine.Core;

   4: using BlogEngine.Core.Web.Controls;

5:

   6: [Extension("Adds a link to syntax highlighted code to copy it to the clipboard.", "1.0", @""http://www.squaredroot.com"">Troy Goode")]

   7: public class CopyCodeToClipboard

   8: {

9:

  10:     private ExtensionSettings settings;

11:

  12:     public CopyCodeToClipboard()

  13:     {

14:

  15:         Post.Serving += new EventHandler(Post_PostServing);

  16:         Post.Saving += new EventHandler(Post_Saving);

17:

  18:         ExtensionSettings initialSettings = new ExtensionSettings(GetType().Name);

  19:         initialSettings.Help = "This extension is written to work with the Code Snippet Plugin for Windows Live Writer and will not work with other syntax highlighting tools.";

  20:         initialSettings.AddParameter( "copyText", "Text for 'Copy to Clipboard' button?", 255, true );

  21:             initialSettings.AddValue( "copyText", "Copy To Clipboard" );

  22:         initialSettings.AddParameter( "popupText", "Text for 'View in Popup Window' button?", 255, true );

  23:             initialSettings.AddValue( "popupText", "View Plain" );

  24:         initialSettings.AddParameter("aboveBelow", "Display above or below code?", 5, true);

  25:             initialSettings.AddValue("aboveBelow", "Below");

  26:         initialSettings.AddParameter( "style", "Any additional styling?", int.MaxValue, false );

  27:             initialSettings.AddValue( "style", "" );

  28:         initialSettings.AddParameter( "flashFile", "Path to '_clipboard.swf' Flash file?", 255, true );

  29:             initialSettings.AddValue( "flashFile", "~/_clipboard.swf" );

  30:         initialSettings.IsScalar = true;

  31:         ExtensionManager.ImportSettings(initialSettings);

32:

  33:         settings = ExtensionManager.GetSettings(GetType().Name);

34:

  35:     }

36:

  37:     private void Post_Saving(object sender, SavedEventArgs e)

  38:     {

  39:         //### executing here will only run the code once per post, but will modify the post itself

  40:         //InsertCopyCodeLink(e);

  41:     }

42:

  43:     private void Post_PostServing(object sender, ServingEventArgs e)

  44:     {

  45:         //### executing here will execute the code on every iteration, but will not modify your post

  46:         InsertCopyCodeLink(e);

  47:     }

48:

  49:     private void InsertCopyCodeLink( ServingEventArgs e)

  50:     {

  51:         if( !string.IsNullOrEmpty(e.Body) )

  52:         {

53:

  54:             //### find code-div

  55:             string postID = Guid.NewGuid().ToString().Replace( "{", "" ).Replace( "}", "" ).Replace( "-", "" );

  56:             string toFind = "";

  57:             int index = e.Body.IndexOf(toFind);

  58:             while( index != -1 )

  59:             {

60:

  61:                 //### grab code out of code-div

  62:                 int end = e.Body.IndexOf( "

", index ); //### the first

should be the end of "csharpcode"

  63:                 end = e.Body.IndexOf( "", end ); //### the next  should be the end of "csharpcode-wrapper"

  64:                 string code = e.Body.Substring(index, end - index);

65:

  66:                 //### parse code out of code-div

  67:                 int codeStart = code.IndexOf(");

  68:                 int codeEnd = code.LastIndexOf("
") + 6;

  69:                 code = code.Substring(codeStart, codeEnd - codeStart);

  70:                 code = Regex.Replace( code, @"<(.|n)*?>", string.Empty ); //### strip html

  71:                 code = code.Replace( " ", "" ); //### remove unnecessary  s from the blank lines

  72:                 code = code.Replace( " ", " " ); //### convert  s to spaces

  73:                 code = Regex.Replace( code, @"^(s*)(d+): ", "" ); //### remove line numbers on first line

  74:                 code = Regex.Replace( code, @"(n)(s*)(d+): ", "n" );  //### remove line numbers on subsequent lines

75:

  76:                 //### create copy link

  77:                 string insertScript = @"

  78:                     ";

  81:                 string insertDiv = @""CopyToClipboard"" style=""@STYLE"">"javascript:void(0);"" onclick=""CopyToClipboard_ViewPlain(copyToClipboard@INDEX);"">@POPUPTEXT | "javascript:void(0);"" onclick=""CopyToClipboard_Copy(copyToClipboard@INDEX);"">@COPYTEXT
";

82:

  83:                 //### set values for copy link and insert above/below code

  84:                 string insert = insertDiv + OutputCommonMethods() + insertScript;

  85:                 insert = insert.Replace( "@STYLE", settings.GetSingleValue("style") );

  86:                 insert = insert.Replace( "@POPUPTEXT", settings.GetSingleValue("popupText") );

  87:                 insert = insert.Replace( "@COPYTEXT", settings.GetSingleValue("copyText") );

  88:                 insert = insert.Replace( "@INDEX", postID + "_" + index.ToString() ); //### use index of code-div as a unique ID to allow multiple code-divs on this post

  89:                 insert = insert.Replace( "@CODE", code.Replace( "", "" ).Replace( "'", "'" ).Replace( "rn", "rn" ).Replace( "rnrnrn", "rn" ) );

  90:                 if( settings.GetSingleValue("aboveBelow").ToLower() == "above" )

  91:                     e.Body = e.Body.Insert( index, insert );

  92:                 else

  93:                     e.Body = e.Body.Insert( e.Body.IndexOf( "", end + 1 ) + 6, insert );

94:

  95:                 //### prep index to find next code-div

  96:                 index = index + insert.Length + 1; //### ensure we don't find this same code-div again

  97:                 if( index > e.Body.Length ) break;

  98:                 index = e.Body.IndexOf( toFind, index ); //### find any other code divs

99:

 100:             }

 101:         }

 102:     }

 103:

 104:     private string OutputCommonMethods()

 105:     {

 106:

 107:         //### only output the following once per page

 108:         if( System.Web.HttpContext.Current.Items["CopyToClipboard_JSOutput"] == null )

 109:         {

 110:             //### add shared javascript

 111:             string flashPath = System.Web.VirtualPathUtility.ToAbsolute(settings.GetSingleValue("flashFile"));

 112:             string commonMethods = @"

 113:                 "CopyToClipboard_Hidden"" style=""display:none;"">

 114:                 "CopyToClipboard_FlashContainer"">

 115:

 149:             ";

 150:             System.Web.HttpContext.Current.Items["CopyToClipboard_JSOutput"] = true;

 151:             return commonMethods;

 152:         }

 153:         else

 154:             return "";

 155:

 156:     }

 157:

 158: }

WLWSyntaxHighlighter.css – Download (1.26 kb)

The Css generated by the Windows Live Writer Code Snippet plugin, modified to fit into my blog's colors.

   1: .csharpcode-wrapper, .csharpcode-wrapper pre {

   2:   clear: both;

   3:   background-color: #f5f5f5;

   4:   border: solid 2px #A0410D;

   5:   font-family: Consolas, 'Courier New', Courier, Monospace;

   6:   font-size: 8pt;

   7:   line-height: 12pt;

   8:   margin: 15px 0 0 0px;

   9:   max-height: 227px;

  10:   overflow: auto;

  11:   padding: 0px 0px 0px 0px;

  12:   width: 454px;

  13: }

  14: .csharpcode-wrapper pre {

  15:   border-style: none;

  16:   margin: 0px 0px 0px 0px;

  17:   overflow: visible;

  18:   padding: 0px 0px 0px 0px;

  19: }

  20: .csharpcode, .csharpcode pre, .csharpcode .alt {

  21:   background-color: #f5f5f5;

  22:   border-style: none;

  23:   color: black;

  24:   font-family: Consolas, 'Courier New', Courier, Monospace;

  25:   font-size: 8pt;

  26:   line-height: 12pt;

  27:   overflow: visible;

  28:   padding: 0px 0px 0px 0px;

  29:   width: 100%;

  30: }

  31: .csharpcode pre {

  32:   margin: 0em;

  33: }

  34: .csharpcode .alt {

  35:   background-color: #f4f2df;

  36: }

  37: .csharpcode .asp {

  38:   background-color: #ffff00;

  39: }

  40: .csharpcode .attr {

  41:   color: #ff0000;

  42: }

  43: .csharpcode .cls {

  44:   color: #cc6633;

  45: }

  46: .csharpcode .html {

  47:   color: #800000;

  48: }

  49: .csharpcode .kwrd {

  50:   color: #0000ff;

  51: }

  52: .csharpcode .lnum {

  53:   color: #f1c969;

  54: }

  55: .csharpcode .op {

  56:   color: #0000c0;

  57: }

  58: .csharpcode .preproc {

  59:   color: #cc6633;

  60: }

  61: .csharpcode .rem {

  62:   color: #008000;

  63: }

  64: .csharpcode .str {

  65:   color: #006080;

  66: }

CopyCodeToClipboard.css – Download (588 bytes)

The Css I use to style the little red tab below each code area. This is what you would change to match your blog.

   1: .CopyToClipboard{

   2:     width: 458px;

   3:     text-align: right;

   4:     margin: 0 0 5px 0;

   5: }

   6: .CopyToClipboard div{

   7:     margin-left: 248px;

   8:     background-color: #A0410D;

   9:     padding: 0px 5px 2px 5px;

  10:     text-align: center;

  11:     color: #F1C969;

  12:     width: 200px;

  13:     font-size: 9px;

  14: }

  15: .CopyToClipboard a{

  16: }

  17: .CopyToClipboard a:link{

  18:     text-decoration: none;

  19:     color: #f5f5f5;

  20: }

  21: .CopyToClipboard a:visited{

  22:     text-decoration: none;

  23:     color: #f5f5f5;

  24: }

  25: .CopyToClipboard a:hover{

  26:     text-decoration: underline;

  27:     color: #f5f5f5;

  28: }

  29: .CopyToClipboard a:active{

  30:     text-decoration: underline;

  31:     color: #f5f5f5;

  32: }

_clipboard.swf – Download (109 bytes)

A Macromedia Flash file used to circumvent Firefox & Safari's nasty habit of blocking javascript from interacting with the clipboard. Created (as best I can tell) by Mark O'Sullivan of http://lussumo.com/.

Update (July 11, 2008):
A release of the Code Snippet plug hasn't been made since the last changes to its source was checked in (in late 2007), so I went ahead and downloaded & built the source. To install the plug place the two DLLs in the zip file from below into Windows Live Writer's /Plugins/ directory.

CodeSnippetPlugin.zip (64.91 kb)

SquaredRoot » BlogEngine.net

Massive BlogEngine.net Security Hole

BlogEngine Extension: Copy Code to Clipboard

BlogEngine.net 1.2.5 Scrapped