Orchard 1.4

建立：1.4.2

Published: 2/29/2012

发布时间：2012年2月29日

Updated 5/4/2012 for version 1.4.1

版本1.4.1更新于5/4/2012

Updated 5/21/2012 for version 1.4.2

版本1.4.2更新于5/21/2012

How to Install Orchard

如何安装Orchard

To install Orchard using Web PI, follow these instructions: http://docs.orchardproject.net/Documentation/Installing-Orchard. Web PI will detect your hardware environment and install the application.

要使用Web PI安装Orchard，请按照以下说明操作：http://docs.orchardproject.net/Documentation/Installing-Orchard。 Web PI将检测您的硬件环境并安装该应用程序。

Alternatively, to install the release manually, download the Orchard.Web.1.4.2.zip file.

或者，要手动安装发行版，请下载Orchard.Web.1.4.2.zip文件。

http://docs.orchardproject.net/Documentation/Manually-installing-Orchard-zip-file

http://docs.orchardproject.net/Documentation/Manually-installing-Orchard-zip-file

The zip contents are pre-built and ready-to-run. Simply extract the contents of the Orchard

zip内容是预先构建的并且可以立即运行。只需提取果园的内容即可

folder from the zip contents to an IIS virtual directory (or site root) and then point your

从zip内容到IIS虚拟目录（或站点根目录）的文件夹，然后指向您的

browser to the site. You can also just extract to a local folder and open the Orchard

浏览器到网站。您也可以只提取到本地文件夹并打开Orchard

folder in Visual Studio or WebMatrix as a web site.

Visual Studio中的文件夹或WebMatrix中的文件夹。

Please make sure you have a machine key

请确保您有机器钥匙

http://docs.orchardproject.net/Documentation/Setting-up-a-machine-key

http://docs.orchardproject.net/Documentation/Setting-up-a-machine-key

or you may experience frequent disconnections.

或者您可能会经常断开连接。

What file to download?

要下载什么文件？

If you just want to use Orchard and don't care about the source code, Orchard.Web.1.4.2.zip

如果你只是想使用Orchard而不关心源代码，Orchard.Web.1.4.2.zip

is what you want to use, preferably through the WebPI instructions.

是你想要使用的，最好是通过WebPI指令。

If you want to take a look at the source code, OrchardSource.1.4.2.zip is fine.

如果你想看一下源代码，OrchardSource.1.4.2.zip就可以了。

If you want to setup a development environment for patch or module development,

如果要为修补程序或模块开发设置开发环境，

you should clone the repository by following the instructions here:

您应该按照此处的说明克隆存储库：

http://docs.orchardproject.net/Documentation/Setting-up-a-source-enlistment

http://docs.orchardproject.net/Documentation/Setting-up-a-source-enlistment

Do not attempt to build the WebPI version in VS. Use the full source if you want to use VS.

不要尝试在VS中构建WebPI版本。如果要使用VS，请使用完整源代码。

Branches are described here: http://docs.orchardproject.net/Documentation/Developer-FAQ#Whatarethedefaultanddevbranches?WhichoneshouldIbeusing?

分支在这里描述：http://docs.orchardproject.net/Documentation/Developer-FAQ#Whatarethedefaultanddevbranches?WhichoneshouldIbeusing？

Who should use this software?

谁应该使用这个软件？

This software is in version 1.4.2. The code is in a stable state and constitutes

该软件的版本为1.4.2。代码处于稳定状态并构成

a solid foundation for building applications, themes and modules.

为构建应用程序，主题和模块奠定坚实的基础。

Suggestions are welcome in the discussion forums.

欢迎在论坛中提出建议。

You are allowed to use this software in any way that is compatible with the new BSD license.

您可以以与新BSD许可证兼容的任何方式使用此软件。

This includes commercial derivative work.

这包括商业衍生作品。

Compatibility with ASP.NET WebPages and ASP.NET MVC

与ASP.NET WebPages和ASP.NET MVC的兼容性

The 1.4.2 release of Orchard is only compatible with ASP.NET MVC 3.

Orchard的1.4.2版本仅与ASP.NET MVC 3兼容。

If you have installed WebMatrix Betas or RCs, you need to uninstall them from the

如果您已安装WebMatrix Betas或RC，则需要从中卸载它们

machine where you run Orchard.

你运行乌节的机器。

Note: if you don't have ASP.NET MVC or WebMatrix installed, you are fine and you don't

注意：如果您没有安装ASP.NET MVC或WebMatrix，那么您没问题

need to install them first as Orchard will then use its own copy.

需要先安装它们，因为Orchard将使用自己的副本。

