#
msgid ""
msgstr ""
"Project-Id-Version: Modelica by Example 0.2.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-04-14 10:14-0400\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../source/behavior/equations/annotations.rst:4
msgid "Annotations"
msgstr "标注"

#: ../../source/behavior/equations/annotations.rst:6
msgid ""
"Recall in the discussion on :ref:`experimental-conditions` we included "
"information about the simulation start and stop time using an "
"``annotation``.  An ``annotation`` is a way to include information that is "
"not related to the behavior of the model.  In the case of experimental "
"conditions, we injected information about how a particular model should be "
"simulated.  But annotations are used extensively in Modelica to provide all "
"kinds of additional information about models.  For example, as we'll see "
":ref:`later in the book <graphical-annos>`, annotations are used to describe"
" the graphical appearance of components and connectors.  For now, the "
"important thing is to understand that annotations are additional data, above"
" and beyond behavior, that can be \"attached\" to different elements in "
"Modelica."
msgstr ""
"回顾一下，在\\ :ref:`experimental-conditions`\\ 章节中，我们讨论了通过\\ ``annotation``\\ "
"功能定义模型仿真开始和结束的时间。\\ 通过\\ ``annotation``\\ 功能包含上述信息是一种方法，并且不包含与模型特性相关的信息。\\ "
"在试验条件下，我们可以定义特定模型如何进行仿真的信息。\\ 但是，在Modelica语言中，标注广泛应用于提供各种与模型相关的附加信息。\\ 例如，\\"
" :ref:`\\ 在后续的章节中\\ <graphical-annos>`\\ ，我们可以看到标注可以用来描述图形外观组件和连接器。\\ "
"现在，更重要是要理解标注只是额外的数据，除了描述模型的物理特性，它可以“附加”在Modelica不同的元素上。\\ "

#: ../../source/behavior/equations/annotations.rst:20
msgid ""
"In this section, we will first cover where an ``annotation`` can appear in a"
" Modelica model.  Next, we'll explain how we can use :ref:`record-def` to "
"describe the contents of an annotation.  Finally, we'll describe a few of "
"the many \"standard\" annotations that are included as part of the Modelica "
"specification."
msgstr ""
"在本节中，我们将首先讨论 \\ ``annotation``\\  在Modelica模型中可以出现的地方。\\ 接下来，我们将解释如何使用\\ "
":ref:`record-def`\\ 来描述标注所包含的内容。\\ 最后，我们将介绍一些包含在Modelica规范内的“标准”标注。\\ "

#: ../../source/behavior/equations/annotations.rst:27
msgid "Annotation Locations"
msgstr "标注的位置"

#: ../../source/behavior/equations/annotations.rst:29
msgid ""
"Annotations can appear in many different places in Modelica.  We will "
"discuss each potential location and demonstrate the syntax for each case."
msgstr "标注可以在Modelica模型的不同位置上出现。\\ 我们将讨论每个可能出现的位置，并讲述每种情况下的语法。\\ "

#: ../../source/behavior/equations/annotations.rst:33
msgid "Declaration Annotations"
msgstr "标注的声明"

#: ../../source/behavior/equations/annotations.rst:37
msgid ""
"A declaration annotation comes at the end of a declaration, right before the"
" ``;``.  Here is a simple declaration that includes an annotation:"
msgstr "标注的声明紧跟在一个声明的后面，并且在标示符 \\ ``;``\\  的前面。\\ 下面是一个包含标注的简单声明："

#: ../../source/behavior/equations/annotations.rst:45
msgid ""
"Note that the ``annotation`` comes after the descriptive string and before "
"the ``;``.  Also, the ``...`` is simply a place holder for the :ref"
":`annotation-data`, which will be discussed shortly."
msgstr ""
"从上述程序段中可以看到，标注紧跟在描述性字符串的后面，并在标示符\\ ``;``\\ 的前面。\\ 另外，括号内的\\ ``...``\\ "
"只是用来放置\\ :ref:`annotation-data`\\ 的占位符。\\ 具体内容将在本书后面的章节中讨论。\\ "

#: ../../source/behavior/equations/annotations.rst:50
msgid "Statement and Equation Annotations"
msgstr "语句标注和方程标注"

#: ../../source/behavior/equations/annotations.rst:54
msgid ""
"It is also possible to associate annotations with equations, for example:"
msgstr "另外，也可以将标注和方程相关联，例如："

