怎样为你的Windows Live Writer制作一个简单的插件

首先声明这个并不是我的原创,而是ScøttLiveside上发布的一个制作插件的教程,我不过是粗略的翻译了一下,并且对一些不明朗的地方做了一些细微的改动,希望能够对大家有用。当然你可以在这里查看原版的教程。

在这篇文章中,我将从最初演示如何制作一个简单的Windows Live Writer的插件。根据我的经验,为Writer写插件非常简单,有时候你只需要动动手就可以了。

首先你必须确定你已经安装了以下必须的程序:

  • Windows Live Writer - download
  • Microsoft .NET Framework v2.0 - download
  • Visual Studio Express C# Edition - download

    一旦你已经装好了它们,那我们就可以开始了。打开Visual Studio新建一个项目,选择“类库”并且为插件命名一个名字。例如,我取名MyNewPlugin。现在我们需要告诉这个插件去找到Windows Live Writer API。在右边的“解决方案资源管理器”中,右键单击“References”文件夹然后选择“添加引用”,再选择“浏览”找到Writer的安装文件夹。那个“WindowsLive.Writer.API.dll”就是我们需要的了。

    现在引用已经创建好了,我们还需要告诉插件去实际使用这个APIs,所以我们需要添加下面的代码:

    using WindowsLive.Writer.Api;

    你还需要为Windows Forms添加引用。所以,跟我们刚才所做的一样从“.NET”部分添加“System.Windows.Forms”引用,并且告诉插件我们需要使用它:

    using System.Windows.Forms;

    下一步我们将要设置插件的属性,将下面的代码添加到"namespace"之中:

    [WriterPlugin("7c074e71-4e9d-4769-ab49-46619e99f647", "My First Plugin",
            Description = "This is my first plugin",
            HasEditableOptions = false,
            Name = "My First Plugin",
            PublisherUrl = "http://www.kaol.org")]

    现在,你所看到的这些属性中第一个是GUID(由数字和字母组成),它是你制作的每一个插件的唯一的属性。你可以在右边的“解决方案资源管理器”中的双击打开“properties”,然后点击“程序集信息”,如下面的截图:

    第二个字符串是显示在Writer的设置中Plugins部分的文字;Description是当你在Writer的设置中点击你的插件时显示在插件列表下方的文字;HasEditableOptions的值可以是true或者false中的任意一个,它告诉Writer 是否为插件设置一个设置按钮;PublisherUrl是存放你主页链接的地方。

    在下面的插件代码中,我们需要设置在插入部分显示一些文本。所以我们使用代码:

    [InsertableContentSource("From MyNewPlugin")]
    现在我们该声明插件的主类了:
    public class NewPlugin : ContentSource
        {
            public NewPlugin()
            {
            }
    注意:声明了public class之后,你必须调用class,不过使它是空的就像上面的例子一样。
    下一步我们需要覆盖这个主类(这就是为什么让它为空的原因),我们输入以下代码:
    public override DialogResult CreateContent(IWin32Window dialogOwner, ref string newContent)
            {

    ref string newContent会将其实际获得的返回输入到Blog的文章之中,所以我们需要让它等于一些东西:

    newContent = "This was put in by my first Live Writer Plugin :) ";

    由于覆盖的工作方法,我们需要返回一个DialogResult为OK(我将介绍更多的细节在其它的文章中),所以我们简单的输入:

    return DialogResult.OK;

    关闭所有的打开的域(})。你的插件就完成了,现在我们需要编译它。在这之前,我们应该向“生成”部分添加一个命令。在“解决方案资源管理器”双击“properties”,选择“生成事件”并且将下面的命令复制到“域生成事件命令行”部分:

    XCOPY /D /Y /R "$(TargetPath)" "C:\Program Files\Windows Live Writer\Plugins\"

    现在我们准备好编译插件了。按一下你键盘上的F6键等待编译的结束。一旦编译成功,打开Writer,你将会看到你的链接:

    点击它你将会看到我们为newContent设置的文字已经显示在你的Blog文章中了。我们现在已经创建了一个基本的Writer的插件了。

    你可以在这里下载这个实例的源代码。

    下一次我将告诉你怎样为你的链接添加一个图片。

  • Source: Joey's Boring Blog

    posted on 2007-03-28 19:14  Joey Liang  阅读(295)  评论(0编辑  收藏  举报