Japanese translation (2/3)

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.12 Maintainer: takagi Status: ready -->
<chapter id="tutorials.installation">
 <title>PHP-GTK 2 </title>

 <sect1 id="tutorials.installation.introduction">
  <title></title>
  <para>
   PHP-GTK 2  PHP PHP 5.1 
   PHP-GTK 2 
   Windows 
    PHP-GTK 2 
   Gnope 
  </para>
  <para>
   
   WindowsLinux  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 PHP-GTK 2  Windows
    
    Gnope  PHP-GTK 2 
    PHP 5.1GTK 2.6  PEAR 
    !
   </para>
   <para>
     <ulink url="&url.gnope;">gnope.org</ulink> 
    Gnope  PEAR 
     PEAR  <ulink url="&url.pear.gtk2;">Gtk2 </ulink>
     PHP-GTK 2 
   </para>
  </sect2>

  <sect2 id="tutorials.installation.windows.manual">
   <title></title>
   <para>
    PHP-GTK 2  Windows 
    <ulink url="&url.phpgtk.download;"></ulink>
    
    <literal>php-gtk</literal> 
    
   </para>
   <para>
    <filename>php.exe</filename> (CLI ) 
    <filename>php5ts.dll</filename> 
    Windows  PHP 5 
    <filename>php-gtk</filename> 
     <filename>php.exe</filename>
    
    put their binaries here too.
   </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>
   PHP-GTK 2  Linux 
   
    PHP-GTK 2 !
    Linux 
    POSIX 
  </para>

  <note>FreeBSD </note>

  <para>
   PHP-GTK 2  Linux 
    PHP 
    PHP-GTK 2  PHP 
   Linux 
   Gtk+  2.6 
  </para>

  <sect2 id="tutorials.installation.linux.newphp">
   <title>PHP-GTK 2  PHP </title>

   <para>
    !
    PHP 
    <literal>5_1</literal>  <literal>5_2</literal>
    
    both work fine:

    <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;"></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  PHP-GTK 2  '' 
     PHP  5.1  CLI 
    PHP-GTK 2  PHP 
    PHP 
    <command>php -v</command> 
     <literal>cli</literal>
    
   </para>

   <para>
    CVS  tar 
    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 
    <filename>php.ini</filename> 
    <programlisting role="ini"><![CDATA[
extension=php_gtk2.so]]></programlisting>
     <literal>extension=</literal> 
   </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 Developer Tools
   BSD Subsystem  X 
   BSD subsystem  Mac OS X 
   Developer Tools  X 
   X 
   Apple  Mac OS X 
  </para>

  <para>
   <ulink url="&url.macports;">MacPorts</ulink> (
   DarwinPorts )  <ulink url="&url.fink;">Fink</ulink>
   
   X (Apple )
    Gtk+ 
   Fink  MacPorts  2.6  Gtk+ 
   PHP  5.2 
   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>
   
   <filename>/usr/local/</filename> 
   MacPorts  PHP  <filename>/opt/local/</filename>
   
  </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>
   <filename>/usr/local/</filename>  PHP
   PHP 5.2 
   MacPorts 
   <filename>/opt/local/</filename> 
  </para>

  <para>
   <filename>php.ini-recommended</filename> 
   <filename>/usr/local/lib/php.ini</filename> 
   <literal>extension_dir</literal> 
   <literal>php_gtk2.so</literal> 
   <literal>/usr/local/lib/php/extensions/no-debug-non-zts-some-date</literal>
   <filename>/usr/bin/</filename> 
   <filename>/usr/local/bin/php</filename> 
   PHP 
   <filename>/usr/local/</filename> 
   <filename>/opt/local/</filename> 
  </para>

  <para>
   <link linkend="tutorials.installation.linux.testing">
   </link>
  </para>
 </sect1>


 <sect1 id="tutorials.installation.macosx-stepbystep">
  <title>Mac OS X  - </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> 1 - Xcode </title>
   <para>
     Xcode (: Developer Tools)  Apple 
    
    <ulink url="https://connect.apple.com">connect.apple.com</ulink>
     () 
   </para>
   <para>
     Developer Tools 
     Xcode 
    2.4.1  923 MB 
    
   </para>
  </sect2>

  <sect2>
   <title> 2 - 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 installer 
     <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> 3 - GTK2 (: GTK+) </title>
   <para>
    
    <command>sudo port install gtk2</command>
    
   </para>
  </sect2>

  <sect2>
   <title> 4 - PHP5.x </title>
   <para>
     OS X  PHP 4.4.4 
     <ulink url="http://www.entropy.ch">Entropy.ch</ulink>
     PHP5 
     Entropy  PHP5 
   </para>
   <note>
    <para>
     Apache 1  2  PHP4  5 
     Entropy 
    </para>
   </note>
   <para>
    
    <command>cd /</command>
    <command>sudo port install php5</command>
    
   </para>
   <para>
    
    
    (Macports  <filename>/opt</filename>
    "cd /"
    )
   </para>
  </sect2>

  <sect2>
   <title> 5 - 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> 6 - 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> 7 - PHP-GTK2 </title>
   <note>
    <para>
     CVS 
     <ulink url="http://gtk.php.net/download.php">PHP-GTK2 </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> 8 - php.ini </title>
   <para>
    Finder  Go &gt; 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> 9 - </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> 10 - </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/&lt;your-new-theme-name&gt;.tar.gz</filename>
       
      </para>
      <para>
       OK 
      </para>
     </listitem>

     <listitem>
      <para>
       <filename>&lt;your-new-theme-name&gt;.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  TIPS
    PHP-GTK  OS X !
   </para>
  </sect2>

 </sect1>
</chapter>

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 Maintainer: takagi Status: ready -->
<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-Gtk1 
    PHP-Gtk2  PHP-Gtk1 
   </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>
   PHP-GTK 
   <literal>gtk</literal> 
   PHP 4  PHP-GTK 1 PHP-GTK 
   <ulink url="http://www.php.net/dl">dl()</ulink>
    PHP 5 
   
   
   
   
  </para>


  <example>
   <title></title>
   <programlisting role="php"><![CDATA[$wnd = new GtkWindow();]]></programlisting>
  </example>

  <para>
    <link linkend="gtk.gtkwindow">window</link> 
   
    <literal>$wnd</literal> 
   PHP 4  PHP-GTK 1 
   <literal>new</literal>  <literal>&amp;</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>

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready -->
<chapter id="tutorials.helloadvanced">
 <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> 
  <literal>_</literal> 
  <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>
   <varname>$wnd</varname>
  <varname>$txtUsername</varname>  <varname>$txtPassword</varname>
  () <literal>login</literal>
  
  
  
 </para>

 <para>
  
  <classname>GtkWindow</classname>  bin 
  
  
   <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>
  
  
  <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>