What's new?

什么是新的？

Orchard 1.4.2 fixes bugs, improves performance and introduces the following features:

Orchard 1.4.2修复了错误，提高了性能并引入了以下功能：

  • Autoroute: Set-up token-based patterns for your URLs.

  • 自动运行：为您的网址设置基于令牌的模式。

David Hayden has a good post describing the feature:

David Hayden有一篇很好的文章描述了这个特征：

http://www.davidhayden.me/blog/autoroute-custom-patterns-and-route-regeneration-in-orchard-1.4

http://www.davidhayden.me/blog/autoroute-custom-patterns-and-route-regeneration-in-orchard-1.4

  • Projector: Create arbitrary queries on your site contents, then display the results in projection pages and widgets.

  • 投影仪：对您的网站内容创建任意查询，然后在投影页面和小部件中显示结果。

  • Fields: Orchard now comes with new field types for Boolean, Date/Time, Enumeration, HTML5 Input,

  • 字段： Orchard现在带有布尔，日期/时间，枚举，HTML5输入的新字段类型，

Links, Media Picker and Numeric. The text field has a new setting for the flavor which adds

链接，媒体选择器和数字。文本字段具有添加的风味的新设置

html, markdown and textarea to the default text box.

html，markdown和textarea到默认文本框。

The full list of fixed bugs for this release can be found here:

可以在此处找到此版本的已修复错误的完整列表：

  • Bugs fixed in 1.4.

  • [修正了1.4中的错误]（http://orchard.codeplex.com/workitem/list/advanced?keyword=\u0026status=Fixed|Closed\u0026type=All\u0026priority=All\u0026release=Orchard%201.4\u0026assignedTo=All\u0026component=All\u0026sortField=LastUpdatedDate\u0026sortDirection=Scendingnding@page=0） 。 *

  • Bugs fixed in 1.4.1.

  • [在1.4.1中修复的错误]（http://orchard.codeplex.com/workitem/list/advanced?keyword=\u0026status=Fixed|Closed\u0026type=All\u0026priority=All\u0026release=Orchard%201.4.1\u0026assignedTo=All\u0026component=All\u0026sortField=LastUpdatedDate\u0026sortDirection=Scendingnding\u0026page = 0）。 *

  • Bugs fixed in 1.4.2

  • [在1.4.2中修复的错误]（http://orchard.codeplex.com/workitem/list/advanced?keyword=\u0026status=Fixed|Closed\u0026type=All\u0026priority=All\u0026release=Orchard%201.4.2\u0026assignedTo=All\u0026component=All\u0026sortField=LastUpdatedDate\u0026sortDirection=Scendingnding\u0026page = 0） *

Breaking Changes

突破性变化

Orchard 1.4 introduces a breaking change with the Autoroute and Alias features by removing

Orchard 1.4通过删除引入了Autoroute和Alias功能的重大变化

the Route part that was previously handling URLs and titles for content items.

之前处理内容项的URL和标题的Route部分。

Migrating existing content items can be done with a special module (see next section), but

迁移现有内容项可以使用特殊模块完成（参见下一节），但是

it may also happen that some modules that were relying on the presence of Route may stop working.

也可能发生一些依赖路线存在的模块可能会停止工作。

We've asked all module developers to review their code with the new version, but there may

我们已经要求所有模块开发人员使用新版本查看他们的代码，但可能会

still be incompatible ones out there. If a module misbehaves, please check whether a new version

那里仍然是不相容的。如果模块行为不当，请检查是否有新版本

is available. If there isn't one, please contact its author through the contact form on the

是可用的。如果没有，请通过联系表格联系作者

Orchard Gallery.

[Orchard Gallery]（http://gallery.orchardproject.net/）。

You may also attempt to fix the modules you need: we have a set of instructions on this thread:

您也可以尝试修复所需的模块：我们在此线程上有一组说明：

http://orchard.codeplex.com/discussions/311109

http://orchard.codeplex.com/discussions/311109

How to upgrade from a previous version

如何从以前的版本升级

You can find migration instructions here: http://docs.orchardproject.net/Documentation/Upgrading-a-site-to-a-new-version-of-Orchard.

您可以在此处找到迁移说明：http://docs.orchardproject.net/Documentation/Upgrading-a-site-to-a-new-version-of-Orchard。

No matter what migration path you take, please take the precaution of making a backup of your

无论您采取何种迁移路径，请采取预防措施备份您的

site and database first.

站点和数据库第一。

Orchard 1.4 introduces breaking changes in the way content URLs are managed. Because of that,

Orchard 1.4引入了内容URL管理方式的重大变化。因此，

