Explain in "Hello World" e.g. that HTML tags are not needed

mumumu · mumumu · commit be045845e776 · 2024-12-08T19:54:23.000+09:00
php/doc-en@1fd6375
diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 04d9aded7bbd447523cf038ddf88e6d7f7e43c53 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 1fd637525fd3bbaec04f6fff80eeb33fce880b10 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
  <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>簡易チュートリアル</title>
@@ -67,15 +67,39 @@
   </sect1>
 
   <sect1 xml:id="tutorial.firstpage">
-   <title>PHP を使用する初めてのページ</title>
+   <info><title>PHP を使用する初めてのページ</title></info>
    <para>
     以下の内容で <filename>hello.php</filename>
     という名前のファイルを作成し、Web サーバーのルートディレクトリ
-    (<varname>DOCUMENT_ROOT</varname>) に置いてください。
+    (<varname>DOCUMENT_ROOT</varname>) に置いてください:
    </para>
    <para>
     <example>
-     <title>初めての PHP スクリプト: <filename>hello.php</filename></title>
+     <info><title>初めての PHP スクリプト: <filename>hello.php</filename></title></info>
+     <programlisting role="php">
+<![CDATA[
+<?php
+
+echo "Hello World!";
+
+?>
+]]>
+     </programlisting>
+     <simpara>
+      ブラウザを使用して、<literal>/hello.php</literal> で終わる Web アクセス用 URL を指定し、
+      このファイルにアクセスしてください。
+      ローカルに開発を行っている場合、この URL は
+      <literal>http://localhost/hello.php</literal> または
+      <literal>http://127.0.0.1/hello.php</literal> のようになります。
+      しかし、これは Web サーバーの設定に依存します。
+      全てが正しく設定されている場合、
+      このファイルは PHP によりパースされ、"Hello World" がブラウザで表示されます。
+     </simpara>
+     <simpara>
+      PHP は通常のHTMLの Webページにも埋め込むことができます。
+      つまり、HTML ドキュメントを PHP のぶんを使って書けるということです。
+      そのことを示すデモが以下になります:
+     </simpara>
      <programlisting role="php">
 <![CDATA[
 <!DOCTYPE html>
@@ -90,14 +114,7 @@
 ]]>
      </programlisting>
      <simpara>
-      ブラウザを使用して、<literal>/hello.php</literal> で終わる Web アクセス用 URL を指定し、
-      このファイルにアクセスしてください。
-      ローカルに開発を行っている場合、この URL は
-      <literal>http://localhost/hello.php</literal> または
-      <literal>http://127.0.0.1/hello.php</literal> のようになります。
-      しかし、これは Web サーバーの設定に依存します。
-      全てが正しく設定されている場合、
-      このファイルは PHP によりパースされ、以下の出力がブラウザに送信されます。
+      上記の出力は、以下のようになります:
      </simpara>
      <screen role="html">
 <![CDATA[