#: ../../source/behavior/equations/annotations.rst:65
msgid "Inheritance Annotations"
msgstr "标注的继承"

#: ../../source/behavior/equations/annotations.rst:69
msgid ""
"We briefly discussed the ``extends`` keyword when we talked about "
":ref:`modifications` and :ref:`avoiding-repetition`.  It is possible to "
"associate an ``annotation`` with an ``extends`` clause as follows:"
msgstr ""
"在章节\\ :ref:`modifications`\\ 和\\ :ref:`avoiding-repetition`\\ "
"中，我们已经简单的对关键词\\ ``extends``\\ 进行了讨论。\\ 如下所示，我们也可以将\\ ``annotation``\\ 和\\ "
"``extends``\\ 相关联："

#: ../../source/behavior/equations/annotations.rst:77
msgid ""
"As we've observed in each previous case, the ``annotation`` immediately "
"precedes the ``;``."
msgstr "正如我们在前面的每个例子中观察到的那样，\\ ``annotation``\\ 的声明总是在标示符\\ ``;``\\ 的前面结束。\\ "

#: ../../source/behavior/equations/annotations.rst:82
msgid "Model Annotations"
msgstr "模型的标注"

#: ../../source/behavior/equations/annotations.rst:87
msgid ""
"A model annotation associates annotation data directly with the model "
"definition itself.  This is exactly the kind of annotation we saw when "
"describing :ref:`experimental-conditions`, *e.g.,*"
msgstr ""
"与模型标注相关的标注数据直接在模型自身定义的时候声明。\\ 这正正是在前面章节里对\\ :ref:`experimental-conditions`\\"
" 讨论的时候，我们所看到的标注，即："

#: ../../source/behavior/equations/annotations.rst:97
msgid ""
"Note how, unlike all the previous annotation locations we've described, this"
" annotation isn't really \"attached\" to anything.  This indicates that it "
"is annotating the model itself."
msgstr "请注意，与我们前面描述的标注位置不同，该标注并没有附加到任何部分上。\\ 这表明它是模型本身的标注。\\ "

#: ../../source/behavior/equations/annotations.rst:104
msgid "Annotation Data"
msgstr "标注数据"

#: ../../source/behavior/equations/annotations.rst:107
msgid "General Syntax"
msgstr "一般的语法"

#: ../../source/behavior/equations/annotations.rst:109
msgid ""
"The syntax of an annotation is the same syntax used for "
":ref:`modifications`.  This means the annotation will include either an "
"assignment to a variable in the annotation, *e.g.,*"
msgstr "标注的使用语法与前面章节\\ :ref:`modifications`\\ 讨论的语法相同。\\ 这就意味着，标注中即可以包含对变量的赋值，如："

#: ../../source/behavior/equations/annotations.rst:117
msgid ""
"or it will include a modification to something **inside** a variable in the "
"annotation, *e.g.,*"
msgstr "也可以包含对一些\\ **内部**\\ 变量的修改，如"

#: ../../source/behavior/equations/annotations.rst:125
msgid "User Annotations"
msgstr "用户标注"

#: ../../source/behavior/equations/annotations.rst:127
msgid ""
"Annotations were designed to allow model developers to attach **arbitrary "
"data** to their models.  For example, if a user wanted to associate a part "
"number with a given model definition, they might introduce a model "
"annotation like this:"
msgstr ""
"标注就是为了方便模型开发者将\\ **任意数据**\\ 添加到模型中而设计的。\\ "
"例如，如果用户想要将部分数据与给定的模型定义相关联，他们可以为模型添加如下的标注："

#: ../../source/behavior/equations/annotations.rst:136
msgid ""
"A general principle of annotation data is that if a tool reads in a model, "
"**it must preserve the annotation information** when it writes it back out."
"  The tool does not (and, in general, will not) have to understand the data."
"  But the data must be preserved."
msgstr ""
"标注数据的一般原则是，读取模型的工具，在写入模型的时候，\\ **必须保留标注信息**\\ 。\\ "
"该工具不必（一般来说，无需）理解读入的标注信息，但是，必须将这些数据保存。\\ "

#: ../../source/behavior/equations/annotations.rst:142
msgid "Multiple Annotations"
msgstr "多个标注"

#: ../../source/behavior/equations/annotations.rst:144
msgid ""
"Imagine a user wanted to specify **both** a part number and an experiment "
"annotation.  Then they might end up with an annotation like this one:"
msgstr "假设，用户想要\\ **同时**\\ 指定编号和试验标注，他们可以采用下述方式定义标注："

