创建你的第一个Orchard站点

开始使用Orchard

创建一个新的Orchard站点以前，你能够在从下面的页面了解一些Orchard的信息

这篇文章假定你已经安装了Orchard并已经发布站点。如果没有完成，请看这篇文章： Installing Orchard.

下面是已经发布好的Orchard站点，这样你就可以不用在本地部署了

Try Orchard

Try Orchard! 是一个Orchard框架的展示站点：你能够在已经有的Demo上尝试使用Orchard。

不需要注册，不需要安装，没有什么特殊的要求，你就可以使用 Try Orchard!，打开一个demo站点，然后在上面使用。

Try Orchard! 的目的就是给用户一个测试环境：dome站点每一小时就会重置一次，所以，你不要真的在上面发博客。

DotNest : Orchard SaaS provider

DotNest是一个Orchard SaaS provider：就是说，你只需要注册一个账号，就能轻松的创建Orchard站点。你的站点仅仅能够工作：你不能够开发或者升级，你仅仅可以使用他。

使用DotNest你能够非常容易的尝试使用Orchard，将你的Orchard站点展示给其他人。除了原生的Orchard样式和特性以为，你还可以通过 basics of Orchard theme development 获取更多，通过多种方法自定义站点样式

便利也带来了一些问题：你不能安装自己开发的模块，所以使用前你需要考虑清楚

1) DotNest是什么

2) 单击New Tenant 在DotNest上创建一个新的租约

3) 填写 新的租约 需要的信息

4) 新的租约 创建成功

Azure Websites上部署Orchard

在Azure Gallery上面免费注册以后，你就能够在上面一部创建Orchard站点

你可以完全控制在 Azure Websites 上创建的Orchard站点：你能够安装任何你想要的模块或者样式。但是，这同样带来了一些麻烦：你必须自己维护站点、升级项目、修复问题。

改变主页布局

和常见的不同，Orachard采用一种称为"Theme Machine"的方法来布局。这种主题机制包括CSS样式和布局。 Orchard允许在站点的任何页面上，你可以在页面布局块上添加或者删除内容

Navigation 块包括一个由简单tab组成的菜单，页面下部的 TripelFirst, TripleSecond 和TripleThird 块放置了First Leader Aside,Second Leader Aside 和 Third Leader Aside paragraphs.

除了块，每个页面还有一个中心区域，在本篇教程中，我们将页面的 Body 放在此处。

虽然"主题机制"将页面分成了很多块，但是只有具有小工具的块，才会显示。主页上只显示Navigation, TripelFirst, TripelSecond 和 TripelThird块，因为，只有他们包含了小工具

1) 从Dashboard中选择Widgets

小工具管理界面打开的时候， Default layer 被选中。默认层中需要显示的块，在所有的页面中都会显示。因此，导航块在所有的页面都会显示，及所有的页面上面都会有一个主菜单小工具。主菜单小工具被标示为了绿色，这是应为在当前层，他被加入到了块中。

2) 选择HomePage层，可以看到在主页，那些块会显示

当前层选中的小工具会被标示为绿色(FirstLeaderAside, SecondLeaderAside 和 ThirdLeaderAside)。其它层选中的小工具会被标示为灰色(Main Menu).

TripelFirst, TripelSecond, 和TripelThird 层因为具有小工具，所以在主页会显示。如果移除小工具，那么就不会显示。

3) 点击Remove 移除 Third Leader Aside 小工具

TripelThird 块在主页上不会显示

4) 单击Add ，在TripelThird 块上新增小工具

5) 在TripelThird 块上新增HTML Widget

6) 输入小工具的标题和文本内容

7) 保存

8) 进入主页，查看更改后的效果

编辑主页内容

Orchard提供了一个特性，用于编辑块或者page body的文本内容。要使用这个特性，你必须打开 Content Control Wrapper 和 Widget Control Wrapper模块

1) 选择Dashboard右边的Modules

2) 打开 Content Control Wrapper

3) 打开 Widget Control Wrapper

当这些模块都打开以后，你能够通过点击块右上角的edit来编辑内容

4) 单击主页TripelFirst 块右上角的Edit链接

5) 变更块的内容

插入媒体项

6) 选择Insert Media Item.

7) 单击Create Folder.

8) 将文件夹命名为 myImages 然后单击 Save.

9) 单击文件夹 myImages，然后单击Import

10) 单击 My Computer ，在右边的区域单击鼠标，选择文件，也可以直接把文件拖到右边区域

11) 关闭弹出窗

12) 选中图片，然后单击 Select.

13) 如有需要，可以调整图片大小。单击Save 保存你的更改

看看主页的变化

14) 单击页面Body右上角的Edit链接

Orchard将显示 Edit Page 页面

注意: 这个编辑页面，也可以通过Dashboard页面左边的Content 选项，单击需要编辑页面的edit链接来跳转

15) 输入一些文本内容

16) 单击页面下方 Publish Now 按钮，你就可以在主页看到效果了

为你的站点新增页面

1) 在Orchard Dashboard页面，选择 New节点下面的Page节点

2) 输入页面标题（比如Download），然后保存，这时，页面的 permalink (URL) 将会自动填充为标题（"Download"）。当然，你也可以手动更改URL

3) 在页面的body中录入内容

4) 在Tags 字段，增加特殊的标签，比如"download" 和 "Orchard" 。这样，你就可以使用这些标签来搜索和删选

5) 选中Show on main menu 然后输入菜单名称("Downloads")

6) 单击Publish Now ，这样，该页面就能在显示出来了。当然，你也可以先保存页面，然后在合适的时间再发布

7) 在主页上，你就可以发现菜单多了一个Downloads项，单击他，你就能看到新建的页面了。

设置页面布局

为了改变你新建页面的布局，我们需要针对你新建的页面（Download）创建一个新的布局。你可以在这个新的布局上加上需要的小工具，显示在新的页面上。

1) 在Dashboard页面选择 Widgets。然后单击 add a new layer 来为页面新增一个布局，你可以在上面进行自定义的设置

2) 输入布局的名称、描述、规则（url"~/download"，只有Download页面才使用此布局）。单击Save.

增加新的HTML小工具

3) 我们在新的布局上加上一个小工具，来测试我们是否创建成功。请确认Current Layer是Current Layer 是Download。单击AsideFirst块右边的Add

4) 添加 Html Widget.

5) 输入title和body内容，保存

6) 进入主页，看看你的页面是否变成下图的样子：

选择主题

为了改变站点的视觉效果，你可以变更主题

1) Orchard Dashboard页面，选择 Themes节点。 当前已有的主题会列出来

2) 如果要下载新的主题，选择Gallery 标签

3) 找到 PJS.Bootstrap 主题，安装他

4) 选择 Installed 标签

当主题安装以后，他会出现在 Installed 标签页的Available 块中。

5) 想看看主题的效果，单击 Preview 预览该主题。要将该主题设置为当前主题，点击Set Current 按钮。更多细节，请看 Previewing and Applying a Theme 和 Installing Themes.

通过模块和特性扩展Orchard

Orchard的一个关键特性，就是可以在你的站点中新增新的特性来扩展功能。实现这一功能的方法就是安装模块。你可以认为模块就是能够被站点安装的文件包。要查看Orchard包含的模块，在Dashboard页面，单击 Modules 节点，选择 Installed 标签，你就可以看到已经安装的模块了