Orchard官方文档翻译(四) 让Orchard在WebMatrix下工作

原文地址:http://docs.orchardproject.net/Documentation/Working-with-Orchard-in-WebMatrix

想要查看文档目录请用力点击这里

最近想要学习了解orchard，但却没有找到相关的中文文档，只有英文文档。于是决定自行翻译，以便日后方便翻阅。

转载请注明原作者与出处。

本人英文水平有限，错误之处欢迎指出以便修正。

让Orchard在WebMatrix下工作

WebMatrix，微软的一站式web开发工具，让你创建、编辑、发布web站点时拥有前所未有的便捷。WebMatrix包括嵌入式的web服务(IIS Express)，以及如同Orchard般简单易用的编辑器来自定义站点应用程序。当使用Web Platform Installer安装Orchard时，可以通过选项用WebMatrix替代IIS。

安装并运行WebMatrix Installing and Launching WebMatrix

下载并运行Microsoft Web Platform Installer，点击Microsoft WebMatrix的Add按钮后点击Install。

当安装完成时接受许可协议后运行WebMatrix。

使用WebMatrix创建一个基于Orchard的web站点

要使用WebMatrix创建基于Orchard的web站点，在WebMatrix的启动页面中点击App Gallery。

向下拖动滚动条找到并选择Orchard CMS，为你的站点所使用的文件夹输入名称(译者注:图中Site Name处) 。举例来说，如果输入的站点名称是"Orchard CMS"，将会创建文件夹"Documents/My Websites/Orchard CMS"。点击Next继续下一步。

点击I Accept来接受最终用户许可协议。

一个新的子文件夹，"Orchard CMS"将会被添加到"My Websites"文件夹下。点击OK。你的Orchard站点将会在Web Matrix Your Orchard中打开并且"Orchard Setup"页面将会在新的浏览器窗口中启动。

在Orchard安装页面关于站点的输入基本信息。必须明确之处:站点名称，用户密码，站点数据库类型，Orchard配方。

如果你仅仅是想要尽快使用Orchard，我们建议你选择SQL Compact Server数据库类型并使用Default配方(recip)。输入所有必备信息后点击Finish Setup。

点击按钮后，Orchard会在站点初始化完成后在浏览器窗口中打开站点首页。你将会自动使用刚刚设置的用户信息登陆(刚刚设置的是admin用户)。在该处，点击Dashboard将会带你进入Orchard Dashboard页面，在那里可以改变一些站点配置。

通过WebMatrix运行你的web站点

在任何时间，你都可以在选择WebMatrix的project节点后点击Run来运行站点。

文件修改

你可以使用WebMatrix来编辑Orchard安装实例中的文件。WebMatrix提供了用于HTML，CSS，JavaScript的且拥有代码颜色渲染的编辑器。

虽然WebMatrix不能用于创建用需要编译的代码文件，但却可以使用Orchard本身的动态编译来实现类似的代码实现。需要更多的信息，请参见Orchard动态编译。

你可以跟随该篇教程来使用WebMatrix做出一些变更。

举个例子，你可能会发现使用XML编辑器(具有代码颜色渲染通道)来编辑placement.info文件能够获得很大的协助。想要实现在WebMatrix中通过XML编辑器打开.info文件，必须要通过文件filetypes.xml做出一些设置上的改变(可以在如下位置招到该文件)：

32-bit 系统: C:\Program Files\Microsoft WebMatrix\config\filetypes.xml
64-bit 系统: C:\Program Files (x86)\Microsoft WebMatrix\config\filetypes.xml

1) 增加.info文件扩展名至xml文件类型列表:

<FileType extension=".info;.config;.csproj;.vbproj;.resx;.settings;.sitemap;.user;.wsdl;.browser;.xaml;.xml;.xoml;.xsd;.xsl;.xslt;.mxml;.dbml;.wstemplate">
    <OpenAs>XML</OpenAs>
    <TabColor>Yellow</TabColor>
    <Icon>XMLFileIcon</Icon>
    <EmitUtf8BomByDefault>True</EmitUtf8BomByDefault>
    <Description>An XML File</Description>
</FileType>

2) 从文本文件类型列表中溢出.info文件扩展名 Remove the .info file extension from the list of Text file types:

<FileType extension=".ashx;.export;.po;.blogtemplate;.yml;.yaml;.manifest;.pl;.json;.csv">
    <OpenAs>Text</OpenAs>
    <TabColor>Gray</TabColor>
    <Icon>DefaultFileIcon</Icon>
    <EmitUtf8BomByDefault>False</EmitUtf8BomByDefault>
    <Description>Unknown file type</Description>
</FileType>

3) 重启WebMatrix来接受设置上的改变。

数据库修改

在Orchard安装时如果选择了SQL Server Compact作为数据库，可以在WebMatrix中打开Orcard.sdf文件来查看数据库。

Once the database window is opened, you can view the contents of a table by selecting the table in the explorer pane.

(如果已经在数据库工作区中，你只需右击Orchard节点后点击Refresh便会显示相关的数据库与数据表。)

发布你的Web站点

当你准备好上传本地站点至因特网的时候，点击WebMatrix功能区的Publish按钮。

在首次发布时，Publish Your Site对话框将会出现在你的屏幕上。

想要发布站点，必须要有主机空间商的账号。如果还没有，可以选择Windows Azure服务 或 寻找Windows主机空间。如果选择Windows Azure，你在创建web站点时要在Azure Website或Azure Web Role二者中选择其一。(译者注：没怎么用过windows azure，所以没法对那两个选项做出更多解释)

在你设置了主机服务商的账号之后，将会收到一封包含用户名，服务器名，以及其他信息的邮件。通常会有一些额外的步骤让你手动输入相关信息来保存，并在保存后发送给你包含相关信息的"个人配置XML"文件(.publishsettings扩展名的文件)。你可以在选择Import publish profile（导入发布配置）后将相关的文件发布到你的服务器当中。顺便说下，这一切也是可以手动设置的。