#: ../../source/behavior/equations/annotations.rst:153
msgid ""
"Note how these two pieces of information can exist side by side.  One way to"
" think about annotations is to visualize them as a tree like this:"
msgstr "注意，这两条标注信息可以并存。\\ 可以将标注可视化为如下树状结构来理解标注的定义："

#: ../../source/behavior/equations/annotations.rst:164
msgid "Namespaces"
msgstr "命名空间"

#: ../../source/behavior/equations/annotations.rst:166
msgid ""
"This introduces another principle of annotations which is that it should be "
"possible to have more than one **as long as the names are different**.  For "
"this reason, choosing names is very important and they should be chosen to "
"avoid potential conflicts with other names. For example, a better approach "
"for including the part number would be to enclose it in a variable that is "
"more likely to be unique to your company or application, *e.g.,*:"
msgstr ""
"这就引入另一个关于标注的原则。\\ \\ **只要标注的名称不同**\\ ，我们就可以一次加入多个。\\ 由于这个原因，名称的选取很重要。\\ "
"我们应避免与其他名称的潜在冲突。\\ 例如，在加入零件号时，最好要将其放一个特别的变量内。\\ "
"这个变量最好应该和你的公司或者应用情况相关，而且足够特别。\\ 例如："

#: ../../source/behavior/equations/annotations.rst:179
msgid ""
"In this case, the variable ``XogenyIndustries`` can be used to carve out a "
"\"namespace\" for a specific organization or purpose.  If another "
"organization came along and wanted to associate a different part number with"
" the same model, they could do that by establishing their own separate "
"hierarchy in the annotation, *e.g.,*:"
msgstr ""
"在本例里，变量\\ ``XogenyIndustries``\\ 可以为某个特定组织或目的创建出一个“命名空间”。\\ "
"如果其他组织想要一个不同的部件号与同一个模型相关联，他们就能通过在自己的标注中的层次中做到这一点，如："

#: ../../source/behavior/equations/annotations.rst:191
msgid ""
"Occasionally, Modelica tool vendors include their own special annotations "
"(*e.g.,* in the Modelica Standard Library).  By convention, tool vendors use"
" names that are prefixed by two underscores, *e.g.,*"
msgstr ""
"有时候，Modelica的工具供应商会加入他们自己的特殊标注（如在Modelica的标准库中）。\\ "
"按照惯例，工具供应商使用以两个下划线为前缀的名字，如："

#: ../../source/behavior/equations/annotations.rst:204
msgid "Interpretation"
msgstr "解释"

#: ../../source/behavior/equations/annotations.rst:206
msgid ""
"Remember that annotation data is arbitrary.  This allows arbitrary data to "
"be associated with the model.  The **meaning** of that data is, in general, "
"not defined in the Modelica specification.  As we will see shortly, there "
"are a few \"standard\" annotations (they will be described throughout this "
"book) and they are documented in the specification.  But when users add "
"annotations beyond the standard annotations it is assumed that they have "
"some way (using some Modelica tool, compiler or other Modelica aware "
"technology) of extracting and interpreting their annotation data."
msgstr ""
"请记住，标注数据是任意的。\\ 这使得模型可与任意数据相关联的。\\ 数据的\\ **意义**\\ 在一般情况下并没有定义在Modelica标准里。\\"
" 正如我们将马上看到的一样，存在几个“标准”标注（我们会在整本书中描述）。\\ 这些标注都记录在标准里。\\ "
"但是，如果用户添加了标准外的标注，工具会假设用户有一些方法（使用某些Modelica的工具、编译器或其它可以读取Modelica的技术）去提取并解释其标注数据。\\"
" "

#: ../../source/behavior/equations/annotations.rst:216
msgid ""
"The bottom line is that while you can inject (non-standard) annotation data "
"into the model, tools are only required to preserve it and not to interpret "
"it."
msgstr "也就是说，虽然你可以对模型添加（非标准）标注数据，但工具只需要保存该标注，而毋须进行解析。\\ "

#: ../../source/behavior/equations/annotations.rst:221
msgid "Documentation"
msgstr "记录"

