cvs: php-gtk-doc /manual/zh_cn/tutorials gtk_pango_co.xml hello_world.xml helloadvanced.xml installation.xml translation.xml
[email protected] ("Fernando Correa da Concei??o") Thu, 04 Jan 2007 02:42:45 -0000
| Newsgroups | php.gtk.doc |
|---|---|
| Message-ID | <cvsfernandoc1167878565@cvsserver> |
fernandoc Thu Jan 4 02:42:45 2007 UTC
Modified files:
/php-gtk-doc/manual/zh_cn/tutorials gtk_pango_co.xml
hello_world.xml
helloadvanced.xml
installation.xml
translation.xml
Log:
Added revcheck and some other changes, by mikespook
fernandoc-20070104024245.txt
(text/plain, 64.1 KB)
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml
diff -u php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml:1.1 php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml:1.2
--- php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml:1.1 Fri Dec 8 15:19:59 2006
+++ php-gtk-doc/manual/zh_cn/tutorials/gtk_pango_co.xml Thu Jan 4 02:42:45 2007
@@ -1,57 +1,68 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.1 $ -->
-<chapter id="tutorials.gtkpangoco">
- <title>GTK, Pango & Friends</title>
-
- <sect1>
- <simpara>
- 当编写 PHP-GTK 程序以及浏览手册时，你会发现一些非常模糊的缩写。关于其中更加重要的一个在这里有一个概况。
- </simpara>
-
- <sect2>
- <title>PHP</title>
- <simpara>
- PHP - PHP: Hypertext Processor - 是使用广泛的多用途脚本语言，被设计用于 Web 开发，并可嵌入 HTML 中。
- </simpara>
- </sect2>
-
- <sect2>
- <title>GTK</title>
- <simpara>
- GTK - the GIMP Tool Kit - 是设计用于创建图形用户界面的库。它运行于多数类 UNIX 平台，Windows，以及支持 framebuffer 的设备。
- </simpara>
- <simpara>
- GTK 库本身包含元件，也就是 GUI 组件，如 <classname>GtkButton</classname> 或者 <classname>GtkTextView</classname>。
- </simpara>
- <simpara>
- GTK 依赖若干其他库的支持，如 GDK，Pango，ATK 和 GLib。并全部整合打包于 GTK+ 中。
- </simpara>
- </sect2>
-
- <sect2>
- <title>GDK</title>
- <simpara>
- GDK - the GIMP Drawing Kit - 是允许 GTK+ 支持多窗口系统的抽象层。GDK 可在 X11，Windows，和 Linux framebuffer 设备上提供绘制和窗口系统工具。
- </simpara>
- </sect2>
-
- <sect2>
- <title>Pango</title>
- <simpara>
- Pango 是国际化文本处理库。它围绕使用段落表达文本的 <classname>PangoLayout</classname> 对象。Pango 为
-<classname>GtkTextView</classname>，<classname>GtkLabel</classname>，<classname>GtkEntry</classname>，以及其他 需要显示文本的 GTK+ 元件提供文本处理引擎。
- </simpara>
- </sect2>
-
- <sect2>
- <title>ATK</title>
- <simpara>
- ATK 是 Accessibility Tool Kit。它提供一系列的接口使得同图形用户界面交互在易用性上得到支持。例如，屏幕阅读器可以使用 ATK 获取屏幕上的文字并给盲人用户阅读。
- </simpara>
- <simpara>
- 感谢 ATK 框架，GTK+ 元件可以获得内建的易用性支持。
- </simpara>
- </sect2>
-
- </sect1>
-</chapter>
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- EN-Revision: 1.4 Maintainer: mikespook Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<chapter id="tutorials.gtkpangoco">
+ <title>GTK，Pango 和支持库</title>
+
+ <sect1>
+ <simpara>
+ 当编写 PHP-GTK 程序以及浏览手册时，你会发现一些非常模糊的缩写。
+ 关于其中更加重要的一个在这里有一个概况。
+ </simpara>
+
+ <sect2>
+ <title>PHP</title>
+ <simpara>
+ PHP - PHP: Hypertext Processor - 是使用广泛的多用途脚本语言，
+ 被设计用于 Web 开发，并可嵌入 HTML 中。
+ </simpara>
+ </sect2>
+
+ <sect2>
+ <title>GTK</title>
+ <simpara>
+ GTK - the GIMP Tool Kit - 是设计用于创建图形用户界面的库。
+ 它运行于多数类 UNIX 平台，Windows，以及支持 framebuffer 的设备。
+ </simpara>
+ <simpara>
+ GTK 库本身包含元件，也就是 GUI 组件，如 <classname>GtkButton</classname>
+ 或者 <classname>GtkTextView</classname>。
+ </simpara>
+ <simpara>
+ GTK 依赖若干其他库的支持，如 GDK，Pango，ATK 和 GLib。
+ 并全部整合打包于 GTK+ 中。
+ </simpara>
+ </sect2>
+
+ <sect2>
+ <title>GDK</title>
+ <simpara>
+ GDK - the GIMP Drawing Kit - 是允许 GTK+ 支持多窗口系统的抽象层。
+ GDK 可在 X11，Windows，和 Linux framebuffer 设备上提供绘制和窗口系统工具。
+ </simpara>
+ </sect2>
+
+ <sect2>
+ <title>Pango</title>
+ <simpara>
+ Pango 是国际化文本处理库。它围绕使用段落表达文本的
+ <classname>PangoLayout</classname> 对象。Pango 为
+ <classname>GtkTextView</classname>，<classname>GtkLabel</classname>，
+ <classname>GtkEntry</classname>，以及其他 需要显示文本的 GTK+ 元件
+ 提供文本处理引擎。
+ </simpara>
+ </sect2>
+
+ <sect2>
+ <title>ATK</title>
+ <simpara>
+ ATK 是 Accessibility Tool Kit。它提供一系列的接口来支持图形用户界面交互
+ 的易用性。例如，屏幕阅读器可以使用 ATK 获取屏幕上的文字并给盲人用户阅读。
+ </simpara>
+ <simpara>
+ 感谢 ATK 框架，使得 GTK+ 元件可以获得内建的易用性支持。
+ </simpara>
+ </sect2>
+
+ </sect1>
+</chapter>
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml
diff -u php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml:1.1 php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml:1.2
--- php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml:1.1 Fri Dec 8 15:19:59 2006
+++ php-gtk-doc/manual/zh_cn/tutorials/hello_world.xml Thu Jan 4 02:42:45 2007
@@ -1,124 +1,159 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.1 $ -->
-<chapter id="tutorials.helloworld">
- <title>Hello World（基础）</title>
-
- <simpara>
- 当你开始学习一门编程语言，通常你的第一个程序都是编写“hello world”。所以，为了符合这个通常的习惯，本手册中的第一个指南也就从“hello world”指南开始！
- </simpara>
- <simpara>
- 我们希望在通篇指南中紧扣 PHP 本身。指南被设计为提供用户如何使用 PHP-GTK，以及这其中的思想和技术。
- </simpara>
- <simpara>
- 在这个指南中我们将创建一个简单的窗口，并有“Hello World!”的文本在上面。
- </simpara>
- <simpara>
- 我们将从列出的程序开始，然后将逐行解释，提供一个非常基本的 PHP-GTK 应用的概况。
- </simpara>
-
-
- <example>
- <title>简单的 Hello World 脚本</title>
- <programlisting role="php">
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
- href="&directory.examples;/tutorials/helloworld/helloworld.phpw" parse="text">
- <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
- </xi:include>
- </programlisting>
- </example>
-
- <para>
- 复制代码到文本编辑器中并保存为 <filename>hello.phpw</filename>。然后开启一个控制台使用命令 <command>php hello.phpw</command>。一个标题为“Hello world”的窗口应当显示出来，除了文本“Just wanted to say 'Hello world!'”上面没有任何内容。
- </para>
-
-
- <example>
- <title>检查 PHP-GTK 是否可用</title>
- <programlisting role="php"><![CDATA[if (!class_exists('gtk')) {
- die("Please load the php-gtk2 module in your php.ini\r\n");
-}]]></programlisting>
- </example>
-
- <para>
- 这里通过检查类 <literal>gtk</literal> 是否存在来确定 PHP-GTK 是否可用。不像 PHP 4 和 PHP-GTK 1，你不应当尝试使用 <ulink url="http://www.php.net/dl">dl()</ulink> 加载 PHP-GTK 模块。在 PHP 5 中不赞成这么做，并且不应当在新的代码中使用。所以我们能做的就是输出一个消息，告诉用户模块不可用并且需要进一步设置可用。
- </para>
-
-
- <example>
- <title>创建窗口</title>
- <programlisting role="php"><![CDATA[$wnd = new GtkWindow();]]></programlisting>
- </example>
-
- <para>
- 创建新 <link linkend="gtk.gtkwindow">窗口</link> 元件对象就像创建新对象一样简单：变量 <literal>$wnd</literal> 被赋值新的对象。如果你已经使用 PHP 4 和 PHP-GTK 1 编写过程序，你会发现你漏写了 <literal>&</literal> 在 <literal>new</literal> 之前。这个在 PHP 4 中是必须的，但是在 PHP 5 中由于引用创建，所以不再需要了。
- </para>
-
-
- <example>
- <title>设置窗口标题</title>
- <programlisting role="php"><![CDATA[$wnd->set_title('Hello world');]]></programlisting>
- </example>
-
- <simpara>
- 为了让窗口在任务栏中便于识别，我们设置窗口标题：仅仅是调用了对象的方法。
- </simpara>
-
-
- <example>
- <title>设置退出清理</title>
- <programlisting role="php"><![CDATA[$wnd->connect_simple('destroy', array('gtk', 'main_quit'));]]></programlisting>
- </example>
-
- <para>
- 这是代码中第一处有趣的部分：<signalname class="GtkObject">destroy</signalname> 信号连接到静态方法 <link linkend="gtk.method.main_quit">Gtk::main_quit</link>。它简单的告诉 GTK 当窗口关闭或销毁时退出主循环。（关于主循环将在下面的部分解释）
- </para>
-
-
- <example>
- <title>创建一个用于显示文本的标签</title>
- <programlisting role="php"><![CDATA[$lblHello = new GtkLabel("Just wanted to say\r\n'Hello world!'");]]></programlisting>
- </example>
-
- <para>
- 像之前一样，我们创建了一个新的元件。这次我们希望显示一小段文字，而 <classname>GtkLabel</classname> 非常适合这个任务。
- </para>
-
-
- <example>
- <title>在窗口上添加标签</title>
- <programlisting role="php"><![CDATA[$wnd->add($lblHello);]]></programlisting>
- </example>
-
- <simpara>
- 现在我们告诉窗口，标签将会添加在上面。
- </simpara>
-
-
- <example>
- <title>显示窗口</title>
- <programlisting role="php"><![CDATA[$wnd->show_all();]]></programlisting>
- </example>
-
- <para>
- 到现在为止，你的屏幕上还什么都没有。为了显示窗口，你需要调用 <function class="GtkWidget">show</function>。这可以显示窗口，但不包含标签——我们不得不对标签也调用 <function class="GtkWidget">show</function>。如果你在窗口上有多个元件如按钮、选择框或者其他这是很不方便的：<function class="GtkWidget">show_all</function> 会帮助显示窗口以及所有的子元件。
- </para>
-
-
- <example>
- <title>开始主循环</title>
- <programlisting role="php"><![CDATA[Gtk::main();]]></programlisting>
- </example>
-
- <para>
- 在所有都设置好了以后，我们需要确保窗口保持开启并相应用户交互。一个普通的 PHP 脚本会中指并退出，但是我们希望它继续执行：为了这个目的，GTK 主循环被调用。用于程序保持运行并等待用户事件。如果事件发生，它将其委派到相应的回调函数中去。
- </para>
-
-
- <sect1 id="tutorials.helloworld.futherreading">
- <title>进一步阅读</title>
- <para>
- 现在你已经创建了你的第一个 PHP-GTK 2 应用，你可能希望创建更加复杂的布局。阅读 <link linkend="tutorials.packing">包装指南</link> 了解基础的方法。
- </para>
- </sect1>
-
-</chapter>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- EN-Revision: 1.8 Maintainer: mikespook Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<chapter id="tutorials.helloworld">
+ <title>Hello World（基础）</title>
+
+ <simpara>
+ 当你开始学习一门编程语言，通常你的第一个程序都是编写“hello world”。
+ 所以，为了符合这个通常的习惯，本手册中的第一个指南也就从“hello world”
+ 指南开始！
+ </simpara>
+ <simpara>
+ 我们希望在通篇指南中紧扣 PHP 本身。指南被设计为提供用户如何使用 PHP-GTK，
+ 以及这其中的思想和技术。
+ </simpara>
+ <simpara>
+ 在这个指南中我们将创建一个简单的窗口，并有“Hello World!”的文本在上面。
+ </simpara>
+ <simpara>
+ 我们将从列出的程序开始逐行解释，这会提供一个基本的 PHP-GTK 应用的概况。
+ </simpara>
+
+
+ <example>
+ <title>简单的 Hello World 脚本</title>
+ <programlisting role="php">
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="&directory.examples;/tutorials/helloworld/helloworld.phpw" parse="text">
+ <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
+ </xi:include>
+ </programlisting>
+ </example>
+
+ <note>
+ <para>
+ 如果你得到一个错误
+ <literal>Fatal error: Call to undefined function: connect_simple()</literal>，
+ 那么你使用的是 PHP-Gtk 1 而不是 PHP-Gtk 2。那么这不是你需要阅读的手册。
+ </para>
+ </note>
+
+ <para>
+ 复制代码到文本编辑器中并保存为 <filename>hello.phpw</filename>。
+ 然后开启一个控制台使用命令 <command>php hello.phpw</command>。
+ 一个标题为“Hello world”的窗口应当显示出来，
+ 除了文本“Just wanted to say 'Hello world!'”上面没有任何内容。
+ </para>
+
+
+ <example>
+ <title>检查 PHP-GTK 是否可用</title>
+ <programlisting role="php"><![CDATA[if (!class_exists('gtk')) {
+ die("Please load the php-gtk2 module in your php.ini\r\n");
+}]]></programlisting>
+ </example>
+
+ <para>
+ 这里通过检查类 <literal>gtk</literal> 是否存在来确定 PHP-GTK 是否可用。
+ 不像 PHP 4 和 PHP-GTK 1，你不应当尝试使用
+ <ulink url="http://www.php.net/dl">dl()</ulink> 加载 PHP-GTK 模块。
+ 在 PHP 5 中不赞成这么做，并且不应当在新的代码中使用。
+ 所以我们能做的就是输出一个消息，告诉用户模块不可用并且需要进一步设置可用。
+ </para>
+
+
+ <example>
+ <title>创建窗口</title>
+ <programlisting role="php"><![CDATA[$wnd = new GtkWindow();]]></programlisting>
+ </example>
+
+ <para>
+ 创建新 <link linkend="gtk.gtkwindow">窗口</link> 元件对象就像创建新对象一样简单：
+ 赋值新的对象到变量 <literal>$wnd</literal>。如果你已经使用 PHP 4 和 PHP-GTK 1
+ 编写过程序，你会发现在 <literal>new</literal> 之前漏写了 <literal>&</literal>。
+ 这个在 PHP 4 中是必须的，但是在 PHP 5 中由于引用自动创建，所以不再需要了。
+ </para>
+
+
+ <example>
+ <title>设置窗口标题</title>
+ <programlisting role="php"><![CDATA[$wnd->set_title('Hello world');]]></programlisting>
+ </example>
+
+ <simpara>
+ 为了让窗口在任务栏中便于识别，我们设置窗口标题：仅仅是调用了对象的方法。
+ </simpara>
+
+
+ <example>
+ <title>设置退出清理</title>
+ <programlisting role="php"><![CDATA[$wnd->connect_simple('destroy', array('gtk', 'main_quit'));
+]]></programlisting>
+ </example>
+
+ <para>
+ 这是代码中第一处有趣的部分：<signalname class="GtkObject">destroy</signalname>
+ 信号连接到静态方法 <link linkend="gtk.method.main_quit">Gtk::main_quit</link>。
+ 它简单的告诉 GTK 当窗口关闭或销毁时退出主循环。（关于主循环将在下面的部分解释）
+ </para>
+
+
+ <example>
+ <title>创建一个用于显示文本的标签</title>
+ <programlisting role="php"><![CDATA[$lblHello = new GtkLabel("Just wanted to say\r\n'Hello world!'");
+]]></programlisting>
+ </example>
+
+ <para>
+ 像之前一样，我们创建了一个新的元件。这次我们希望显示一小段文字，而
+ <classname>GtkLabel</classname> 非常适合这个任务。
+ </para>
+
+
+ <example>
+ <title>在窗口上添加标签</title>
+ <programlisting role="php"><![CDATA[$wnd->add($lblHello);]]></programlisting>
+ </example>
+
+ <simpara>
+ 现在我们告诉窗口，标签将会添加在上面。
+ </simpara>
+
+
+ <example>
+ <title>显示窗口</title>
+ <programlisting role="php"><![CDATA[$wnd->show_all();]]></programlisting>
+ </example>
+
+ <para>
+ 到现在为止，你的屏幕上还什么都没有。为了显示窗口，你需要调用
+ <function class="GtkWidget">show</function>。这可以显示窗口，但不包含标签——
+ 我们不得不对标签也调用 <function class="GtkWidget">show</function>。
+ 如果你在窗口上有多个元件如按钮、选择框或者其他这是很不方便的：
+ <function class="GtkWidget">show_all</function> 会帮助显示窗口以及所有的子元件。
+ </para>
+
+
+ <example>
+ <title>开始主循环</title>
+ <programlisting role="php"><![CDATA[Gtk::main();]]></programlisting>
+ </example>
+
+ <para>
+ 在所有都设置好了以后，我们需要确保窗口保持开启并相应用户交互。
+ 一个普通的 PHP 脚本会中指并退出，但是我们希望它继续执行：为了这个目的，
+ GTK 主循环被调用。用于程序保持运行并等待用户事件。
+ 如果事件发生，它将其委派到相应的回调函数中去。
+ </para>
+
+
+ <sect1 id="tutorials.helloworld.futherreading">
+ <title>进一步阅读</title>
+ <para>
+ 现在你已经创建了你的第一个 PHP-GTK 2 应用，你可能希望创建更加复杂的布局。
+ 阅读 <link linkend="tutorials.packing">包装指南</link> 了解基础的方法。
+ </para>
+ </sect1>
+
+</chapter>
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml
diff -u php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml:1.1 php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml:1.2
--- php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml:1.1 Fri Dec 8 15:19:59 2006
+++ php-gtk-doc/manual/zh_cn/tutorials/helloadvanced.xml Thu Jan 4 02:42:45 2007
@@ -1,151 +1,177 @@
-<chapter id="tutorials.helloadvanced">
-<!-- $Revision: 1.1 $ -->
- <title>Hello World（高级）</title>
-
- <simpara>
- 这个指南比第一个 hello world 指南介绍了更加高级的功能。这里，我们创建一个用户可以输入用户名和密码的登录窗口。用户点击登录按钮时，检查文本框内容，当用户忘记他的用户名或密码时显示错误的消息。
- </simpara>
-
- <para>
- 这里有一个截屏，显示了程序完成以后的样子：
- <graphic fileref="&directory.images;/tutorials/helloadvanced.png"/>
- </para>
-
- <para>
- 首先，创建一个窗口，设置它的标题并且设置当窗口销毁时退出主循环——这些你应当已经在之前的指南中有所了解：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$wnd = new GtkWindow();
-$wnd->set_title('Login');
-$wnd->connect_simple('destroy', array('gtk', 'main_quit'));
-]]></programlisting>
- </informalexample>
- </para>
-
- <para>
- 下一个任务是创建对话框上需要的所有元件。首先，输入用户名和密码的两个文本框：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$txtUsername = new GtkEntry();
-$txtPassword = new GtkEntry();
-]]></programlisting>
- </informalexample>
- 我们希望用户明白哪个文本框输入用户名，哪个文本框输入密码，所以还需要标签用于描述：
- <informalexample>
- <programlisting role="php"><![CDATA[
-//The second parameter says that the underscore should be parsed as underline
-$lblUsername = new GtkLabel('_Username', true);
-$lblPassword = new GtkLabel('_Password', true);
-]]></programlisting>
- </informalexample>
- 最后，我们需要两个按钮：一个用来登录，另一个用来取消进程：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$btnLogin = new GtkButton('_Login');
-$btnCancel = new GtkButton('_Cancel');
-]]></programlisting>
- </informalexample>
- 你可能注意到 <classname>GtkLabel</classname> 传递的第二个参数，这表明下划线的作用是其后的字符显示下划线，而 <classname>GtkButton</classname> 的构造函数并没有这个参数：按钮的构造函数自动完成助记符的转换，而标签的并不是这样。这个行为可能对你来说有点奇怪，但是这非常类似你有一个助记符在按钮的标签上除此之外普通标签也有一个。（有问题的翻译：This behavior might be strange to you, but it's more likely that you have a mnemonic in a button's label than that a normal label has one.）
- </para>
-
- <para>
- 现在标签需要知道当助记符激活时哪个元件被激活。由下面的方法实现：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$lblUsername->set_mnemonic_widget($txtUsername);
-$lblPassword->set_mnemonic_widget($txtPassword);
-]]></programlisting>
- </informalexample>
- 更进一步，我们需要判断当按钮按下时调用哪个操作。取消按钮将会销毁窗口（这将中止应用程序）而登录按钮将检查文本框并调用进一步的操作：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$btnCancel->connect_simple('clicked', array($wnd, 'destroy'));
-$btnLogin ->connect_simple('clicked', 'login', $wnd, $txtUsername, $txtPassword);
-]]></programlisting>
- </informalexample>
- 我们向（还未经定义的）<literal>login</literal> 函数传递了作为可选参数的三个元件 <varname>$wnd</varname>，
- <varname>$txtUsername</varname> 和 <varname>$txtPassword</varname> ，因为我们需要：获取文本框的值，同时如果一切正常则销毁或隐藏窗口。
- </para>
-
- <para>
- 现在我们已经有了全部需要的元件，并添加到了窗口上。由于 <classname>GtkWindow</classname> 是二进制容器，它仅仅可容纳一个元件。所以我们需要一个可以容纳许多元件并可很好的对元件进行布局的容器。 <classname>GtkTable</classname> 是一个不错的选择，因为它可以保持标签在一列，同时文本框在下一列：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$tbl = new GtkTable(3, 2);
-$tbl->attach($lblCredit, 0, 2, 0, 1);
-$tbl->attach($lblUsername, 0, 1, 1, 2);
-$tbl->attach($txtUsername, 1, 2, 1, 2);
-$tbl->attach($lblPassword, 0, 1, 2, 3);
-$tbl->attach($txtPassword, 1, 2, 2, 3);
-]]></programlisting>
- </informalexample>
- (<varname>$lblCredit</varname> 是仅仅有一条信息的标签。).
- 按钮有它们自己的 <classname>GtkHButtonBox</classname>，因为这个类可以将许多按钮排列得非常好：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$bbox = new GtkHButtonBox();
-$bbox->set_layout(Gtk::BUTTONBOX_EDGE);
-$bbox->add($btnCancel);
-$bbox->add($btnLogin);
-]]></programlisting>
- </informalexample>
- </para>
-
- <para>
- 布局的最后工作是在窗口上添加 table 和 button box。这是无法直接完成的，因为 <classname>GtkWindow</classname> 继承于 <classname>GtkBin</classname> 而只能保持一个元件。所以我们需要另外的容器，这回使用 <classname>GtkVBox</classname>：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$vbox = new GtkVBox();
-$vbox->pack_start($tbl);
-$vbox->pack_start($bbox);
-]]></programlisting>
- </informalexample>
- 全部就这么多，我们可以显示窗口了：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$wnd->add($vbox);
-$wnd->show_all();
-Gtk::main();
-]]></programlisting>
- </informalexample>
- </para>
-
- <para>
- 最后还未完成的是 <literal>login</literal> 函数，当用户点击登录按钮时调用。它将检查用户名和密码的值：如果它们的长度是 0（用户没有输入任何内容），一个错误信息将会显示。如果一切正常，窗口将销毁同时程序继续执行并显示主窗口。
- </para>
-
- <para>
- 从元件获取文本是非常简单的，我们仅仅需要使用 <classname>GtkEntry</classname> 的 <function class="GtkEntry">get_text</function> 方法：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$strUsername = $txtUsername->get_text();
-$strPassword = $txtPassword->get_text();
-]]></programlisting>
- </informalexample>
- 使用普通的 php 函数 <literal>strlen</literal> 完成检查。如果出现错误，我们希望显示一个有一条消息的对话框。<classname>GtkMessageDialog</classname> 用于这个任务，它自动创建了图标和按钮（OK, Yes/No）：
- <informalexample>
- <programlisting role="php"><![CDATA[
-$dialog = new GtkMessageDialog($wnd, Gtk::DIALOG_MODAL, Gtk::MESSAGE_ERROR, Gtk::BUTTONS_OK, $errors);
-$dialog->set_markup("The following errors occured:\r\n<span foreground='red'>" . $errors . "</span>");
-$dialog->run();
-$dialog->destroy();
-]]></programlisting>
- </informalexample>
- </para>
-
- <para>
- 现在你只要确保已经将 login 函数放在了主循环的前面（！），那么运行它。
- </para>
-
- <example>
- <title>全部代码</title>
- <programlisting role="php">
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
- href="&directory.examples;/tutorials/helloadvanced/helloadvanced.phpw"
- parse="text">
- <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
- </xi:include>
- </programlisting>
- </example>
-
-</chapter>
\ No newline at end of file
+<chapter id="tutorials.helloadvanced">
+<!-- EN-Revision: 1.4 Maintainer: mikespook Status: ready -->
+<!-- $Revision: 1.2 $ -->
+ <title>Hello World（高级）</title>
+
+ <simpara>
+ 本指南比第一个 hello world 指南介绍了更加高级的功能。
+ 这里，我们创建一个用户可以输入用户名和密码的登录窗口。
+ 用户点击登录按钮时，检查文本框内容，当用户忘记他的用户名或密码时显示错误的消息。
+ </simpara>
+
+ <para>
+ 这里有一个截屏，显示了程序完成以后的样子：
+ <graphic fileref="&directory.images;/tutorials/helloadvanced.png"/>
+ </para>
+
+ <para>
+ 首先，创建一个窗口，设置它的标题并且设置当窗口销毁时退出主循环——
+ 这些你应当已经在之前的指南中有所了解：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$wnd = new GtkWindow();
+$wnd->set_title('Login');
+$wnd->connect_simple('destroy', array('gtk', 'main_quit'));
+]]></programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ 下一个任务是创建对话框上需要的所有元件。首先，输入用户名和密码的两个文本框：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$txtUsername = new GtkEntry();
+$txtPassword = new GtkEntry();
+]]></programlisting>
+ </informalexample>
+ 我们希望用户明白哪个文本框输入用户名，哪个文本框输入密码，所以还需要标签用于描述：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+//第二个参数表明下划线应当转化为助记符下划线
+$lblUsername = new GtkLabel('_Username', true);
+$lblPassword = new GtkLabel('_Password', true);
+]]></programlisting>
+ </informalexample>
+ 最后，我们需要两个按钮：一个用来登录，另一个用来取消进程：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$btnLogin = new GtkButton('_Login');
+$btnCancel = new GtkButton('_Cancel');
+]]></programlisting>
+ </informalexample>
+ 你可能注意到 <classname>GtkLabel</classname> 传递的第二个参数，
+ 这表明下划线的作用是其后的字符显示下划线，而 <classname>GtkButton</classname>
+ 的构造函数并没有这个参数：按钮的构造函数自动完成助记符的转换，
+ 而标签的并不是这样。这个行为可能对你来说有点奇怪，
+ 但是大概原因是按钮标签上的助记符比普通标签上的更加常用。
+ </para>
+
+ <para>
+ 现在标签需要知道当助记符激活时哪个元件被激活。由下面的方法实现：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$lblUsername->set_mnemonic_widget($txtUsername);
+$lblPassword->set_mnemonic_widget($txtPassword);
+]]></programlisting>
+ </informalexample>
+ 更进一步，我们需要判断当按钮按下时调用哪个操作。
+ 取消按钮将会销毁窗口（这将中止应用程序）
+ 而登录按钮将检查文本框并调用进一步的操作：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$btnCancel->connect_simple('clicked', array($wnd, 'destroy'));
+$btnLogin ->connect_simple('clicked', 'login', $wnd, $txtUsername, $txtPassword);
+]]></programlisting>
+ </informalexample>
+ 我们向（还未经定义的）<literal>login</literal> 函数传递了作为可选参数的三个元件
+ <varname>$wnd</varname>，<varname>$txtUsername</varname> 和
+ <varname>$txtPassword</varname>，因为我们需要：获取文本框的值，
+ 同时如果一切正常则销毁或隐藏窗口。
+ </para>
+
+ <para>
+ 现在我们已经有了全部需要的元件，并添加到了窗口上。由于
+ <classname>GtkWindow</classname> 是二进制容器，它仅仅可容纳一个元件。
+ 所以我们需要一个可以容纳许多元件并可很好的对元件进行布局的容器。
+ <classname>GtkTable</classname> 是一个不错的选择，因为它可以保持标签在一列，
+ 同时文本框在下一列：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$tbl = new GtkTable(3, 2);
+$tbl->attach($lblCredit, 0, 2, 0, 1);
+$tbl->attach($lblUsername, 0, 1, 1, 2);
+$tbl->attach($txtUsername, 1, 2, 1, 2);
+$tbl->attach($lblPassword, 0, 1, 2, 3);
+$tbl->attach($txtPassword, 1, 2, 2, 3);
+]]></programlisting>
+ </informalexample>
+ (<varname>$lblCredit</varname> 是仅仅有一条信息的标签。).
+ 按钮有它们自己的 <classname>GtkHButtonBox</classname>，
+ 因为这个类可以将许多按钮排列得非常好：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$bbox = new GtkHButtonBox();
+$bbox->set_layout(Gtk::BUTTONBOX_EDGE);
+$bbox->add($btnCancel);
+$bbox->add($btnLogin);
+]]></programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ 布局的最后工作是在窗口上添加 table 和 button box。这是无法直接完成的，
+ 因为 <classname>GtkWindow</classname> 继承于 <classname>GtkBin</classname>
+ 而只能保持一个元件。所以我们需要另外的容器，这回使用
+ <classname>GtkVBox</classname>：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$vbox = new GtkVBox();
+$vbox->pack_start($tbl);
+$vbox->pack_start($bbox);
+]]></programlisting>
+ </informalexample>
+ 全部就这么多，我们可以显示窗口了：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$wnd->add($vbox);
+$wnd->show_all();
+Gtk::main();
+]]></programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ 最后还未完成的是 <literal>login</literal> 函数，当用户点击登录按钮时调用。
+ 它将检查用户名和密码的值：如果它们的长度是 0（用户没有输入任何内容），
+ 一个错误信息将会显示。如果一切正常，窗口将销毁同时程序继续执行并显示主窗口。
+ </para>
+
+ <para>
+ 从元件获取文本是非常简单的，我们仅仅需要使用 <classname>GtkEntry</classname> 的
+ <function class="GtkEntry">get_text</function> 方法：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$strUsername = $txtUsername->get_text();
+$strPassword = $txtPassword->get_text();
+]]></programlisting>
+ </informalexample>
+ 使用普通的 php 函数 <literal>strlen</literal> 完成检查。
+ 如果出现错误，我们希望显示一个有一条消息的对话框。
+ <classname>GtkMessageDialog</classname> 用于这个任务，
+ 它自动创建了图标和按钮（OK, Yes/No）：
+ <informalexample>
+ <programlisting role="php"><![CDATA[
+$dialog = new GtkMessageDialog($wnd, Gtk::DIALOG_MODAL, Gtk::MESSAGE_ERROR, Gtk::BUTTONS_OK, $errors);
+$dialog->set_markup("The following errors occured:\r\n<span foreground='red'>" . $errors . "</span>");
+$dialog->run();
+$dialog->destroy();
+]]></programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ 现在你只要确保已经将 login 函数放在了主循环的“前面”，那么运行它。
+ </para>
+
+ <example>
+ <title>全部代码</title>
+ <programlisting role="php">
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="&directory.examples;/tutorials/helloadvanced/helloadvanced.phpw"
+ parse="text">
+ <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
+ </xi:include>
+ </programlisting>
+ </example>
+
+</chapter>
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/zh_cn/tutorials/installation.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/zh_cn/tutorials/installation.xml
diff -u php-gtk-doc/manual/zh_cn/tutorials/installation.xml:1.1 php-gtk-doc/manual/zh_cn/tutorials/installation.xml:1.2
--- php-gtk-doc/manual/zh_cn/tutorials/installation.xml:1.1 Fri Dec 8 15:19:59 2006
+++ php-gtk-doc/manual/zh_cn/tutorials/installation.xml Thu Jan 4 02:42:45 2007
@@ -1,208 +1,537 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.1 $ -->
-<chapter id="tutorials.installation">
- <title>安装 PHP-GTK 2</title>
-
- <sect1 id="tutorials.installation.introduction">
- <title>简介</title>
- <para>
- PHP-GTK 2 是 PHP 的扩展之一，并且只可用于 5.1 以及更高版本。虽然编译是最常用的安装 PHP-GTK 2 的方法，但是这一过程在 Windows 系统上也显得过于漫长。鉴于这样的原因，多数人将会选择使用官方发布的二进制 PHP-GTK 2 Alpha 版本或使用 Gnope 安装包。
- </para>
- <para>
- 我们将介绍三种主流系统上面的安装过程：Windows，Linux 和 Mac OS X。关于 Linux 的介绍同样也适用于符合 POSIX 标准的系统。
- </para>
- </sect1>
-
- <sect1 id="tutorials.installation.windows">
- <title>在 Windows 上安装</title>
-
- <sect2 id="tutorials.installation.windows.gnope">
- <title>使用 Gnope</title>
- <para>
- 使用 Gnope 在 Windows 上安装和维护 PHP-GTK 2 已经被证明几乎是最简单的方法。Gnope 是全功能的 PHP-GTK 2 安装包，包含 PHP 5.1、GTK 2.6 和 PEAR。简单的点几下鼠标你就可以安装完成！
- </para>
- <para>
- 只要从 <ulink url="&url.gnope;">gnope.org</ulink> 下载安装包，并跟随屏幕上的指引。Gnope 也拥有它自己的 PEAR 自动安装频道，那里你可以下载 PHP-GTK 2 程序添加到官方的 PEAR 包中。例如从 <ulink url="&url.pear.gtk2;">Gtk2 category</ulink>。
- </para>
- </sect2>
-
- <sect2 id="tutorials.installation.windows.manual">
- <title>手工安装</title>
- <para>
- 从 PHP-GTK 2 <ulink url="&url.phpgtk.download;">下载</ulink>页面下载 PHP-GTK 2 的针对 Windows 的 Alpha 版本二进制发行包。解压缩文件到指定目录。一个名为 <literal>php-gtk</literal> 的目录将会创建，并包含发行版的所有内容。
- </para>
- <para>
- 你需要 <filename>php.exe</filename>（CLI 版本）和 <filename>php5ts.dll</filename>，这两个都可从 PHP 5 的 Windows 发行版中获得，并且放置到 <filename>php-gtk</filename> 目录。如果你希望使用这个 <filename>php.exe</filename> 的其他扩展，请确保你已经存放二进制文件于此。
- </para>
- <para>
- <!-- FIXME: Do we need to do this? I doubt that this is necessary
- -cweiske -->
- 之后，你必须设置环境变量 <literal>PATH</literal> 包含发行包中的 <filename>gtk+2.6.9</filename> 目录。你也可以让批处理文件 <literal>gtkpath.bat</literal> 在运行时设置适当的 <literal>PATH</literal> 变量用于当前命令行会话中。
- </para>
- </sect2>
-
- <sect2 id="tutorials.installation.windows.cvs">
- <title>从 CVS 编译</title>
- <para>
- 这里仅仅包含在 Windows 上安装 PHP-GTK 2 最主要的步骤。如果你希望了解更多内容，请从 CVS 上获取 <filename>win32/README.win32.txt</filename> 并阅读。
- </para>
- </sect2>
- </sect1>
-
- <sect1 id="tutorials.installation.linux">
- <title>在 Linux 上安装</title>
-
- <para>
- 在 Linux 上安装 PHP-GTK 2 的最好方式就是编译它。还没有二进制包或源码包发行于任何 Linux 发布版本，所以你不能使用你最喜欢的包管理方式安装 PHP-GTK 2。这个介绍应当适用于多数 Linux 发行版，同时也适用于符合 POSIX 标准的系统。
- </para>
-
- <note>有消息表明下面的方法不能用于 FreeBSD。</note>
-
- <para>
- 有两种方式在你的 Linux 系统上安装 PHP-GTK 2。你可以选择使用已有的 PHP 安装，或安装一套独立的用于 PHP-GTK 2 的 PHP。后一种会略微简单一些，对于缺乏或没有 Linux 经验的用户这是推荐的方法。无论如何，你都需要安装有 Gtk+ 2.6 或更新版本。
- </para>
-
- <sect2 id="tutorials.installation.linux.newphp">
- <title>新的 PHP 安装包上安装 PHP-GTK 2</title>
-
- <para>
- 请遵循下面的步骤，将会一切顺利！首先你需要的是从 CVS 中新取出的 PHP。你可以选择 <literal>5_1</literal> 或 <literal>5_2</literal> 分支，都会工作得很好：
-
- <programlisting role="bash"><![CDATA[
-$ cvs -d :pserver:[email protected]:/repository login
-$ cvs -d :pserver:[email protected]:/repository co -r PHP_5_2 php-src]]></programlisting>
-
- 现在，你需要编译并安装它：
-
- <programlisting role="bash"><![CDATA[
-$ cd php-src
-$ ./buildconf
-$ ./configure --prefix=/opt/php5_2 --disable-cgi
-$ make
-$ su
-$ make install
-$ echo extension=php_gtk2.so >> /opt/php5_2/lib/php.ini
-$ /opt/php5_2/bin/php-config --extension-dir | xargs echo 'extension_dir=' >> /opt/php5_2/lib/php.ini]]></programlisting>
- </para>
-
- <note>
- <para>
- 如果当前 CVS 上的 PHP 不可以被编译，尝试从 <ulink url="&url.php.download;">php 下载页面</ulink>或 <ulink url="&url.php.snapshots;">snapshot</ulink> 下载官方发布的版本。
- </para>
- </note>
-
- <para>
- 现在，让我们取出并安装 PHP-GTK 2：
- <programlisting role="bash"><![CDATA[
-$ cd ..
-$ cvs -d :pserver:[email protected]:/repository co php-gtk
-$ cd php-gtk
-$ ./buildconf --with-phpize=/opt/php5_2/bin/phpize
-$ ./configure --with-php-config=/opt/php5_2/bin/php-config
-$ make
-$ make install]]></programlisting>
- </para>
-
- <para>
- 你可能希望创建一个连接到新安装的 PHP 执行文件：
- <programlisting role="bash"><![CDATA[
-$ ln -s /opt/php5_2/bin/php /usr/bin/php-gtk]]></programlisting>
-
- 就是这些，完成了！
- </para>
- </sect2>
-
- <sect2 id="tutorials.installation.linux.existingphp">
- <title>使用现有的 PHP 安装包</title>
-
- <para>
- 如果你决定“增加” PHP-GTK 2 到已有的 PHP 安装包上，请确保 PHP 的版本至少是 CLI 可用的 5.1 版。PHP-GTK 2 不能工作于其他版本的 PHP。你可以在命令行中输入 <command>php -v</command> 检查你的 PHP 版本。不要忘记检查单词 <literal>cli</literal> 是否出现在输出中。
- </para>
-
- <para>
- 现在，从 CVS 中取出最新版本的 PHP-GTK 2 源代码，或下载 Alpha 版本的源码包，每次提到的 PHP-GTK 2 <ulink url="&url.phpgtk.download;">下载</ulink>页面。使用 <literal>cd</literal> 进入取出或解压缩的目录，并执行下面的命令：
- <programlisting role="bash"><![CDATA[
-$ ./buildconf
-$ ./configure
-$ make
-$ make install]]></programlisting>
- </para>
-
- <para>
- 对于多数人来说这应当是可用的。然而，如果有多个 PHP 的安装在你的机器上或者你已经在其他目录安装了 PHP，你可能遇到麻烦。多数这种情况可以使用指定 <literal>phpize</literal> 和 <literal>php-config</literal> 文件的安装目录解决：
- <programlisting role="bash"><![CDATA[
-$ ./buildconf --with-phpize=/path/to/phpize
-$ ./configure --with-php-config=/path/to/php-config]]></programlisting>
- </para>
- </sect2>
-
- <sect2 id="tutorials.installation.linux.testing">
- <title>测试你的安装</title>
-
- <para>
- 在你可以使用 PHP-GTK 2 之前，你需要在 php.ini 中设置该扩展可用。在其他 <literal>extension=</literal> 设置之下仅仅需要添加：
- <programlisting role="ini"><![CDATA[
-extension=php_gtk2.so]]></programlisting>
- 即可。
- </para>
-
- <para>
- 为了确定安装是否成功，可以执行下面的内容测试：
- <programlisting role="bash"><![CDATA[
-$ php -m | grep php-gtk]]></programlisting>
-
- 你应当得到一行内容，只有 <literal>php-gtk</literal>。
- </para>
-
- <para>
- 接下来，你可以测试在 php-gtk 源码中 <filename>demos</filename> 下的示例程序。例如 <filename>demos/phpgtk2-demo.php</filename>。
- </para>
- </sect2>
- </sect1>
-
- <sect1 id="tutorials.installation.macosx">
- <title>在 Mac OS X 上安装</title>
-
- <para>
- 在安装 PHP-GTK 2 之前，应当确认你已经安装有 Apple 开发者工具（Apple Developer Tools），BSD 子系统（BSD Subsystem），和 X。虽然，BSD 子系统默认安装于 Mac OS X，但是你需要手工选择开发者工具和 X 服务器。虽然你可以使用任何 X 服务器，但是最简单的方法是使用在安装程序中 Apple 默认提供的。
- </para>
-
- <para>
- 获取 <ulink url="&url.macports;">MacPorts</ulink> （之间被称作 DarwinPorts）或者 <ulink url="&url.fink;">Fink</ulink> 并安装。你可以选择安装某一个版本的 X （如果你决定不使用 Apple 默认发行的），以及 Gtk+ 本身。同时确保你有 5.2 版本以上的 PHP，MacPorts 提供了包。在终端中输入 <literal>php -v</literal> 获得版本信息。如果希望手工编译 PHP 你可以按如下操作：
-
- <programlisting role="bash"><![CDATA[
-$ cvs -d :pserver:[email protected]:/repository co -r PHP_5_2 php-src
-$ cd php-src
-$ ./buildconf
-$ ./configure --disable-cgi
-$ make
-$ sudo make install]]></programlisting>
- 虽然你可以将它安装到任何地方，但是 <literal>/usr/local</literal> 通常都是不错的选择。MacPorts 将 PHP 安装到 <literal>/opt/local</literal>。
- </para>
-
- <para>
- 现在获取最新版本的 PHP-GTK 并编译它：
-
- <programlisting role="bash"><![CDATA[
-$ cd..
-$ cvs -d :pserver:[email protected]:/repository co php-gtk
-$ cd php-gtk
-$ ./buildconf --with-phpize=/usr/local/bin/phpize
-$ ./configure --with-php-config=/usr/local/bin/php-config \
- --disable-libglade
-$ make
-$ sudo make install]]></programlisting>
- 记得替换 <literal>/usr/local</literal> 为 PHP 真实的安装路径。例如，如果你使用 MacPorts 安装 PHP 5.2，你应当输入 <literal>/opt/local</literal> 来代替。
- </para>
-
- <para>
- 最后，复制 <literal>php.ini-recommended</literal> 文件到 <literal>/usr/local/lib/php.ini</literal> 并修改 <literal>extension_dir</literal> 的值为 <literal>php_gtk2.so</literal> 的存放位置。通常如下所示：<literal>/usr/local/lib/php/extensions/no-debug-non-zts-some-date</literal>。你可能希望在 <literal>/usr/bin</literal> 中创建新的符号连接指向 <literal>/usr/local/bin/php</literal>。再次说明，鉴于你的 PHP 安装目录，可能需要使用 <literal>/opt/local</literal> 替换 <literal>/usr/local</literal>。
- </para>
-
- <para>
- 下面继续
- <link linkend="tutorials.installation.linux.testing">测试你的安装</link>.
- </para>
- </sect1>
-
-</chapter>
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- EN-Revision: 1.12 Maintainer: mikespook Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<chapter id="tutorials.installation">
+ <title>安装 PHP-GTK 2</title>
+
+ <sect1 id="tutorials.installation.introduction">
+ <title>简介</title>
+ <para>
+ PHP-GTK 2 是 PHP 的扩展之一，并且只可用于 5.1 以及更高版本。
+ 虽然编译是最常用的安装 PHP-GTK 2 的方法，但是这一过程在 Windows 系统上
+ 也显得过于乏味和漫长。鉴于这样的原因，多数人将会选择使用官方发布的二进制
+ PHP-GTK 2 Alpha 版本或使用 Gnope 安装包。
+ </para>
+ <para>
+ 我们将介绍三种主流系统上面的安装过程：Windows，Linux 和 Mac OS X。
+ 关于 Linux 的介绍同样也适用于符合 POSIX 标准的系统。
+ </para>
+ </sect1>
+
+ <sect1 id="tutorials.installation.windows">
+ <title>在 Windows 上安装</title>
+
+ <sect2 id="tutorials.installation.windows.gnope">
+ <title>使用 Gnope</title>
+ <para>
+ 使用 Gnope 在 Windows 上安装和维护 PHP-GTK 2 已经被证明几乎是最简单的方法。
+ Gnope 是全功能的 PHP-GTK 2 安装包，包含 PHP 5.1、GTK 2.6 和 PEAR。
+ 简单的点几下鼠标你就可以安装完成！
+ </para>
+ <para>
+ 只要从 <ulink url="&url.gnope;">gnope.org</ulink> 下载安装包，并跟随屏幕上的指引。
+ Gnope 也拥有它自己的 PEAR 自动安装频道，
+ 那里你可以下载 PHP-GTK 2 程序添加到官方的 PEAR 包中。
+ 例如从 <ulink url="&url.pear.gtk2;">Gtk2 category</ulink>。
+ </para>
+ </sect2>
+
+ <sect2 id="tutorials.installation.windows.manual">
+ <title>手工安装</title>
+ <para>
+ 从 PHP-GTK 2 <ulink url="&url.phpgtk.download;">下载</ulink>页面下载
+ PHP-GTK 2 的针对 Windows 的 Alpha 版本二进制发行包。解压缩文件到指定目录。
+ 一个名为 <literal>php-gtk</literal> 的目录将会创建，并包含发行版的所有内容。
+ </para>
+ <para>
+ 你需要 <filename>php.exe</filename>（CLI 版本）和
+ <filename>php5ts.dll</filename>，这两个都可从 PHP 5 的 Windows 发行版中获得，
+ 并且放置到 <filename>php-gtk</filename> 目录。如果你希望使用这个
+ <filename>php.exe</filename> 的其他扩展，请确保你已经存放二进制文件于此。
+ </para>
+ <para>
+ <!-- FIXME: Do we need to do this? I doubt that this is necessary
+ -cweiske -->
+ 之后，你必须设置环境变量 <literal>PATH</literal> 包含发行包中的
+ <filename>gtk+2.6.9</filename> 目录。
+ 你也可以让批处理文件 <literal>gtkpath.bat</literal> 在运行时设置适当的
+ <literal>PATH</literal> 变量用于当前命令行会话中。
+ </para>
+ </sect2>
+
+ <sect2 id="tutorials.installation.windows.cvs">
+ <title>从 CVS 编译</title>
+ <para>
+ 这里仅仅包含在 Windows 上安装 PHP-GTK 2 最主要的步骤。如果你希望了解更多内容，
+ 请从 CVS 上获取 <filename>win32/README.win32.txt</filename> 并阅读。
+ </para>
+ </sect2>
+ </sect1>
+
+ <sect1 id="tutorials.installation.linux">
+ <title>在 Linux 上安装</title>
+
+ <para>
+ 在 Linux 上安装 PHP-GTK 2 的最好方式就是编译它。还没有二进制包或源码包
+ 发行于任何 Linux 发布版本，所以你不能使用你最喜欢的包管理方式安装 PHP-GTK 2。
+ 这个介绍应当适用于多数 Linux 发行版，同时也适用于符合 POSIX 标准的系统。
+ </para>
+
+ <note>有消息表明下面的方法不能用于 FreeBSD。</note>
+
+ <para>
+ 有两种方式在你的 Linux 系统上安装 PHP-GTK 2。你可以选择使用已有的 PHP 安装，
+ 或安装一套独立的用于 PHP-GTK 2 的 PHP。后一种会略微简单一些，对于缺乏或没有
+ Linux 经验的用户这是推荐的方法。无论如何，你都需要安装有 Gtk+ 2.6 或更新版本。
+ </para>
+
+ <sect2 id="tutorials.installation.linux.newphp">
+ <title>新的 PHP 安装包上安装 PHP-GTK 2</title>
+
+ <para>
+ 请遵循下面的步骤，将会一切顺利！首先你需要的是从 CVS 中新取出的 PHP。
+ 你可以选择 <literal>5_1</literal> 或 <literal>5_2</literal> 分支，
+ 都会工作得很好：
+
+ <programlisting role="bash"><![CDATA[
+$ cvs -d :pserver:[email protected]:/repository login
+$ cvs -d :pserver:[email protected]:/repository co -r PHP_5_2 php-src]]></programlisting>
+
+ 现在，你需要编译并安装它：
+
+ <programlisting role="bash"><![CDATA[
+$ cd php-src
+$ ./buildconf
+$ ./configure --prefix=/opt/php5_2 --disable-cgi
+$ make
+$ su
+$ make install
+$ echo extension=php_gtk2.so >> /opt/php5_2/lib/php.ini
+$ /opt/php5_2/bin/php-config --extension-dir | xargs echo 'extension_dir=' >> /opt/php5_2/lib/php.ini]]></programlisting>
+ </para>
+
+ <note>
+ <para>
+ 如果当前 CVS 上的 PHP 不可以被编译，尝试从
+ <ulink url="&url.php.download;">php 下载页面</ulink>或
+ <ulink url="&url.php.snapshots;">snapshot</ulink> 下载官方发布的版本。
+ </para>
+ </note>
+
+ <para>
+ 现在，让我们取出并安装 PHP-GTK 2：
+ <programlisting role="bash"><![CDATA[
+$ cd ..
+$ cvs -d :pserver:[email protected]:/repository co php-gtk
+$ cd php-gtk
+$ ./buildconf --with-phpize=/opt/php5_2/bin/phpize
+$ ./configure --with-php-config=/opt/php5_2/bin/php-config
+$ make
+$ make install]]></programlisting>
+ </para>
+
+ <para>
+ 你可能希望创建一个连接到新安装的 PHP 执行文件：
+ <programlisting role="bash"><![CDATA[
+$ ln -s /opt/php5_2/bin/php /usr/bin/php-gtk]]></programlisting>
+
+ 就是这些，完成了！
+ </para>
+ </sect2>
+
+ <sect2 id="tutorials.installation.linux.existingphp">
+ <title>使用现有的 PHP 安装包</title>
+
+ <para>
+ 如果你决定“增加” PHP-GTK 2 到已有的 PHP 安装包上，
+ 请确保 PHP 的版本至少是 CLI 可用的 5.1 版。
+ PHP-GTK 2 不能工作于其他版本的 PHP。你可以在命令行中输入
+ <command>php -v</command> 检查你的 PHP 版本。
+ 不要忘记检查单词 <literal>cli</literal> 是否出现在输出中。
+ </para>
+
+ <para>
+ 现在，从 CVS 中取出最新版本的 PHP-GTK 2 源代码，或从已经提到的 PHP-GTK 2
+ <ulink url="&url.phpgtk.download;">下载</ulink>页面下载 Alpha 版本的源码包。
+ 使用 <literal>cd</literal> 进入取出或解压缩的目录，并执行下面的命令：
+ <programlisting role="bash"><![CDATA[
+$ ./buildconf
+$ ./configure
+$ make
+$ make install]]></programlisting>
+ </para>
+
+ <para>
+ 对于多数人来说这应当是可用的。然而，如果有多个 PHP 的安装在你的机器上
+ 或者你已经在其他目录安装了 PHP，你可能遇到麻烦。多数这种情况可以使用指定
+ <literal>phpize</literal> 和 <literal>php-config</literal> 文件的安装目录解决：
+ <programlisting role="bash"><![CDATA[
+$ ./buildconf --with-phpize=/path/to/phpize
+$ ./configure --with-php-config=/path/to/php-config]]></programlisting>
+ </para>
+ </sect2>
+
+ <sect2 id="tutorials.installation.linux.testing">
+ <title>测试你的安装</title>
+
+ <para>
+ 在你可以使用 PHP-GTK 2 之前，你需要在 php.ini 中设置该扩展可用。在其他
+ <literal>extension=</literal> 设置之下仅仅需要添加：
+ <programlisting role="ini"><![CDATA[
+extension=php_gtk2.so]]></programlisting>
+ 即可。
+ </para>
+
+ <para>
+ 为了确定安装是否成功，可以执行下面的内容测试：
+ <programlisting role="bash"><![CDATA[
+$ php -m | grep php-gtk]]></programlisting>
+
+ 你应当得到一行内容，只有 <literal>php-gtk</literal>。
+ </para>
+
+ <para>
+ 接下来，你可以测试在 php-gtk 源码中 <filename>demos</filename> 下的示例程序。例如
+ <filename>demos/phpgtk2-demo.php</filename>。
+ </para>
+ </sect2>
+ </sect1>
+
+ <sect1 id="tutorials.installation.macosx">
+ <title>在 Mac OS X 上安装</title>
+
+ <para>
+ 在安装 PHP-GTK 2 之前，应当确认你已经安装有 Apple 开发者工具
+ （Apple Developer Tools），BSD 子系统（BSD Subsystem），和 X。
+ 虽然，BSD 子系统默认安装于 Mac OS X，但是你需要手工选择开发者工具和 X 服务器。
+ 虽然你可以使用任何 X 服务器，但是最简单的方法是使用在安装程序中 Apple 默认提供的。
+ </para>
+
+ <para>
+ 获取 <ulink url="&url.macports;">MacPorts</ulink> （之前被称作 DarwinPorts）
+ 或者 <ulink url="&url.fink;">Fink</ulink> 并安装。你可以选择安装
+ 某一个版本的 X （如果你决定不使用 Apple 默认发行的），以及 Gtk+ 本身。
+ 同时确保你有 5.2 版本以上的 PHP，MacPorts 提供了包。在终端中输入
+ <literal>php -v</literal> 获得版本信息。如果希望手工编译 PHP 你可以按如下操作：
+
+ <programlisting role="bash"><![CDATA[
+$ cvs -d :pserver:[email protected]:/repository co -r PHP_5_2 php-src
+$ cd php-src
+$ ./buildconf
+$ ./configure --disable-cgi
+$ make
+$ sudo make install]]></programlisting>
+ 虽然你可以将它安装到任何地方，但是 <literal>/usr/local</literal> 通常都是不错的选择。
+ MacPorts 将 PHP 安装到 <literal>/opt/local</literal>。
+ </para>
+
+ <para>
+ 现在获取最新版本的 PHP-GTK 并编译它：
+
+ <programlisting role="bash"><![CDATA[
+$ cd..
+$ cvs -d :pserver:[email protected]:/repository co php-gtk
+$ cd php-gtk
+$ ./buildconf --with-phpize=/usr/local/bin/phpize
+$ ./configure --with-php-config=/usr/local/bin/php-config \
+ --disable-libglade
+$ make
+$ sudo make install]]></programlisting>
+ 记得替换 <literal>/usr/local</literal> 为 PHP 真实的安装路径。
+ 例如，如果你使用 MacPorts 安装 PHP 5.2，
+ 你应当输入 <literal>/opt/local</literal> 来代替。
+ </para>
+
+ <para>
+ 最后，复制 <literal>php.ini-recommended</literal> 文件到
+ <literal>/usr/local/lib/php.ini</literal> 并修改
+ <literal>extension_dir</literal> 的值为
+ <literal>php_gtk2.so</literal> 的存放位置。
+ 通常如下所示：
+ <literal>/usr/local/lib/php/extensions/no-debug-non-zts-some-date</literal>。
+ 你可能希望在 <literal>/usr/bin</literal> 中创建新的符号连接指向
+ <literal>/usr/local/bin/php</literal>。
+ 再次说明，鉴于你的 PHP 安装目录，可能需要使用
+ <literal>/opt/local</literal> 替换 <literal>/usr/local</literal>。
+ </para>
+
+ <para>
+ 下面继续
+ <link linkend="tutorials.installation.linux.testing">测试你的安装</link>.
+ </para>
+ </sect1>
+
+
+ <sect1 id="tutorials.installation.macosx-stepbystep">
+ <title>一步一个脚印——在 Mac OS X 上安装 PHP-GTK 2</title>
+ <para>作者：Jonathan Richter</para>
+
+ <para>
+ 在尝试让 PHP-GTK2 工作在 Mac OS X 10.4 上时， 我发现
+ 几乎没有任何信息或者支持可以利用。经过许多次失败和错误，我让它运行了起来。
+ </para>
+ <para>
+ 我在下面写下了我做过的每一步。我不是非常擅长使用终端，
+ 有一半的时间我并不清楚自己在做什么。
+ 我仅仅为我自己工作。所以你使用这些信息的同时必须自己承担风险。
+ 希望这些能帮助其他人。
+ </para>
+
+ <note>
+ <para>
+ 下面的步骤将花费数小时的时间。
+ </para>
+ </note>
+
+ <para>
+ 有用的资源：
+ <itemizedlist>
+ <listitem>
+ <para>
+ <link linkend="tutorials.installation.macosx">以前的安装文档</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.macports.org/">macports.org</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <sect2>
+ <title>第一步：获得 Xcode</title>
+ <para>
+ 从 Apple 获得最新的 Xcode（也被称作：开发者工具）。你必须使用这个。
+ 访问 <ulink url="https://connect.apple.com">connect.apple.com</ulink>。
+ 注册并登录（这是免费的）。然后下载。
+ </para>
+ <para>
+ 在下载区的右边，点击开发者工具并且下载最新版本的 Xcode。我使用的是 2.4.1
+ 版本，大小是 926 MB。下载完成后，使用安装程序按照介绍进行安装。
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第二步：获得 Macports</title>
+ <para>
+ 我最初使用 Fink，但是进行到一半的时候由于缺少一个必要的包（GTK 2.6
+ 或更高版本）而失败了。我又使用 Macports 从新开始。
+ </para>
+ <para>
+ 访问
+ <ulink url="http://trac.macosforge.org/projects/macports/wiki/InstallingMacPorts">macosforge/InstallingMacPorts</ulink>。
+ </para>
+ <para>
+ 下载 Xcode 了，你就已经完成了第一步的部分操作。
+ 我遵循这个文章的全部内容进而一切正常。
+ </para>
+ <note>
+ <para>
+ 最新版本没有普通的 Apple 安装包。所以我下载了这个：
+ <ulink url="http://svn.macosforge.org/repository/macports/downloads/DarwinPorts-1.3.1/DarwinPorts-1.3.1-10.4.dmg">DarwinPorts-1.3.1-10.4.dmg</ulink>
+ </para>
+ </note>
+ <para>
+ 双击磁盘上的安装包安装 Macports。
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第三步：获取 GTK2 （或者被叫做 GTK+）</title>
+ <para>
+ 在终端中输入：
+ <command>sudo port install gtk2</command>
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第四步：获取 PHP 5.x</title>
+ <para>
+ 我已经从 <ulink url="http://www.entropy.ch">Entropy.ch</ulink>
+ 安装了标准的 OS X PHP 4.4.4 和 PHP 5。但是它无法工作。我从 Entropy 上删除了
+ 我的 PHP 5 安装。
+ </para>
+ <note>
+ <para>
+ 如果你希望使用 Apache 1 或者 2 运行 PHP 4 或 5，Entropy 绝对是最好的地方下载。
+ </para>
+ </note>
+ <para>
+ 在终端中输入：
+ <command>cd /</command> and
+ <command>sudo port install php5</command>
+ </para>
+ <para>
+ 喝杯咖啡，这将需要一些时间……在我的机器上花费了 2 个小时。
+ （Macports 将所有的内容安装在 <filename>/opt</filename> 目录。我用 "cd /"
+ 命令将这个目录放在根目录上。）
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第五步：PHP-GTK 的准备</title>
+ <para>
+ 在其他的指南上，你会看到安装 PHP-GTK 时使用
+ <literal>--disable-libglade</literal> 参数。我不知道为什么他们这么写。
+ 在你这么做之前请确定你确实不需要 Glade。阅读下面的资料：
+ <ulink url="http://glade.gnome.org">glade.gnome.org</ulink>。
+ </para>
+ <para>
+ 也需要查看那些截屏。我第一次安装没有安装 Glade，但是几天以后为了让 Glade
+ 可以用，我又重新安装了一遍。如果你不想安装 Glade，跳过下面的步骤。
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第六步：获取 Glade</title>
+ <para>
+ 由于一些原因，我在做这些的时候发生了错误。当我在后台运行了 X11
+ 并重新尝试的时候，没有错误发生。所以，运行 X11 并隐藏它（apple-h）。
+ </para>
+ <para>
+ 在终端中输入：
+ <screen>
+cd /opt
+sudo port install libglade
+sudo port install glade
+ </screen>
+ 再来一杯咖啡……
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第七步：获取 PHP-GTK2</title>
+ <note>
+ <para>
+ 除了使用当前的 CVS 版本，你可能希望使用官方发布的最新版本，从这里下载：
+ <ulink url="http://gtk.php.net/download.php">PHP-GTK2 download
+ page</ulink>。
+ </para>
+ </note>
+ <para>
+ 用安全的方式运行 X11。<command>phpize</command> 和
+ <command>php-config</command> 应当在 <filename>/opt/local/bin/</filename>
+ 目录中。运行下面的内容前，你应当检查它。在终端中输入：
+ <screen>
+sudo cvs -d :pserver:[email protected]:/repository co php-gtk
+cd php-gtk
+sudo ./buildconf --with-phpize=/opt/local/bin/phpize
+sudo ./configure --with-php-config=/opt/local/bin/php-config
+sudo make
+sudo make install
+ </screen>
+ </para>
+ <para>
+ 做完这些，你会在终端中看到关于扩展安装到某个目录的提示，通常是这样：
+ <filename>/opt/local/lib/php/extensions/no-debug-non-zts-20060613</filename>。
+ Apple-c 这个路径，或者写下来。一会会需要用到它。
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>步骤八：设置 php.ini</title>
+ <para>
+ 在查找中选择 Go > Go To Folder... （或者按 shift-apple-g）然后输入
+ <literal>/opt/local/etc</literal>。
+ </para>
+ <para>
+ 找到并复制文件 <filename>php.ini-recommended</filename>。将复制的文件改名为
+ <filename>php.ini</filename> 并使用如 BBedit 之类的编辑器打开它。
+ </para>
+ <para>
+ 找到 <literal>extension_dir = "./"</literal> 并且替换为如下内容：
+ <literal>extension_dir = "/opt/local/lib/php/extensions/no-debug-non-zts-20060613"</literal>
+ （就是在前一个步骤中，你从终端输出的内容里复制出来的路径）
+ </para>
+ <para>
+ 找到扩展的部分并且在其后添加下面这行：
+ <literal>extension=php_gtk2.so</literal>
+ </para>
+ <para>
+ 保存文件。
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第九步：测试</title>
+ <para>
+ 运行 X11 并隐藏它（apple-h），如果还没做的话。
+ </para>
+ <para>
+ 开启一个终端并输入：
+ <screen>
+cd /opt/php-gtk/demos
+php phpgtk2-demo.php
+ </screen>
+ 例子应当在 X11 中打开一个窗口。
+ </para>
+ <para>
+ 使用 Glade，使用如下方式在终端中启动它（需要 X11 运行）：
+ <command>/opt/local/bin/glade-2</command>
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>第十步：让它看起来更好</title>
+ <para>
+ 以我愚见，在使用 OS X 时 X11 的界面看起来是非常简陋的。要获取其他主题，访问
+ <ulink url="http://art.gnome.org/themes/gtk2">art.gnome.org</ulink> 取得。
+ 为了使用这些主题，我们需要多更多的工作。
+ </para>
+ <para>
+ 在终端中输入：
+ <command>sudo port install gtk-theme-switch</command>
+ </para>
+ <para>
+ 做完这个后，从前面的连接下载一个主题。可以用两种方式安装：
+ <orderedlist>
+ <listitem>
+ <para>
+ 移动或复制下来的 <filename>.tar.gz</filename>（不要解压缩！）到<filename>/opt/local/share/themes/</filename>
+ </para>
+ <para>
+ <!-- 原文可能有错 -->
+ 在终端中输入（X11 已经运行）：<command>/opt/local/bin/switch2</command>
+ 运行 Glade。
+ </para>
+ <para>
+ 按 + 号并点击“Install New Theme”按钮。指向
+ <filename>/opt/local/share/themes/<你的新主题名字>.tar.gz</filename>
+ </para>
+ <para>
+ 点击 OK，现在你的新主题出现在列表中。
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ 解压缩 <filename><你的新主题名字>.tar.gz</filename>
+ 并且移动或复制新主题的目录到
+ <filename>/opt/local/share/themes/</filename>
+ </para>
+ <para>
+ <!-- 原文可能有错 -->
+ 在终端中输入（X11 已经运行）：<command>/opt/local/bin/switch2</command>
+ 运行 Glade。
+ </para>
+ <para>
+ 新主题的名字应当出现在列表中。
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2>
+ <para>
+ 再次说明，我通过上面的步骤让它运行于我的机器上。
+ 我的配置是：iMac G5 2.0 GHz/1 GB RAM/OS X 10.4.8 和
+ Mac mini G4 1.42 GHz/512 MB RAM/OS X 10.4.8。
+ 请 Mac 的用户在这里留下评论、提示和技巧等等。
+ 让我们使 PHP-GTK 脚本也可运行于 OS X。非常棒的尝试！
+ </para>
+ </sect2>
+
+ </sect1>
+</chapter>
http://cvs.php.net/viewvc.cgi/php-gtk-doc/manual/zh_cn/tutorials/translation.xml?r1=1.1&r2=1.2&diff_format=u
Index: php-gtk-doc/manual/zh_cn/tutorials/translation.xml
diff -u php-gtk-doc/manual/zh_cn/tutorials/translation.xml:1.1 php-gtk-doc/manual/zh_cn/tutorials/translation.xml:1.2
--- php-gtk-doc/manual/zh_cn/tutorials/translation.xml:1.1 Fri Dec 8 15:19:59 2006
+++ php-gtk-doc/manual/zh_cn/tutorials/translation.xml Thu Jan 4 02:42:45 2007
@@ -1,13 +1,14 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!-- $Revision: 1.1 $ -->
-<chapter id="tutorials.translation">
- <title>i18n: 使用 gettext</title>
-
- <sect1>
- <title>关于该指南</title>
- <simpara>
- <!-- TODO -->
- </simpara>
- </sect1>
-</chapter>
-
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- EN-Revision: 1.3 Maintainer: mikespook Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<chapter id="tutorials.translation">
+ <title>i18n: 使用 gettext</title>
+
+ <sect1>
+ <title>关于该指南</title>
+ <simpara>
+ <!-- TODO -->
+ </simpara>
+ </sect1>
+</chapter>
+