the source code version comes with a special module, UpgradeTo14, that can be used to migrate

源代码版本附带一个特殊模块UpgradeTo14，可用于迁移

data from a previous version of Orchard to 1.4. If you upgrade a site to 1.4 code and can't

从以前版本的Orchard到1.4的数据。如果您将站点升级到1.4代码而不能

see your contents, you probably need to run this module. In order to do that, go to the admin

看到你的内容，你可能需要运行这个模块。为此，请转到管理员

section of the site (by appending /admin to the URL where the home page should be), then go

网站的一部分（通过将/ admin添加到主页所在的URL），然后转到

to Modules and enable the feature.

到模块并启用该功能。

The feature, once enabled, adds a new entry to the admin menu: "Migrate to 1.4", that can

该功能一旦启用，就会在管理菜单中添加一个新条目：“迁移到1.4”，即可

migrate the Route data of your content items as well as field data from older field modules.

迁移内容项的Route数据以及旧字段模块中的字段数据。

To migrate route data, check the types to migrate, then click the Migrate button. This will

要迁移路由数据，请检查要迁移的类型，然后单击“迁移”按钮。这将

move all your route data to the new alias and autoroute feature, it will move your titles

将所有路径数据移动到新别名和自动路由功能，它将移动您的标题

to the Title part, and it will remove the Route part from your content type definition,

到标题部分，它将从您的内容类型定义中删除Route部分，

replacing it with the newer Autoroute and Title parts.

用更新的Autoroute和Title部件替换它。

To migrate field values from existing field features such as Contrib.DateTimeField, click

要从现有字段功能（如Contrib.DateTimeField）迁移字段值，请单击

on the "Migrate Fields" tab on the "Migrate to 1.4" screen. Check the types you want to

在“迁移到1.4”屏幕上的“迁移字段”选项卡上。检查您想要的类型

migrate, then click the Migrate button.

迁移，然后单击“迁移”按钮。

All your contents should now be restored ad functioning like it was in the previous version

您现在应该恢复所有内容，其功能与之前版本相同

of Orchard that you were using.

您正在使用的Orchard。

How to Reset Your Site Data

如何重置您的网站数据

The App_Data directory contains database and settings documents produced during setup.

App_Data目录包含安装期间生成的数据库和设置文档。

The contents of this directory are protected from download by visitors to your site.

该目录的内容受到访问者保护，不会被您网站的访问者下载。

To completely reset your site (destroy all data, starting from the setup screen again),

  • 要完全重置您的站点*（销毁所有数据，再次从设置屏幕开始），

you can delete the contents of this directory. This action is irreversible so backup first!

您可以删除此目录的内容。这个动作是不可逆转的，所以先备份！

For other known issues, please refer to [url:http://orchard.codeplex.com/workitem/list/basic].

有关其他已知问题，请参阅[url：http：//orchard.codeplex.com/workitem/list/basic]。

Contributors

贡献者

This software would not exist without the community. In particular, for this release,

没有社区，该软件将不存在。特别是，对于此版本，

we should all be grateful to the following people who contributed patches and features:

我们都应该感谢以下提供补丁和功能的人：

  • JLedel

  • JLedel *

  • TheMonarch (Giscard Biamby)

  • TheMonarch（Giscard Biamby） *

  • Kevin Kuebler

  • Kevin Kuebler *

  • sberry3057

  • sberry3057 *

  • miguelerm

  • miguelerm *

  • styx31

  • styx31 *

  • piedone

  • piedone *

  • EddieDesk

  • EddieDesk *

  • ldhertert

  • ldhertert *

  • martijnl

  • martijnl *

  • Steve@raptor

  • 史蒂夫@猛禽 *

  • randompete (Pete Hurst)

  • 兰德海特（Pete Hurst） *

  • agriffard (Antoine Griffard)

  • agriffard（Antoine Griffard） *

  • planetClaire (Claire Botman)

  • planetClaire（克莱尔博特曼） *

  • Sebastien Ros

  • 塞巴斯蒂安罗斯 *

  • Bertrand Le Roy

  • Bertrand Le Roy *

  • Nicholas Mayne

  • 尼古拉斯梅恩 *

For 1.4.1:

对于1.4.1：

  • piedone

  • piedone *

  • filetek

  • filetek *

  • pszmyd

  • pszmyd *

  • rdobson

  • rdobson *

  • Nicholas Mayne

  • 尼古拉斯梅恩 *

  • Laere

  • Laere *

For 1.4.2:

对于1.4.2：

  • jao28

  • jao28 *

  • Claire Botman

  • 克莱尔博特曼 *