Author: gaohoward Date: 2010-05-10 04:50:33 -0400 (Mon, 10 May 2010) New Revision: 9215 Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml Log: quick start Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml 2010-05-10 06:09:57 UTC (rev 9214) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/about.xml 2010-05-10 08:50:33 UTC (rev 9215) @@ -19,61 +19,49 @@ <!-- ============================================================================= --> <chapter id="about"> - <title>About HornetQ</title> - <para>What is HornetQ?</para> + <title>关于HornetQ</title> + <para>什么是HornetQ?</para> <itemizedlist> <listitem> - <para>HornetQ is an open source project to build a multi-protocol, embeddable, very high - performance, clustered, asynchronous messaging system.</para> + <para>HornetQ是一个开源项目。它的目标是一个多协议、可嵌入、高性能、可集群的异步的消息系统。</para> </listitem> <listitem> - <para>For answers to more questions about what HornetQ is and what it isn't please visit - the <ulink url="http://www.jboss.org/community/wiki/HornetQGeneralFAQs">... wiki - page</ulink>.</para> + <para>有关HornetQ是什么及不是什么的更多的问题，请访问 + <ulink url="http://www.jboss.org/community/wiki/HornetQGeneralFAQs">... wiki + 页</ulink>。</para> </listitem> </itemizedlist> - <para>Why use HornetQ? Here are just a few of the reasons:</para> + <para>为什么要使用HornetQ？ 以下给出了几个理由：</para> <itemizedlist> <listitem> - <para>100% open source software. HornetQ is licenced using the Apache Software License v2.0 - to minimise barriers to adoption.</para> + <para>HornetQ是100%的开源软件。 HornetQ 采用 Apache v 2.0开源协议，对用户的限制最小。</para> </listitem> <listitem> - <para>HornetQ is designed with usability in mind.</para> + <para>HornetQ的设计强调可用性。</para> </listitem> <listitem> - <para>Written in Java. Runs on any platform with a Java 6+ runtime, that's everything - from Windows desktops to IBM mainframes.</para> + <para>采用Java语言编写。可以在任何Java 6+ 的平台上运行。这几乎包括了从Windows到IBM mainframes的每个平台。</para> </listitem> <listitem> - <para>Amazing performance. Our class beating high performance journal provides persistent - messaging performance at rates normally seen for non persistent messaging, our non - persistent messaging performance rocks the boat too.</para> + <para>性能出众。不但对非持久化消息的处理性能达到了非常高的性能。独特高效的日志（journal）使持久消息处理接近非持久消息的性能。</para> </listitem> <listitem> - <para>Full feature set. All the features you'd expect in any serious messaging system, - and others you won't find anywhere else.</para> + <para>功能全面。不仅拥有其它成熟消息产品所具有的全部功能，而且还有很多独特的功能。</para> </listitem> <listitem> - <para>Elegant, clean-cut design with minimal third party dependencies. Run HornetQ - stand-alone, run it in integrated in your favourite JEE application server, or run - it embedded inside your own product. It's up to you.</para> + <para>HornetQ的设计遵从了简约的原则。对第三方软件的依赖极少。根据不同的需要， + HornetQ可以单独运行，也可以运行于JEE应用服务器中。它还可以嵌入到你自己的应用程序中。</para> </listitem> <listitem> - <para>Seamless high availability. We provide a HA solution with automatic client - failover so you can guarantee zero message loss or duplication in event of server - failure.</para> + <para>完美的可获得性。HornetQ提供自动客户端失效备援（automatic client failover）功能，能保证在服务器故障时没有消息丢失或消息重复。</para> </listitem> <listitem> - <para>Hugely flexible clustering. Create clusters of servers that know how to load - balance messages. Link geographically distributed clusters over unreliable - connections to form a global network. Configure routing of messages in a highly - flexible way.</para> + <para>超级灵活的集群方案。可以控制集群进行消息负载均衡的方式。分布在不同地理位置的各个集群间可以通过非可靠的网络连接形成一个全球网络。 + 还可以非常灵活地配置消息路由。</para> </listitem> <listitem> - <para>For a full list of features, please see the <ulink - url="http://www.jboss.org/community/wiki/HornetQFeatures">fe... wiki - page</ulink> .</para> + <para>请访问 <ulink + url="http://www.jboss.org/community/wiki/HornetQFeatures">wi... </listitem> </itemizedlist> -</chapter> \ No newline at end of file +</chapter> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml 2010-05-10 06:09:57 UTC (rev 9214) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/download.xml 2010-05-10 08:50:33 UTC (rev 9215) @@ -17,52 +17,52 @@ <!-- permitted by applicable law. --> <!-- ============================================================================= --> <chapter id="download"> - <title>Download</title> - <para>The official HornetQ project page is <ulink url="http://hornetq.org/" - >http://hornetq.org/</ulink>.</para> + <title>下载</title> + <para>HornetQ项目的官方地址是 <ulink url="http://hornetq.org/" + >http://hornetq.org/</ulink>。</para> <section id="download.software"> - <title>Software Download</title> - <para>The software can be download from the Download page:<ulink + <title>软件下载</title> + <para>HornetQ的下载地址是<ulink url="http://hornetq.org/downloads.html/" </section> <section id="download.svn"> - <title>Project Information</title> + <title>项目信息</title> <para> <itemizedlist> <listitem> - <para>Please take a look at our project <ulink + <para>HornetQ的 <ulink url="http://www.jboss.org/community/wiki/HornetQ">wiki</u... </listitem> <listitem> - <para>If you have any user questions please use our <ulink - url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... - forum</ulink></para> + <para>如果在使用HornetQ中发生任何问题，可以去我们的 <ulink + url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + </ulink></para> </listitem> <listitem> - <para>If you have development related questions, please use our <ulink + <para>如果你有开发方面的问题与想法，请访问我们的 <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... - >developer forum</ulink></para> + >开发论坛</ulink></para> </listitem> <listitem> - <para>Pop in and chat to us in our <ulink url="irc://irc.freenode.net:6667/hornetq" - >IRC channel</ulink></para> + <para>请加入我们的<ulink url="irc://irc.freenode.net:6667/hornetq" + >IRC频道</ulink>与我们的核心开发工程师交流。</para> </listitem> <listitem> - <para>Our project <ulink url="http://hornetq.blogspot.com/">blog</ulink></pa... + <para>我们项目有自己的 <ulink url="http://hornetq.blogspot.com/">博客</ulink></para... </listitem> <listitem> - <para>Follow us on <ulink url="http://twitter.com/hornetq">twitter</ulink></p... + <para>还可以跟踪我们的<ulink url="http://twitter.com/hornetq">twitter</ulink></p... </listitem> <listitem> - <para>HornetQ Subversion trunk is <ulink + <para>HornetQ的Subversion代码库地址 <ulink url="http://anonsvn.jboss.org/repos/hornetq/trunk" </listitem> <listitem> - <para>All release tags are availble from <ulink + <para>每次发布的版本标签都在<ulink url="http://anonsvn.jboss.org/repos/hornetq/tags" - >http://anonsvn.jboss.org/repos/hornetq/tags</ulink></para> + >http://anonsvn.jboss.org/repos/hornetq/tags</ulink>下能找到。</para> </listitem> </itemizedlist> </para> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml 2010-05-10 06:09:57 UTC (rev 9214) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/installation.xml 2010-05-10 08:50:33 UTC (rev 9215) @@ -17,31 +17,28 @@ <!-- permitted by applicable law. --> <!-- ============================================================================= --> <chapter id="installation"> - <title>Installation</title> - <para>This section describes how to install HornetQ. </para> + <title>安装</title> + <para>本章讲述如何安装HornetQ。</para> <section id="installation.prerequisites"> - <title>Prerequisites</title> + <title>准备</title> <note> - <para>HornetQ only runs on Java 6 or later.</para> + <para>HornetQ只能在Java 6或以上版本中运行</para> </note> - <para>By default, HornetQ server runs with 1GiB of memory. If your computer has less memory, - or you want to run it with more available RAM, modify the value in <literal - >bin/run.sh</literal> accordingly.</para> - <para>For persistence, HornetQ uses its own fast journal, which you can configure to use - libaio (which is the default when running on Linux) or Java NIO. In order to use the libaio - module on Linux, you'll need to install libaio, if it's not already installed.</para> - <para>If you're not running on Linux then you don't need to worry about this.</para> - <para>You can install libaio using the following steps as the root user:</para> - <para>Using yum, (e.g. on Fedora or Red Hat Enterprise Linux):</para> + <para>默认情况下HornetQ运行的内存是1GiB。如果你的电脑内存少于1GiB，或者你希望更多的内存给HornetQ，你 + 可以修改 <literal>bin/run.sh</literal>脚本文件。</para> + <para>HornetQ有自己的快速日志系统，它能够使用libaio（在Linux上它是默认的）或Java的NIO。 + 如果要使用libaio，你需要首先在你的Linux上安装它。</para> + <para>如果你不在使用Linux，则不需要考虑这个问题。</para> + <para>要安装libaio，你可以使用root用户完成以下步骤：</para> + <para>使用yum（例如在Fedora 或 Red Hat Enterprise Linux上）：</para> <programlisting>yum install libaio</programlisting> - <para>Using aptitude, (e.g. on Ubuntu or Debian system):</para> + <para>使用aptitude, (例如在Ubuntu或Debian系统上）：</para> <programlisting>apt-get install libaio</programlisting> </section> <section id="installation.standalone"> - <title>Stand-alone HornetQ Server</title> - <para>After downloading the distribution, unzip it into your chosen directory. At this point - it should be possible to <link linkend="running.standalone">run straight out of the - box</link>, the following describes the directory structure: </para> + <title>单独的HornetQ服务器</title> + <para>将软件包下载后，将其解压到你选定的目录下。这里你就可以<link linkend="running.standalone">直接运行了</link>。 + 下面给出了它的目录结构： </para> <programlisting> |___ bin | @@ -68,49 +65,46 @@ </programlisting> <itemizedlist> <listitem> - <para><literal>bin</literal> -- binaries and scripts needed to run HornetQ.</para> + <para><literal>bin</literal> -- 运行HornetQ的二进制文件和脚本文件。</para> </listitem> <listitem> - <para><literal>config</literal> -- configuration files needed to configure HornetQ. This - contains configurations to run HornetQ either in stand-alone or inside JBoss AS 4 and 5. - Please refer to the reference guide for details on configuration. </para> + <para><literal>config</literal> -- HornetQ的配置文件。它包括了单独模式或者运行在 + JBoss AS 4 或 5中的配置。请参考配置索引来了解配置有详细信息。</para> </listitem> <listitem> - <para><literal>docs</literal> -- guides and javadocs for HornetQ </para> + <para><literal>docs</literal> -- HornetQ的文档及Javadoc。 </para> </listitem> <listitem> - <para><literal>examples</literal> -- JMS and Java EE examples. Please refer to the - 'running examples' chapter for details on how to run them. </para> + <para><literal>examples</literal> -- JMS and Java EE例子。有关详细信息请参见 + 'running examples'一章。 </para> </listitem> <listitem> - <para><literal>lib</literal> -- jars and libraries needed to run HornetQ </para> + <para><literal>lib</literal> -- 运行HornetQ所需要的jar文件和库文件 </para> </listitem> <listitem> - <para><literal>licenses</literal> -- licenses for HornetQ </para> + <para><literal>licenses</literal> -- HornetQ的软件协议</para> </listitem> <listitem> - <para><literal>schemas</literal> -- XML Schemas used to validate HornetQ configuration - files</para> + <para><literal>schemas</literal> -- HornetQ配置文件的XML Schema</para> </listitem> </itemizedlist> </section> <section id="installation.jboss.as5"> - <title>HornetQ In JBoss Application Server 5.x</title> - <para>HornetQ can also be deployed in <ulink url="http://www.jboss.org/jbossas/">JBoss AS - 5</ulink>. It is not currently shipped by default with the application server (it is - scheduled to be shipped as default JMS provider in JBoss Application Server 6.0), so you - will need to create new AS 5 profiles to run AS 5 with HornetQ.</para> - <para>To create AS 5 profiles:</para> + <title>HornetQ运行于JBoss应用服务器5.x</title> + <para>HornetQ可以部署在<ulink url="http://www.jboss.org/jbossas/">JBoss AS + 5</ulink>中。目前默认的应用服务器没有安装HornetQ（HornetQ将是JBoss 6的默认JMS提供者），因此 + 你需要为HornetQ创建新的AS 5的配置（profile）。</para> + <para>创建AS 5新配置的步骤：</para> <orderedlist> <listitem> - <para>Download JBoss AS 5</para> + <para>下载并安装JBoss AS 5</para> </listitem> <listitem> - <para>Set the environment property <literal>JBOSS_HOME</literal> to point to the - directory where you installed JBoss AS 5</para> + <para>设置环境变量<literal>JBOSS_HOME</literal>指向JBoss AS 5的安装目录。</para> </listitem> <listitem> - <para>run <literal>./build.sh</literal> (or <literal>build.bat</literal> if you are on + <para>运行HornetQ的<literal>config/jboss-as-5</literal>下的<literal>./build.sh</literal> （或 + 者如果在Windows下运行<literal>build.bat</literal>）。 if you are on Windows) in HornetQ <literal>config/jboss-as-5</literal> directory</para> </listitem> </orderedlist> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml 2010-05-10 06:09:57 UTC (rev 9214) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/introduction.xml 2010-05-10 08:50:33 UTC (rev 9215) @@ -17,12 +17,9 @@ <!-- permitted by applicable law. --> <!-- ============================================================================= --> <chapter id="introduction"> - <title>Getting Started</title> - <para>This short guide explains how to download, install and quickly get started with - HornetQ.</para> - <para>After downloading and installing we highly recommend you run the examples to get - acquainted with HornetQ. We ship with over 70 examples demonstrating most of the - features.</para> - <para>This guide is not intended to be a replacement for the user manual. The user manual goes - into much more depth, so please consult that for further information.</para> + <title>快速入手</title> + <para>本简短的指南给出了如何下载、安装HornetQ，以及尽快开始使用HornetQ。</para> + <para>我们强烈建议当下载安装完成后，运行HornetQ的例子来了解HornetQ。我们有70多个例子来展示几乎 + 所有HornetQ的功能。</para> + <para>本指南不能代替用户手册。用户手册包括更加完整和深入的信息，供用户进一步全面掌握HornetQ。</para> </chapter> Modified: branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml =================================================================== --- branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml 2010-05-10 06:09:57 UTC (rev 9214) +++ branches/HnetQ_323_cn/docs/quickstart-guide/zh/notice.xml 2010-05-10 08:50:33 UTC (rev 9215) @@ -16,17 +16,14 @@ <!-- permitted by applicable law. --> <!-- ============================================================================= --> + <chapter id="notice"> - <title>Legal Notice</title> + <title>法律声明</title> + + <para>Red Hat, Inc. 以及其他公司2010年版权所有。</para> + <para>Red Hat公司依照 CC-BY-SA 3.0 Unported(Creative Commons + Attribution-Share Alike)条款之规定授权用戶是用本手册中的文字和插图。</para> + <para>有关 CC-BY-SA 的解释请访问<ulink url="http://creativecommons.org/licenses/by-sa/3.0/">http://... + <para>Red Hat 作为本文档的授权方声明在相关法律允许的最大范围内放弃CC-BY-SA第4d节所规定的权利。</para> +</chapter> - <para>Copyright © 2010 Red Hat, Inc. and others.</para> - <para>The text of and illustrations in this document are licensed by Red Hat under - a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA").</para> - <para>An explanation of CC-BY-SA is available at - <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">http://...;. - In accordance with CC-BY-SA, if you distribute this document or an adaptation - of it, you must provide the URL for the original version.</para> - <para>Red Hat, as the licensor of this document, waives the right to enforce, - and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent - permitted by applicable law.</para> -</chapter> \ No newline at end of file