[boost-doc-zh] r342 committed - [No log message]

  • From: boost-doc-zh@xxxxxxxxxxxxxx
  • To: boost-doc-zh-notify@xxxxxxxxxxxxx
  • Date: Sun, 08 Nov 2009 13:29:17 +0000

Revision: 342
Author: shomnia
Date: Sun Nov  8 05:28:15 2009
Log: [No log message]
http://code.google.com/p/boost-doc-zh/source/detail?r=342

Modified:
 /trunk/more/writingdoc/design.html

=======================================
--- /trunk/more/writingdoc/design.html  Sat Sep 12 01:00:21 2009
+++ /trunk/more/writingdoc/design.html  Sun Nov  8 05:28:15 2009
@@ -3,10 +3,37 @@
 <html>
 <head>
   <meta http-equiv="Content-Language" content="en-us">
-  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   <link rel="stylesheet" type="text/css" href="../../boost.css">

   <title>Writing Documentation for Boost - HTML Design</title>
+       <style>
+<!--
+div.Section1
+       {page:Section1;}
+ table.MsoNormalTable
+       {mso-style-parent:"";
+       font-size:10.0pt;
+       font-family:"Times New Roman";
+       }
+ div.MsoNormal
+       {mso-style-parent:"";
+       margin-bottom:.0001pt;
+       font-size:12.0pt;
+       font-family:"Times New Roman";
+       margin-left:0cm; margin-right:0cm; margin-top:0cm}
+span.GramE
+       {}
+span.SpellE
+       {}
+ li.MsoNormal
+       {mso-style-parent:"";
+       margin-bottom:.0001pt;
+       font-size:12.0pt;
+       font-family:"Times New Roman";
+       margin-left:0cm; margin-right:0cm; margin-top:0cm}
+-->
+</style>
 </head>

 <body link="#0000FF" vlink="#800080">
@@ -20,557 +47,1427 @@

       <td valign="top">
         <h1 align="center">Writing Documentation for Boost</h1>
+               <h1 align="center">为Boost写文档<SPAN
+      style="mso-fareast-font-family: 'Times New Roman'"
+      lang=EN-US><o:p></o:p></SPAN></h1>

         <h2 align="center">HTML Design</h2>
+      <H2 style="TEXT-ALIGN: center" align=center><SPAN
+      style="mso-fareast-font-family: 'Times New Roman'"
+      lang=EN-US>&nbsp;HTML</SPAN><SPAN
+ style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">设计</SPAN><SPAN
+      style="mso-fareast-font-family: 'Times New Roman'"
+      lang=EN-US><o:p></o:p></SPAN></H2>
       </td>
     </tr>
   </table>
   <hr>