#: ../../source/behavior/equations/annotations.rst:223
msgid ""
"It is very common to document Modelica annotations **as if** they had :ref"
":`record-def` associated with them.  We'll see several examples of this "
"technique in our next topic.  Using this approach to document expected "
"annotation data are strongly encouraged.  In fact, this technique is so "
"popular and useful that there are proposals to actually make it part of the "
"language itself in the future."
msgstr ""
"记录Modelica标注时常常\\ **假设**\\ 标注和某个\\ :ref:`record-def`\\ 相关联。\\ "
"我们将在下个主题看到这个技巧的几个例子。\\ 强烈建议大家使用这种方法来记录预期的标注数据。\\ "
"其实，这种技术如此的流行而且实用，以致于有人建议，让其实际上成为语言本身的一部分。\\ "

#: ../../source/behavior/equations/annotations.rst:231
msgid "Introductory Annotations"
msgstr "简单标注"

#: ../../source/behavior/equations/annotations.rst:233
msgid ""
"This section introduces just a few of the \"standard annotations\" in "
"Modelica.  As discussed previously, annotations are generally allowed to "
"include arbitrary data that is preserved by tools and, presumably, "
"interpreted at some point.  The syntax and meaning of the standard "
"annotations are described in the Modelica specification so they can be "
"interpreted consistently and universally by Modelica tools."
msgstr ""
"这部分介绍了Modelica的几个“标准标注”。\\ 这如前面所讨论，标注通常可以包含任意信息。\\ "
"这些标注不会被工具改变，而且可能会在某些时候得到解析。\\ 标准标注的语法和意义在Modelica标准都有描述。\\ "
"这样，这些标注就能Modelica工具得到一致以及普遍的解析。\\ "

#: ../../source/behavior/equations/annotations.rst:240
msgid ""
"We will follow a convention (whenever possible) of describing standard "
"annotations in terms of ``record`` definitions.  These ``record`` "
"definitions don't formally exist, they are simply a concise way of "
"expressing the data contained in the annotation."
msgstr ""
"我们将（尽可能地）按照\\ ``record``\\ 定义的方式去描述标准标注。\\ 这些\\ ``record``\\ 定义不正式存在。\\ "
"它们只是一种表达包含在标注中数据的简明方式。\\ "

#: ../../source/behavior/equations/annotations.rst:246
msgid "``Documentation``"
msgstr ""

#: ../../source/behavior/equations/annotations.rst:250
#: ../../source/behavior/equations/annotations.rst:291
msgid "**Type: Model Annotation**"
msgstr "\\ **类型**\\ ：模型标注"

#: ../../source/behavior/equations/annotations.rst:252
msgid ""
"The ``Documentation`` annotation in Modelica allows raw text or HTML to be "
"associated with a model as documentation.  This documentation is composed of"
" two components.  The first is information about the model and the second is"
" revision history information.  The structure of the ``Documentation`` "
"annotation is described by the following record definition:"
msgstr ""
"Modelica的\\ ``Documentation``\\ 标注可用纯文本或HTML表示模型相关文档。\\ 文档是由两部分组成。\\ "
"第一部分是有关模型的信息。\\ 第二部分则是关于模型修订历史的信息。\\ The structure of the ``Documentation`` "
"annotation is described by the following record definition:\\ "
"``Documentation``\\ 标注的结构可以用下列记录定义表示："

#: ../../source/behavior/equations/annotations.rst:266
msgid ""
"When embedding HTML inside an annotation, the HTML code must be surrounded "
"by ``<html>`` tags, *e.g.,*"
msgstr "当在标注里面嵌入HTML是， HTML代码必须由\\ ``<html>``\\ 标记包围，如："

#: ../../source/behavior/equations/annotations.rst:158
#: ../../source/behavior/equations/annotations.rst:287
msgid "``experiment``"
msgstr "试验"

#: ../../source/behavior/equations/annotations.rst:293
msgid ""
"The ``experiment`` annotation is used to specify information about how a "
"given model should be simulated.  The annotation data can be represented in "
"``record`` form as:"
msgstr "\\ ``experiment``\\ 标注用于指定模型仿真方式的信息。\\ 标注数据可以用\\ ``record``\\ 形式表示如下："

#: ../../source/behavior/equations/annotations.rst:307
msgid "``Evaluate``"
msgstr "Evaluate标注"

#: ../../source/behavior/equations/annotations.rst:311
msgid "**Type: Declaration Annotation (applies to parameters)**"
msgstr "\\ **类型**\\ ：声明标注（适用于参数）"

