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（导入发布配置）后将相关的文件发布到你的服务器当中。顺便说下，这一切也是可以手动设置的。

在你的站点发布之后，可能还会因为一些文件发生了改变而需要重新发布。当你进行了发布操作之后，WebMatrix会将自从上次发布后发生改变的本地文件以清单的方式来列出。在该步骤下，你可以选择哪些文件需要被发布至服务器上，完成选择之后点击Continue或者cancel。

站点发布之后，可以通过点击Remote View来查看服务器上的文件。

点击这里，你可以找到更多关于通过WebMatrix发布站点的信息。

 

各位看官如果觉得本文帮助到了您，请点击右下角的推荐来给予本人支持。