Merge pull request #61 from lyhabc/patch-20

校对test-parser.sgml文件

Author: ChenHuajun

postgresql/doc/src/sgml/test-parser.sgml

@@ -7,9 +7,43 @@
   <primary>test_parser</primary>
  </indexterm>
 
+ <!--
+ <para>
+  <filename>test_parser</> is an example of a custom parser for full-text
+  search.  It doesn't do anything especially useful, but can serve as
+  a starting point for developing your own parser.
+ </para>
+-->
+
+<para>
+   <filename>dblink</>是一个在数据库会话中支持连接其他<productname>PostgreSQL</>
+   数据库的模块。
+</para>
+
+
  <para>
   <filename>test_parser</> 是一个自定义的全文搜索解析器的例子。它不做特别有用的工作，但是可以作为开发一个自己的解析器的起点。
  </para>
+ 
+  <!--
+  <para>
+  <filename>test_parser</> recognizes words separated by white space,
+  and returns just two token types:
+
+<programlisting>
+mydb=# SELECT * FROM ts_token_type('testparser');
+ tokid | alias |  description
+-------+-------+---------------
+     3 | word  | Word
+    12 | blank | Space symbols
+(2 rows)
+</programlisting>
+
+  These token numbers have been chosen to be compatible with the default
+  parser's numbering.  This allows us to use its <function>headline()</>
+  function, thus keeping the example simple.
+ </para>
+ -->
 
  <para>
   <filename>test_parser</> 识别以空格分隔的单词，并且返回两种令牌类型：
@@ -23,17 +57,49 @@ mydb=# SELECT * FROM ts_token_type('testparser');
 (2 rows)
 </programlisting>
 
-这些令牌数字被选择来兼容默认的解析器编号。这允许我们可以使用<function>headline()</>函数，从而保持例子的简单。  
+这些令牌数字被选择来兼容默认的解析器编号。这让我们可以使用<function>headline()</>函数，从而保持例子的简单。  
  </para>
 
+  <!--
+  <title>Usage</title>
+   -->
+  
  <sect2>
   <title>用法</title>
 
+  <!--
+  <para>
+   Installing the <literal>test_parser</> extension creates a text search
+   parser <literal>testparser</>.  It has no user-configurable parameters.
+  </para>
+     -->
+  
   <para>
-安装<literal>test_parser</>扩展，创建一个文本搜索的解析器testparser。它没有用户可配置参数。
+安装<literal>test_parser</>扩展，创建一个文本搜索解析器testparser。它没有用户可配置参数。
 
   </para>
 
+ <!--
+  <para>
+   You can test the parser with, for example,
+
+<programlisting>
+mydb=# SELECT * FROM ts_parse('testparser', 'That''s my first own parser');
+ tokid | token
+-------+--------
+     3 | That's
+    12 |
+     3 | my
+    12 |
+     3 | first
+    12 |
+     3 | own
+    12 |
+     3 | parser
+</programlisting>
+  </para>
+       -->
+  
   <para>
 你可以像下面的例子这样测试该解析器，
 
@@ -53,6 +119,35 @@ mydb=# SELECT * FROM ts_parse('testparser', 'That''s my first own parser');
      3 | parser
 </programlisting>
   </para>
+  
+   <!--
+   <para>
+   Real-world use requires setting up a text search configuration
+   that uses the parser.  For example,
+
+<programlisting>
+mydb=# CREATE TEXT SEARCH CONFIGURATION testcfg ( PARSER = testparser );
+CREATE TEXT SEARCH CONFIGURATION
+
+mydb=# ALTER TEXT SEARCH CONFIGURATION testcfg
+mydb-#   ADD MAPPING FOR word WITH english_stem;
+ALTER TEXT SEARCH CONFIGURATION
+
+mydb=#  SELECT to_tsvector('testcfg', 'That''s my first own parser');
+          to_tsvector
+-------------------------------
+ 'that':1 'first':3 'parser':5
+(1 row)
+
+mydb=# SELECT ts_headline('testcfg', 'Supernovae stars are the brightest phenomena in galaxies',
+mydb(#                    to_tsquery('testcfg', 'star'));
+                           ts_headline
+-----------------------------------------------------------------
+ Supernovae &lt;b&gt;stars&lt;/b&gt; are the brightest phenomena in galaxies
+(1 row)
+</programlisting>
+  </para>
+         -->
 
   <para>
 实际使用需要配置一个文本搜索配置项来使用这个解析器。例如，