Stop chunking the Introduction, add titleabbrev+title, write-through to remove 'you'

php/doc-en@77f5f3b

Author: zonuexe

chapters/intro.xml

@@ -1,9 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 132cf39aedc8655f451233f15034bbfe39302936 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 77f5f3b3a8bbe1ad7727201c7603d1419dd7840f Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,takagi -->
  <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <title>入門</title>
+  <info>
+   <titleabbrev>入門</titleabbrev>
+   <title>PHP は何ができるものですか?</title>
+  </info>
 
   <section xml:id="intro-whatis">
    <title>PHP とはなんでしょう?</title>
@@ -40,28 +43,28 @@
    </para>
    <para>
     HTMLを出力するために多くのコマンドを記述する (C や Perl のように)
-    代わりに、PHP のページは "何か"
+    代わりに、PHP のページは <replaceable>何か</replaceable>
     (この例では、<computeroutput>Hi, I'm a PHP script!</computeroutput> と出力)
     を行うコードを HTML に埋め込むことになります。
     PHP のコードは特別な <link
     linkend="language.basic-syntax.phpmode">開始および終了の処理命令
     <code>&lt;?php</code> と <code>?&gt;</code></link>
-    で囲まれており、これによって "PHP モード" の切り替えを行います。
+    で囲まれており、これによって <quote>PHP モード</quote> の切り替えを行います。
    </para>
    <para>
     PHP がクライアントサイド JavaScript のようなものと異なっている点は、
     コードがサーバーで実行され、その結果がクライアントに送信されるということです。
     クライアントは、スクリプトを実行した結果を受け取りますが、
     その出力を作成したコードがどんなものなのかを知ることはできません。
     全てのHTMLファイルをPHPで処理するようにWebサーバー
-    を設定することさえ可能で、この場合、ユーザーが袖の内に何があるかを
-    見分けることは不可能になることでしょう。
+    を設定することさえ可能で、この場合、ユーザーがPHPが動いていることすら
+    知ることができません。
    </para>
    <para>
     PHPを使用する上で最も優れている点は、初心者に対しては非常に分かり
-    易いと同時に、プロフェッショナルのプログラマに対しては多くの進んだ
+    やすいと同時に、プロフェッショナルのプログラマに対しては多くの進んだ
     機能を提供している点です。PHPの機能を羅列した長い一覧表を読まなけ
-    ればならないのかと心配する必要はありません。PHPはすぐに始められま
+    ればならないのかと心配する必要はありません。PHPは誰でもすぐに始められま
     すし、時間を掛けずに簡単なスクリプトが書けるようになります。
    </para>
    <para>
@@ -73,7 +76,7 @@
    </para>
   </section>
 
-  <section xml:id="intro-whatcando">
+  <section xml:id="intro-whatcando" annotations="chunk:false">
    <title>PHPにできることは?</title>
    <para>
     あらゆることができます。PHPでは主にサーバーサイドでの活用に焦点が
@@ -87,14 +90,12 @@
     <itemizedlist>
      <listitem>
       <simpara>
-       サーバーサイドでのスクリプティング。これは最も古くからあり
+       サーバーサイドでのスクリプティング。これは幅広く使われていて
        PHPの中心となる分野です。ここでPHPを動作させるには
        3つのものが必要です。PHPパーサ(CGIもしくはサーバーモジュール)、
-       ウェブサーバー、そしてブラウザです。ウェブサーバーは
-       インストールされたPHPと連結して起動されなければなりません。
-       ブラウザでウェブサーバーにアクセスし、PHPページを閲覧することで
-       PHPプログラムの出力を得ることが出来ます。<link
-       linkend="install">インストール手順</link>の章に詳しい
+       ウェブサーバー、そしてブラウザです。これらはいずれもローカルマシンで
+       実行して PHP プログラミングを試すことができます。
+       <link linkend="install">インストール手順</link>の章に詳しい
        情報があります。
       </simpara>
      </listitem>
@@ -103,8 +104,8 @@
        コマンドラインでのスクリプティング。PHPスクリプトは
        サーバーもブラウザも無しで動作させるようにすることも出来ます。
        この場合、PHPパーサだけが必要となります。このタイプは
-       cron(Windowsではタスクスケジューラ)を使用して一定間隔で
-       スクリプトを実行したい場合や、ちょっとした文書処理を
+       <command>cron</command>(Unix および macOS) やタスクスケジューラ(Windows)を使用して
+       一定間隔で スクリプトを実行したい場合や、ちょっとした文書処理を
        行うのに最適な方法です。<link linkend="features.commandline">
        コマンドラインでPHPを使う</link>の章に詳しい情報があります。
       </simpara>
@@ -122,8 +123,8 @@
     CGI としても動作します。
    </para>
    <para>
-    つまりPHPを使用する場合にはOSとウェブサーバーを自由に選ぶことが出来ます。
-    さらに手続き型のプログラミングかオブジェクト指向のプログラミングか、
+    つまり、PHPでは開発者が OS とウェブサーバーを自由に選ぶことができます。
+    さらには手続き型プログラミングかオブジェクト指向プログラミングか、
     もしくはそれらを混在させるかといった選択を行うこともできます。
    </para>
    <para>
@@ -174,8 +175,8 @@
     などのように PHP のマニュアルに記載されていないものもあります。
    </para>
    <para>
-    お分かりの通り、このページではPHPの機能やPHPを使用することの利点を全て
-    紹介することは出来ません。<link linkend="install">PHPのインストール
+    このページだけではPHPの機能やPHPを使用することの利点を全て
+    紹介することはできません。<link linkend="install">PHPのインストール
     </link>の章を読んでみてください。紹介された拡張モジュールに関しては<link
     linkend="funcref">関数リファレンス</link>を読んでみてください。
    </para>