#: ../../source/behavior/equations/annotations.rst:313
msgid ""
"The ``Evaluate`` annotation indicates to a Modelica compiler that the value "
"of a given ``parameter`` can be transformed into a ``constant`` at compile "
"time.  In other words, it indicates that the user does not require the "
"ability to change the value of the ``parameter`` from one simulation to the "
"next."
msgstr ""
"\\ ``Evaluate``\\ 标注指示Modelica编译器，指定\\ ``parameter``\\ 值在编译的时候可以转化为\\ "
"``constant``\\ 。\\ 换句话说，标注表示该用户不需要在每次仿真都改变\\ ``parameter``\\ 的值。\\ "

#: ../../source/behavior/equations/annotations.rst:319
msgid ""
"The motivation behind having such an annotation is that it allows the "
"Modelica compiler to assume many things about the ``parameter`` during model"
" compilation that it otherwise couldn't.  These assumptions might restrict "
"the system of equations in such a way that the underlying systems of "
"equations are easier to solve than in the general case where the parameter "
"could take on a range of values."
msgstr ""
"这种标注背后的动机在于，它允许Modelica编译器在编译期间对\\ ``parameter``\\ 进行一些之前不可能的假设。\\ "
"这些假设可能限制方程组，让其变得更容易解。\\ 因为参数不再会像一般情况那样有一个取值范围。\\ "

#: ../../source/behavior/equations/annotations.rst:326
msgid ""
"The ``Evaluate`` annotation is simply a ``Boolean`` variable (``true`` "
"indicating that the ``parameter`` value can be transformed into a "
"``constant``). It is used in an annotation as follows:"
msgstr ""
"\\ ``Evaluate``\\ 标注只是个\\ ``Boolean``\\ 变量（\\ ``True``\\ 值表示\\ "
"``parameter``\\ 值可以转化为\\ ``constant``\\ ）。\\ 这在标注可以使用如下："

#: ../../source/behavior/equations/annotations.rst:335
msgid "``HideResult``"
msgstr "HideResult标注"

#: ../../source/behavior/equations/annotations.rst:339
msgid "**Type: Declaration Annotation**"
msgstr "\\ **类型**\\ ：声明标注"

#: ../../source/behavior/equations/annotations.rst:341
msgid ""
"The ``HideResult`` annotation is used to indicate that the solution for a "
"given variable is not of interest to the analyst.  By setting the value of "
"``HideResult`` to ``true``, the model developer is indicating to the "
"Modelica compiler that it need not store the annotated variable in any "
"simulation results that are produced.  This can save both simulation time "
"and disk space because it avoids writing out data that will never be viewed."
msgstr ""
"\\ ``HideResult``\\ 标注用于表明，分析者并不关心该变量的解。\\ 通过把\\ ``HideResult``\\ 值设置为\\ "
"``True``\\ ，\\ 模型开发者告诉Modelica编译器并不需要在任何产生的结果里储存被标注的值。\\ 这可以节省模拟时间和磁盘空间。\\ "
"因为这样避免了写入根本不会被读取的数据。\\ "

#: ../../source/behavior/equations/annotations.rst:349
msgid "The ``HideResult`` annotation would be used as follows:"
msgstr "\\ ``HideResult``\\ 标注使用如下："

#: ../../source/behavior/equations/annotations.rst:61
msgid ""
"In declarations and equations, the ``annotation`` is always at the very end "
"and comes immediately before the ``;``."
msgstr "标注总是紧跟在声明和方程定义的结束处，并且在标示符 ``;`` 的前面。\\ "

#: ../../source/behavior/equations/annotations.rst:157
msgid "``PartNumber=\"FF78-E4B879\"``"
msgstr ""

#: ../../source/behavior/equations/annotations.rst:160
msgid "``StartTime=0``"
msgstr ""

#: ../../source/behavior/equations/annotations.rst:161
msgid "``StopTime=8``"
msgstr ""

#: ../../source/behavior/equations/annotations.rst:279
msgid ""
"Here the model ``MyWidget`` contains HTML documentation.  The documentation "
"is wrapped by ``<html>`` tags **and all quotes used to define attributes are"
" escaped by \\\\\"** to avoid accidentally terminating the ``info`` string."
msgstr ""
"这里的\\ ``MyWidget``\\ 模型包含HTML文档。\\ 文档在\\ ``<html>``\\ 标记内，**所有用于定义属性的引号都用\\ "
"\\\"\\ 进行转义**\\ ，以避免意外地终结\\ ``info``\\ 字符串。\\ "