-  <dl class="page-index">
-    <dt><a href="#introduction">Introduction</a></dt>
-
-    <dt><a href="#common-pages">Common Pages Included in HTML
-    Documentation</a></dt>
-
-    <dd>
-      <dl class="page-index">
-        <dt><a href="#index-page">Index</a></dt>
-
-        <dt><a href="#overview-page">Overview</a></dt>
-
-        <dt><a href="#definitions-page">Definitions</a></dt>
-
-        <dt><a href="#rationale-page">Rationale</a></dt>
-
- <dt><a href="#configuration-page">Configuration Information</a></dt>
-
-        <dt><a href="#faq-page">Frequently Asked Questions</a></dt>
-
-        <dt><a href="#bibliography-page">Bibliography</a></dt>
-
-        <dt><a href="#acknowledgements-page">Acknowledgment</a></dt>
-
-        <dt><a href="#header-page">Header Reference</a></dt>
-      </dl>
-    </dd>
-
-    <dt><a href="#layout">Layout</a></dt>
-
-    <dd>
-      <dl class="page-index">
-        <dt><a href="#page-banner">Page Banner</a></dt>
-
-        <dt><a href="#page-index">Page Index</a></dt>
-
-        <dt><a href="#content">Documentation Content</a></dt>
-
-        <dd>
-          <dl class="page-index">
-            <dt><a href="#doc-footnotes">Footnotes</a></dt>
-          </dl>
-        </dd>
-
-        <dt><a href="#revision-info">Revision Information</a></dt>
-
-        <dt><a href="#copyright">Copyright Information</a></dt>
-      </dl>
-    </dd>
-
-    <dt><a href="#format">Format</a></dt>
-
-    <dd>
-      <dl class="page-index">
-        <dt><a href="#style-sheets">Cascading Style Sheets</a></dt>
-
-        <dd>
-          <dl class="page-index">
-            <dt><a href="#boost-style-sheet">Boost Style Sheet</a></dt>
-          </dl>
-        </dd>
-      </dl>
-    </dd>
-
-    <dt><a href="#templates">Templates</a></dt>
-
-    <dd>
-      <dl class="page-index">
-        <dt><a href="#index-template">Index Page Template</a></dt>
-
-        <dt><a href="#overview-template">Overview Page Template</a></dt>
-
-        <dt><a href="#definitions-template">Definitions Page
-        Template</a></dt>
-
-        <dt><a href="#rationale-template">Rationale Page Template</a></dt>
-
-        <dt><a href="#configuration-template">Configuration Page
-        Template</a></dt>
-
-        <dt><a href="#faq-template">FAQ (Frequently Asked Questions) Page
-        Template</a></dt>
-
-        <dt><a href="#bibliography-template">Bibliography Page
-        Template</a></dt>
-
-        <dt><a href="#acknowledgements-template">Acknowledgments Page
-        Template</a></dt>
-
-        <dt><a href="#header-template">Header Page Template</a></dt>
-      </dl>
-    </dd>
+  <body link="#0000FF" vlink="#800080">
+
+  <dl class="page-index">
+
+<DIV class=Section1>
+<P class=MsoNormal><SPAN lang=EN-US>
+<A href="#introduction" style="color: blue; text-decoration: underline; text-underline: single">
+Introduction</A>
+</SPAN></P>
+<P class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#introduction" style="color: blue; text-decoration: underline; text-underline: single">
+介绍</a></SPAN></P>
+<P class=MsoNormal><SPAN lang=EN-US>
+<a href="#Common_Pages" style="color: blue; text-decoration: underline; text-underline: single">
+Common Pages Included in HTML Documentation</a> </SPAN></P>
+<P class=MsoNormal align="left">
+<a href="#Common_Pages" style="color: blue; text-decoration: underline; text-underline: single"><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">文档包含的常见页面</SPAN></a></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<a href="#index-page" style="color: blue; text-decoration: underline; text-underline: single">
+Index</a> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#index-page" style="color: blue; text-decoration: underline; text-underline: single">
+索引</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#overview-page" style="color: blue; text-decoration: underline; text-underline: single">
+Overview</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#overview-page" style="color: blue; text-decoration: underline; text-underline: single">
+概述</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#definitions-page" style="color: blue; text-decoration: underline; text-underline: single">
+Definitions</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#definitions-page" style="color: blue; text-decoration: underline; text-underline: single">
+定义</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#rationale-page" style="color: blue; text-decoration: underline; text-underline: single">
+Rationale</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#rationale-page" style="color: blue; text-decoration: underline; text-underline: single">
+原理</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#configuration-page" style="color: blue; text-decoration: underline; text-underline: single">
+Configuration Information</A></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>&nbsp;</SPAN><SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"><a href="#configuration-page" style="color: blue; text-decoration: underline; text-underline: single">配置 信息</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#faq-page" style="color: blue; text-decoration: underline; text-underline: single">
+Frequently Asked Questions</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#faq-page" style="color: blue; text-decoration: underline; text-underline: single">
+常见问题</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#bibliography-page" style="color: blue; text-decoration: underline; text-underline: single">
+Bibliography</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#bibliography-page" style="color: blue; text-decoration: underline; text-underline: single">
+参考文献</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#acknowledgements-page" style="color: blue; text-decoration: underline; text-underline: single">
+Acknowledgment</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#acknowledgements-page" style="color: blue; text-decoration: underline; text-underline: single">
+致谢</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#header-page" style="color: blue; text-decoration: underline; text-underline: single">
+Header Reference</A></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal>
+<a href="#header-page" style="color: blue; text-decoration: underline; text-underline: single">
+头文件参考</a></P>
+<P class=MsoNormal><SPAN lang=EN-US>
+<A href="#layout" style="color: blue; text-decoration: underline; text-underline: single">
+Layout</A> </SPAN></P>
+<P class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#layout" style="color: blue; text-decoration: underline; text-underline: single">
+布局</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#page-banner" style="color: blue; text-decoration: underline; text-underline: single">
+Page Banner</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal>
+<SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'" lang="EN-US"> +<a href="#page-banner" style="color: blue; text-decoration: underline; text-underline: single">
+页标题</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+页索引</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#content" style="color: blue; text-decoration: underline; text-underline: single">
+Documentation Content</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#content" style="color: blue; text-decoration: underline; text-underline: single">
+文档内容</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#doc-footnotes" style="color: blue; text-decoration: underline; text-underline: single">
+Footnotes</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#doc-footnotes" style="color: blue; text-decoration: underline; text-underline: single">
+注记</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#revision-info" style="color: blue; text-decoration: underline; text-underline: single">
+Revision Information</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#revision-info" style="color: blue; text-decoration: underline; text-underline: single">
+修订信息</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#copyright" style="color: blue; text-decoration: underline; text-underline: single">
+Copyright Information</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#copyright" style="color: blue; text-decoration: underline; text-underline: single">
+版权信息</a></SPAN></P>
+<P class=MsoNormal><SPAN lang=EN-US>
+<A href="#format" style="color: blue; text-decoration: underline; text-underline: single">
+Format</A> </SPAN></P>
+<P class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#format" style="color: blue; text-decoration: underline; text-underline: single">
+格式</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#style-sheets" style="color: blue; text-decoration: underline; text-underline: single">
+Cascading Style Sheets</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 9.5pt; mso-ascii-font-family: Arial; mso-hansi-font-family: Arial; mso-bidi-font-family: Arial"><FONT
+size=3>
+<a href="#style-sheets" style="color: blue; text-decoration: underline; text-underline: single">
+层叠样式表</a></FONT></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">
+Boost Style Sheet</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal>
+<a href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single"><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">样式表层叠样式表</SPAN></a></P>
+<P class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#templates" style="color: blue; text-decoration: underline; text-underline: single">
+Templates</A></SPAN></P>
+<P class=MsoNormal><SPAN lang=EN-US>&nbsp;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"><a href="#templates" style="color: blue; text-decoration: underline; text-underline: single">模板 </a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#index-template" style="color: blue; text-decoration: underline; text-underline: single">
+Index Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#index-template" style="color: blue; text-decoration: underline; text-underline: single">
+索引页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#overview-template" style="color: blue; text-decoration: underline; text-underline: single">
+Overview Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal align="left"><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#overview-page" style="color: blue; text-decoration: underline; text-underline: single">
+概述页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#definitions-template" style="color: blue; text-decoration: underline; text-underline: single">
+Definitions Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#definitions-template" style="color: blue; text-decoration: underline; text-underline: single">
+定义页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<a href="#rationale-template" style="color: blue; text-decoration: underline; text-underline: single">
+Rationale Page Template</a> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#rationale-template" style="color: blue; text-decoration: underline; text-underline: single">
+原理页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<a href="#configuration-template" style="color: blue; text-decoration: underline; text-underline: single">
+Configuration Page Template</a> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#configuration-template" style="color: blue; text-decoration: underline; text-underline: single">
+配置页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#faq-template" style="color: blue; text-decoration: underline; text-underline: single">
+FAQ (Frequently Asked Questions) Page Template</A>
+</SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#faq-template" style="color: blue; text-decoration: underline; text-underline: single">
+常见问题页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#bibliography-template" style="color: blue; text-decoration: underline; text-underline: single">
+Bibliography Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#bibliography-template" style="color: blue; text-decoration: underline; text-underline: single">
+参考文献页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#acknowledgements-template" style="color: blue; text-decoration: underline; text-underline: single">
+Acknowledgments Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal align="left"><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#acknowledgements-template" style="color: blue; text-decoration: underline; text-underline: single">
+致谢页模板</a></SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN lang=EN-US>
+<A
+href="#header-template" style="color: blue; text-decoration: underline; text-underline: single">
+Header Page Template</A> </SPAN></P>
+<P style="MARGIN-LEFT: 36pt" class=MsoNormal><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +<a href="#header-template" style="color: blue; text-decoration: underline; text-underline: single">
+头文件页模板</a></SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H2><A id=introduction0 name=introduction0></A><SPAN lang=EN-US>Introduction
+</SPAN></H2>
+<H2><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+介绍</SPAN></H2>
+<P><SPAN lang=EN-US>Boost places no requirements on the design of HTML
+documentation for library submitters. If you are submitting a library for which +documentation already exists in either HTML or in a form easily converted to +HTML then there is no need for you to read this document. However, if you have
+not yet written the documentation, or if you expect to have to translate
+documentation written in a format not easily convertible to HTML then this
+document can give you a lot of information on how to go about writing
+documentation in HTML.</SPAN></P>
+<P><SPAN lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">对库提交者的</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">文档设计没有要求。如果你提交一个 库,它的文档已经以</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">形式存在或以一种容易转换成 </SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的形式存在就没有必要读这份文档。然 而,如果你还没有写文档,或者你希望转换一种不容易转换成</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">格式的文档,这时该文档会给你许多关 于怎么以</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的格式写文档的信息。</SPAN></P> +<P><SPAN lang=EN-US>In several places this document assumes you&#39;re writing the
+documentation to conform to the structure described in the
+<A
+href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">
+Documentation Structure</A> document. There is no requirement that your
+documentation content follow these guidelines, but they provide an effective way +to communicate technical specifications for a library in a terse yet precise
+manner that&#39;s familiar to many Boost users.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +在该文档的一些地方假设你正在写文档,使其遵守<a href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">文档 结构</a>中描述的结构。没有要求你的文档遵守这些规则,但是它们提供一个有效的方 式</SPAN></P>
+<P><SPAN lang=EN-US>This document also contains links to
+<A
+href="#templates" style="color: blue; text-decoration: underline; text-underline: single"> +HTML template files</A> that can be used to rapidly develop documentation for a +library submission. These templates follow the guidelines presented here and in
+the
+<A href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">
+Documentation Structure</A>
+document.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+这个文档也包含指向</SPAN><SPAN
+lang=EN-US><a href="#templates" style="color: blue; text-decoration: underline; text-underline: single">HTML模板文件</a></SPAN><SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的链接,这些模板文件能够为要提交的 <SPAN +class=GramE>库快速</SPAN>开发文档。这些模板遵守这里以及<a href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">文档 结构</a>文件中列出的规则。</SPAN></P>
+<H2><SPAN style="mso-fareast-font-family: 'Times New Roman'" lang=EN-US>
+<a name="Common_Pages">Common Pages</a> Included in HTML Documentation</SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></H2>
+<H2>
+<SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'; mso-fareast-theme-font:minor-fareast">
+包含在</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'; mso-fareast-theme-font:minor-fareast">文档中的常用页面</SPAN></H2> +<P><SPAN lang=EN-US>Most HTML documentation projects will contain some common +pages. General guidelines for these common pages are provided below.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+大部分</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">文档项目包含一些常用页面。下面列出 了这些常用页面的指导编写规则。</SPAN></P>
+<H3><A name=index-page0></A><SPAN lang=EN-US>Index</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+索引</SPAN></H3>
+<P><SPAN lang=EN-US>The index page is the first page presented to a user when he +browses the documentation. Generally this page should not contain any actual +content, but instead contains a list of links to specific content. At a minimum
+this list should contain a link to every HTML page contained in the
+documentation. Optionally, sub-lists may be provided for individual pages
+linking to specific subjects within the page. These sub-lists should form a
+&quot;tree&quot; hierarchy based on the level of heading tag used for the specific
+subject.</SPAN></P><SPAN lang=EN-US>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +当用户浏览文档时,索引页是呈现给用户的第一个页面。一般来说这一页并不包含任 何实际的内容,相反该文件包含一个指向实际内容的链接列表。该链接列表至少包含指 向文档中每个</SPAN>HTML<SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">页面的链接。或者,一些子列表提供了 指向页内特殊主体的单独链接。这些子列表根据具体主题使用的标记形成一个“树”结 构。</SPAN></P></SPAN> +<P><SPAN lang=EN-US><SPAN style="mso-spacerun: yes">&nbsp;</SPAN>Inclusion of such +sub-lists for every page can make the index rather lengthy, and since each page
+should include its own
+<A href="#page-index" style="color: blue; text-decoration: underline; text-underline: single"> +Page Index</A>, it may make the navigation of the documentation easier if such
+sub-lists are avoided. However, there is one exception to this guideline:
+reference documentation should contain a link to every header file in the
+library and a sub-list with a link to every macro, value, type, class, function
+and object (see
+<A
+href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single"> +Documentation Structure</A>) found in the header. Users aren&#39;t always sure what +header file any of these may be contained in, so this structure in the index
+allows for easy navigation of the reference documentation.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +包含每页的子列表将使这个索引变得很长,由于每页都应当包含它自己的<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索引</a>,如果不列出页索引将使文档的导航更加容易。 然而有一个例外,参考文档应该包括指向库中每个头文件的索引,以及文档中指向每个 宏、值、类型、类、函数和对象</SPAN><SPAN
+lang=EN-US>(</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">参见<a href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">文档 结构</a></SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的子链接。用户并不总是确定包含哪些 头文件,因此这个索引结构允许更容易浏览参考文档。</SPAN></P>
+<P><SPAN lang=EN-US><o:p>&nbsp;</o:p></SPAN></P>
+<P><SPAN lang=EN-US>The index list should generally be constructed using an HTML
+&quot;definition list&quot; (&lt;dl&gt; and &lt;<SPAN class=SpellE><SPAN
+class=GramE>dt</SPAN></SPAN>&gt; tags). A definition list has no bullets or ordered +specifications and produces a cleaner layout then an unordered list (&lt;<SPAN class=SpellE>ul</SPAN>&gt; +and &lt;<SPAN class=SpellE>li</SPAN>&gt; tags) or an ordered list (&lt;<SPAN class=SpellE>ol</SPAN>&gt;
+and &lt;<SPAN
+class=SpellE>li</SPAN>&gt; tags). If you choose to use the common
+<A
+href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">
+Boost Style Sheet</A> you should add a
+</SPAN><CODE style="font-family: Courier New"><SPAN style="FONT-SIZE: 10pt"
+lang=EN-US>class=&quot;index&quot;</SPAN></CODE><SPAN lang=EN-US> attribute/value pair to
+the &lt;dl&gt; tag.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+索引列表应当使用一个</SPAN><SPAN
+lang=EN-US>HTML<SPAN class=GramE>”</SPAN></SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">定义列表</SPAN><SPAN
+class=GramE><SPAN lang=EN-US>”</SPAN></SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">构建</SPAN><SPAN
+lang=EN-US>(&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">。一个定义列表没有制定项目符号或规 格,并将产生一个清晰的布局如无序列表</SPAN><SPAN
+lang=EN-US>(&lt;<SPAN class=SpellE>ul</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">或有序列表</SPAN><SPAN
+lang=EN-US>(&lt;<SPAN class=SpellE>ol</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">。如果你选择使用普通的</SPAN><SPAN +lang=EN-US><a href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">Boost</a></SPAN><SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"><a href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">风格 表单</a>,你应当在</SPAN><SPAN
+lang=EN-US>&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签中加一个</SPAN><CODE style="font-family: Courier New"><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>class=&quot;index&quot;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">属性</SPAN><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>/</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">值对。</SPAN></CODE></P>
+<P><SPAN lang=EN-US>An Index page
+<A href="#index-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</A> is provided for use. </SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个索引页<a href="#index-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=overview-page0 name=overview-page0></A><SPAN lang=EN-US>Overview
+</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+概述</SPAN></H3>
+<P><SPAN lang=EN-US>The Overview page is used to introduce the reader to the +library. It should give a high-level overview of the purpose of the library and +introduce the reader to any concepts they may be unfamiliar with. This may also +be an appropriate place for some &quot;light&quot; rationale, though more thorough
+presentation of any rationale would be better placed in the
+<A
+href="#rationale-page" style="color: blue; text-decoration: underline; text-underline: single">
+Rational Page</A>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +概述页用来向读者介绍库。它应该有个高层次的概述介绍该库的用途以及向不熟悉的 读者介绍相关概念。这也是一个合适的介绍一些“浅层次”原理的地方,尽管更多的彻底 解释原理的地方最好放在<a href="#rationale-page" style="color: blue; text-decoration: underline; text-underline: single">原理页</a>。</SPAN></P> +<P><SPAN lang=EN-US>Like most content pages, the Overview page should include a +<A href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</A>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +像很多内容页一样,概述页面应当包含<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索引</a>。 </SPAN></P>
+<P><SPAN lang=EN-US>An Overview page
+<A href="#overview-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</A>
+is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个概述页<a href="#overview-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=definitions-page0 name=definitions-page0></A><SPAN
+lang=EN-US>Definitions </SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+定义</SPAN></H3>
+<P><SPAN lang=EN-US>The Definitions page is used to provide a list of
+definitions for terms that a user may be unfamiliar with.</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">定义页面用于提供一系列用户不熟悉的 术语定义。</SPAN></P> +<P><SPAN lang=EN-US>The definition list should generally be constructed using an +HTML &quot;definition list&quot; (&lt;dl&gt; and &lt;DT&gt; tags). A definition list has no bullets or
+ordered specifications and produces a cleaner layout then an unordered list
+(&lt;UL&gt; and &lt;<SPAN class=SpellE>li</SPAN>&gt; tags) or an ordered list (&lt;<SPAN class=SpellE>ol</SPAN>&gt;
+and &lt;<SPAN
+class=SpellE>li</SPAN>&gt; tags). If you choose to use the common
+<A
+href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">
+Boost Style Sheet</A> you should add a
+</SPAN><CODE style="font-family: Courier New"><SPAN style="FONT-SIZE: 10pt"
+lang=EN-US>class=&quot;definition&quot;</SPAN></CODE><SPAN lang=EN-US> attribute/value
+pair to the &lt;dl&gt; tag.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+定义列表一般使用一个</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">“定义列表”</SPAN><SPAN
+lang=EN-US>(&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;DT&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">。一个定义列表没有制定项目符号或规 格,它产生一个清晰的布局如无序列表</SPAN><SPAN
+lang=EN-US>(&lt;UL&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">或有序列表</SPAN><SPAN
+lang=EN-US>(&lt;<SPAN class=SpellE>ol</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">。如果你选择使用普通的</SPAN><SPAN
+lang=EN-US><A
+href="file:///C:/Documents%20and%20Settings/xwh/&#26700;&#38754;/more/writingdoc/~CP20.htm#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">Boost</A></SPAN><SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"><a href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single">风格 表单</a>,你应当在</SPAN><SPAN
+lang=EN-US>&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签中加一个</SPAN><CODE style="font-family: Courier New"><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>class=&quot;index&quot;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">属性</SPAN><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>/</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">值对。</SPAN></CODE></P> +<P><SPAN lang=EN-US>Because this page&#39;s content should only contain a list of
+definitions, it should not have a
+<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</a>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +由于该页的内容只能包含一系列定义,因此该页没有<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索 引</a></SPAN></P>
+<P><SPAN lang=EN-US>A Definitions page
+<A
+href="#definitions-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</A> is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个定义页<a href="#definitions-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN></P>
+<H3><A name=rationale-page0></A><SPAN lang=EN-US>Rationale </SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+原理</SPAN></H3>
+<P><SPAN lang=EN-US>The Rationale page is used to provide lengthy descriptions +of the rationale behind the library&#39;s design. This information helps users to
+understand why a library was designed the way it was and may reduce the
+frequency of a number of frequently asked questions. For a better description of
+why rationale is important see the
+<a href="http://www.boost.org/more/lib_guide.htm#Rationale"; style="color: blue; text-decoration: underline; text-underline: single">
+Rationale rationale</a>
+in the general submission guidelines.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +原理页用来提供隐藏在库设计背后的很长的原理描述。这个信息能够帮助用户理解为 什么库是这样设计的,也可以缩减一些常见问题的提问频率。更好原理重要性作用的描 述参见一般提交指南中的<a href="http://www.boost.org/more/lib_guide.htm#Rationale"; style="color: blue; text-decoration: underline; text-underline: single">原理说明</a>。 </SPAN></P> +<P><SPAN lang=EN-US>Like most content pages, the Rationale page should include a +<A href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</A>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+和大部分内容页一样,原理<SPAN
+class=GramE>页应当</SPAN>包含一个<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索引</a>。</SPAN></P>
+<P><SPAN lang=EN-US>A Rationale page
+<A href="#rationale-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</A>
+is provided for use. </SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个原理页<a href="#rationale-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN></P>
+<P><SPAN lang=EN-US><o:p>&nbsp;</o:p></SPAN></P>
+<H3><A id=configuration-page0 name=configuration-page0></A><SPAN
+lang=EN-US>Configuration Information</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+配置信息</SPAN></H3>
+<P><SPAN lang=EN-US>The Configuration Information page is used to document
+configuration macros used by the library. Such macros belong in one of three +groups: macros used by library <SPAN class=SpellE>implenters</SPAN> defined in +</SPAN><CODE style="font-family: Courier New"><SPAN style="FONT-SIZE: 10pt" lang=EN-US>
+&lt;boost/<SPAN
+class=SpellE>config.hpp</SPAN>&gt;</SPAN></CODE><SPAN lang=EN-US>, macros used by +library users to detect platform configuration information and macros defined by
+library users to configure library behavior.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+配置信息页面用于对<SPAN
+class=GramE>库使用</SPAN>的配置<SPAN class=GramE>宏进行</SPAN>文档化。这些 宏可以分为</SPAN><SPAN
+lang=EN-US>3</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">组:定义在</SPAN><SPAN
+lang=EN-US>&lt;boost/<SPAN class=SpellE>config.hpp</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">中的<SPAN +class=GramE>库实现</SPAN>者使用的宏,<SPAN class=GramE>库用户</SPAN>检测平 台配置信息使用的宏和<SPAN +class=GramE>库用户</SPAN>定义的配置<SPAN class=GramE>库行为</SPAN>的宏。 </SPAN></P>
+<P><SPAN lang=EN-US>Like most content pages, the Configuration page should
+include a
+<A href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</A>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +和大部分内容页一样,配置信息页面应当包含一个<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索 引</a>。</SPAN></P>
+<P><SPAN lang=EN-US>A Configuration page
+<A
+href="#configuration-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</A> is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个配置页面<a href="#configuration-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=faq-page0 name=faq-page0></A><SPAN lang=EN-US>Frequently Asked
+Questions
+</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+常见问题</SPAN></H3>
+<P><SPAN lang=EN-US>As a library matures the users will have questions about the
+usage of the library. Often users will ask the same questions over and over
+again. Rather than having to deal with answering the question every time it&#39;s
+asked, a Frequently Asked Questions (commonly known as <SPAN
+class=SpellE>FAQs</SPAN>) page can be used to document the questions and
+answers. This is such a valuable piece of documentation not only for the users +but for the maintainers as well, that a FAQ page should be provided from the +outset. If there are no questions that will obviously become a FAQ, the initial +page may just indicate that there are no <SPAN class=SpellE>FAQs</SPAN> yet. +This empty place holder helps to indicate to the users that you plan to address
+any <SPAN class=SpellE>FAQs</SPAN> as they occur.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+作为一个成熟的库,用户经常会提出关于<SPAN
+class=GramE>库使用</SPAN>的问题。通常用户会重复问同一个问题很多遍。与每次都 回答提问的问题相反,建立一个常见问题列表</SPAN><SPAN
+lang=EN-US>(</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">常称为</SPAN><SPAN +class=SpellE><SPAN lang=EN-US>FAQs</SPAN></SPAN><SPAN lang=EN-US>)</SPAN><SPAN +style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">页面对常见问答进行文档化。这是一个 非常有价值的文档,对用户和维护者都很重要,并且</SPAN><SPAN
+lang=EN-US>FAQ</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">页面从一开始就应当被提供。如果没有 问题成为明显的常见问题,初始页面应当声明还没有常见问题。这个空占位有助于向用 户表明您计划来解决任何出现的常见问题。</SPAN></P>
+<P><SPAN lang=EN-US>The
+<A href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</A> for the FAQ page should contain a list of all the questions
+contained in the document. The actual question entries should be formatted with +the question in a heading tag and the answers in standard paragraph format. This
+provides a clean presentation that&#39;s easy to read.</SPAN></P>
+<P><SPAN lang=EN-US>FAQ</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">页面的<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索 引</a>应当包含文档中所有问题的列表。实际的问题项应当被格式化为问题使用标题标 签,答案使用标准的段落格式。这将提供一个清晰的易于阅读的表示。</SPAN></P>
+<P><SPAN lang=EN-US>A Frequently Asked Questions page
+<a href="#faq-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</a> is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个常见问题页面<a href="#faq-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=bibliography-page0 name=bibliography-page0></A><SPAN
+lang=EN-US>Bibliography </SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+参考文献</SPAN></H3>
+<P><SPAN lang=EN-US>The Bibliography page is used to document any
+bibliographical information associated with references made within the
+documentation to external resources. Parenthetical references are used within
+the documentation which link to entries in the Bibliography page.
+Bibliographical entries provide detailed information about the external resource +and may contain hyper links to the resource if it&#39;s available online. There are +several formal styles used for writing bibliographies. You may use what ever +style you want, but one of the better styles to consider using can be referenced
+<A
+href="http://www.columbia.edu/cu/cup/cgos/idx_basic.html"; style="color: blue; text-decoration: underline; text-underline: single">
+here</A>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +参考文献页面用于对文档引用的任何外部参考文献信息文档化。文档中使用的括号引 用链接到参考文献页的条目。参考文献条目提供了外部资源的详细信息,如果资源是可 以在线使用的,可能还包含相应的超链接。有一些正式的格式用于书写参考文献。你可 以使用任何你想用的格式,但是一个可以考虑的更好的格式可以参考<A +href="http://www.columbia.edu/cu/cup/cgos/idx_basic.html"; style="color: blue; text-decoration: underline; text-underline: single">这里</A>。 </SPAN></P>
+<P><SPAN lang=EN-US>Since the Bibliography page should contain only
+bibliographical information there is no need for a
+<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</a>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +因为参考文献页面仅包含书目信息,因此没有必要包含<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索 引</a>。</SPAN></P>
+<P><SPAN lang=EN-US>A Bibliography page
+<a href="#bibliography-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</a> is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个参考文献页面<a href="#bibliography-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN></P>
+<H3><A name=acknowledgements-page0></A><SPAN
+lang=EN-US>Acknowledgment</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+致谢</SPAN></H3>
+<P><SPAN lang=EN-US>The Acknowledgment page is used to give credit where credit +is due. When individuals provide input on the design or implementation, or when +you make use of someone else&#39;s work, you should acknowledge them. This is a +courtesy that you&#39;d expect others to extend to you, so you should strive to +acknowledge the efforts of everyone else in your own documentation.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +致谢页面用于感谢做过贡献的人。当别人提供了设计或实现,或者你使用了其它人的 工作,你应当致谢这些人。当你借鉴了别人的工作时,这是一种礼貌,因此你应该在你 的文档里感谢每个人付出的努力。</SPAN></P> +<P><SPAN lang=EN-US>Since the Acknowledgment page should contain only a list of
+acknowledgment there is no need for a
+<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</a>.</SPAN></P>
+<P><SPAN lang=EN-US>由于致谢页仅包含一系列致谢,因此没有必要包含<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页索引</a>。</SPAN></P>
+<P><SPAN lang=EN-US>An Acknowledgments page
+<a href="#acknowledgements-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</a> is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个致谢页面<a href="#acknowledgements-page" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN></P>
+<H3><A name=header-page0></A><SPAN lang=EN-US>Header Reference</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+头文件参考</SPAN></H3>
+<P><SPAN lang=EN-US>The Header Reference pages are the most important pages in +your documentation. They document all library headers, including all the macros, +values, types, classes, functions and objects defined in them. In general it may
+prove useful to follow the guidelines in
+<a href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single"> +Documentation Structure</a> when writing the content for these pages.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +头文件参考页面是文档中最重要的页面。它们文档化所有库的头文件,包括所有 宏,值,类型,类,函数和定义在其中的对象。一般来说,当为这些页面编写内容 时,遵守<a href="../../../&#26032;&#24314;&#25991;&#20214;&#22841;/&#26032;&#24314;&#25991;&#20214;&#22841;/boost_doc/more/writingdoc/structure.html" style="color: blue; text-decoration: underline; text-underline: single">文档 结构</a>里的原则被证明是有用的。</SPAN></P> +<P><SPAN lang=EN-US>Like most content pages, the Header Reference pages should
+include a
+<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">
+Page Index</a>.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +像大多数内容页一样,头文件参考页面应当包含一个<a href="#page-index" style="color: blue; text-decoration: underline; text-underline: single">页面 索引</a>。</SPAN></P>
+<P><SPAN lang=EN-US>A Header Reference page
+<a href="#header-template" style="color: blue; text-decoration: underline; text-underline: single">
+template</a>
+is provided for use.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +这里提供一个头文件参考页面<a href="#header-template" style="color: blue; text-decoration: underline; text-underline: single">模板</a>供使用。 </SPAN></P>
+<H2><A name=layout0></A><SPAN lang=EN-US>Layout </SPAN></H2>
+<H2><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+布局</SPAN></H2>
+<P><SPAN lang=EN-US>There are certain page layout concepts that will be used +frequently in many of your pages. This section outlines some general guidelines
+that you can follow when designing each of these layout concepts for your
+documentation.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +有一些页面布局概念将频繁用在很多页面中。当为你的文档设计这些布局概念时,本 节列出一般性的可以遵守的指导原则。</SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=page-banner0 name=page-banner0></A><SPAN lang=EN-US>Page Banner
+</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+页标题</SPAN></H3>
+<P><SPAN lang=EN-US>The Page Banner is located at the very top of a page and
+provides quick information about the page contents. This includes the Boost
+logo, which indicates to the reader that this page is part of the Boost web
+site, a title for the documentation (generally the library name) and the page +title. The Boost logo should hyper link to the Boost home page on the index page
+and to the index page on all other pages. This allows the user to easily
+navigate through the Boost web site and through the documentation. The &lt;title&gt; +tag for the HTML page should consist of the documentation title and the page
+title separated by a hyphen.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+页标题位于页面的最上方,提供页面内容最快速的信息。这包括</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的</SPAN><SPAN
+lang=EN-US>logo</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">,这表明该页是</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">网站的一部分,以及文档的标题 </SPAN><SPAN
+lang=EN-US>(</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">一般是库的名字</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和页标题。</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的</SPAN><SPAN
+lang=EN-US>logo</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">应当超链接到</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的索引页主页上和所有其它页面的索引 页上。这允许用户很方便地在</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">网站和文档中导航。</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">的</SPAN><SPAN
+lang=EN-US>&lt;title&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签应当包含文档标题和以连字符分割 的页标题。</SPAN></P> +<P><SPAN lang=EN-US>The Page Banner should be separated from the rest of the +page by the use of an &lt;hr&gt; tag. This helps to clearly separate the actual
+content from the title information and produces cleaner text.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+页标题应当使用</SPAN><SPAN
+lang=EN-US>&lt;hr&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标记和页面的其它部分分开。这将帮助 清晰地从标题信息分割实际内容并能够产生清晰的文本。</SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=page-index0 name=page-index0></A><SPAN lang=EN-US>Page Index</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+页索引</SPAN></H3>
+<P><SPAN lang=EN-US>The page index is used to quickly navigate to the various +sections of the documentation on the page, and when present should be located
+just below the Page Banner.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +页索引用于快速导航到页面上文档的各个部分,它应该位于页标题的下方。 </SPAN></P> +<P><SPAN lang=EN-US>The index list should generally be constructed using an HTML +&quot;definition list&quot; (&lt;dl&gt; and &lt;DT&gt; tags). A definition list has no bullets or
+ordered specifications and produces a cleaner layout then an unordered list
+(&lt;UL&gt; and &lt;<SPAN class=SpellE>li</SPAN>&gt; tags) or an ordered list (&lt;<SPAN class=SpellE>ol</SPAN>&gt;
+and &lt;<SPAN
+class=SpellE>li</SPAN>&gt; tags). If you choose to use the Boost Style Sheet you +should add a </SPAN><CODE style="font-family: Courier New"><SPAN style="FONT-SIZE: 10pt" +lang=EN-US>class=&quot;page-index&quot;</SPAN></CODE><SPAN lang=EN-US> attribute/value
+pair to the &lt;dl&gt; tag.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+索引列表一般应该使用一个</SPAN><SPAN
+lang=EN-US>HTML</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">“定义列表”</SPAN><SPAN
+lang=EN-US>(&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;DT&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">构建。一个定义列表没有制定项目符号 或规格,它产生一个清晰的布局如无序列表</SPAN><SPAN
+lang=EN-US>(&lt;UL&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">或有序列表</SPAN><SPAN
+lang=EN-US>(&lt;<SPAN class=SpellE>ol</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">和</SPAN><SPAN
+lang=EN-US>&lt;<SPAN class=SpellE>li</SPAN>&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签</SPAN><SPAN
+lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">。如果你选择使用普通的</SPAN><SPAN
+lang=EN-US>Boost</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">风格表单,你应当在</SPAN><SPAN
+lang=EN-US>&lt;dl&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签中加一个</SPAN><CODE style="font-family: Courier New"><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>class=&quot;page-index&quot;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">属性</SPAN><SPAN
+style="FONT-SIZE: 10pt" lang=EN-US>/</SPAN><SPAN
+style="FONT-FAMILY: SimSun; FONT-SIZE: 10pt; mso-ascii-font-family: 'Courier New'; mso-hansi-font-family: 'Courier New'">值对。</SPAN></CODE></P>
+<P><SPAN lang=EN-US>Most pages should include a Page Index.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+大部分页面应当包含一个页面索引。</SPAN><SPAN
+lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=content0 name=content0></A><SPAN lang=EN-US>Documentation Content</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+文档内容</SPAN></H3>
+<P><SPAN lang=EN-US>The page&#39;s actual documentation content will be formatted +according to the specific needs of individual pages, and should be placed right +after the Page Index if present, or after the Page Banner if not. In general the +documentation content will take the form of paragraph text contained underneath
+section headings.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +该页的实际文档内容根据页面的实际需要进行格式化,如果包含页索引,应当紧挨着 页索引,否则紧挨着页标题。一般来说文档内容将以含有区域标题的文本<SPAN +class=GramE>段形式</SPAN>存在。</SPAN><SPAN lang=EN-US><o:p></o:p></SPAN></P>
+<H3><A id=doc-footnotes0 name=doc-footnotes0></A><SPAN lang=EN-US>Footnotes
+</SPAN></H3>
+<H3><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">
+注记</SPAN></H3>
+<P><SPAN lang=EN-US>Footnotes may be used within a page&#39;s documentation. Within
+the documentation content a footnote reference should take the form of a
+footnote number in parentheses (the parentheses make it easier for the reader to +click on the hyper link) hyper linking to the actual footnote at the bottom of +the page&#39;s documentation content. You may either use the &lt;sup&gt; tag to format +such footnote numbers, or, preferably, you can use a CSS style class in order to +distinguish the number as a footnote instead of as part of the actual text. If
+you choose to use the common
+<a href="#boost-style-sheet" style="color: blue; text-decoration: underline; text-underline: single"> +Boost Style Sheet</a>, a </SPAN><CODE style="font-family: Courier New"><SPAN style="FONT-SIZE: 10pt" +lang=EN-US>footnote</SPAN></CODE><SPAN lang=EN-US> class is defined for this
+purpose.</SPAN></P>
+<P><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'"> +注记可能在一个页面文档内使用。在文档内容里,一个注记参考应当采取带括号的注 记表示</SPAN><SPAN
+lang=EN-US>(</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">括号能够让读者更容易<SPAN
+class=GramE>点击超链接</SPAN></SPAN><SPAN lang=EN-US>)</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">链接至在页面文档内容底部的实际的注 记。你或者使用</SPAN><SPAN
+lang=EN-US>&lt;sup&gt;</SPAN><SPAN
+style="FONT-FAMILY: SimSun; mso-ascii-font-family: 'Times New Roman'; mso-hansi-font-family: 'Times New Roman'">标签去格式化这些注记号,更好的方法 是使用</SPAN><SPAN
+lang=EN-US>CSS</SPAN><SPAN
***The diff for this file has been truncated for email.***

Other related posts:

  • » [boost-doc-zh] r342 committed - [No log message] - boost-doc-zh