archived-web-php/download-docs.php

<?php
require_once 'prepend.inc';

$SIDEBAR_DATA='
<h3>Documentation online</h3>
<p>
You can read the
<a href="/docs.php">documentation online</a>
in various languages, even in printer
friendly HTML format.
</p>

<h3>Tips for Windows users</h3>
<p>
If you don\'t know how to handle bz2 compressed
manuals on Windows, please read our <a
href="/manual/en/faq.misc.php#faq.misc.bz2">FAQ entry</a>
on this subject.
</p>
<p>
You may also check out the still in progress
development of a new CHM format based PHP manual at
<a href="http://weblabor.hu/php-doc-chm">http://weblabor.hu/php-doc-chm</a>.
</p>

<h3>File sizes and dates</h3>
<p>
If you are using a capable browser, the file size and
date will show up when you move the mouse above the link.
If you use another browser, or would like to see all the
information, you can <a href="/download-docs.php?sizes=1">click
here to see all the file sizes and dates</a>.
</p>
';

commonHeader("Download documentation");

$man_languages = array('en', 'pt_BR', 'zh_cn', 'cs', 'nl', 'fr', 'de', 'hu', 'it', 'ja', 'ko', 'pl', 'es');

# array structure: (header, link_text, show_size_for_package)
$formats = array(
 "bigmanual.html.bz2"      => array("Single HTML",         "html.bz2"),
 "manual.tar.bz2"          => array("Many HTML files",     "tar.bz2"),
 //"php_manual_LANG.pdf.bz2" => array("PDF",                 "pdf.bz2"),
 "manual_doc.pdb"          => array("PalmPilot DOC",       "doc.pdb"),
 "manual_isilo.pdb"        => array("PalmPilot iSilo",     "isilo.pdb"),
 "manual-LANG.chm"         => array("Windows HTML Help",   "chm")
);
?>

<h1>Download documentation</h1>

<p>
The PHP manual is available in a selection of languages
and formats. Pick a language and format from the table below
to start downloading.
</p>

<p>
Note that the packaged HTML version of the manual
(tar.bz2) doesn't contain any directories,
so all of the files will be dumped into your current working
directory when you expand the archive unless the tool you
use does otherwise.
</p>

<p>
<em>
Please note that due to some technical problems, we do not
distribute PDF versions of the manual right now.
</em>
</p>

<table border="0" cellpadding="2" cellspacing="1" width="100%">
 <tr bgcolor="#cccccc">
  <td>&nbsp;</td>
  <?php 
    while (list($k,$v) = each($formats)) {
      echo "<th valign=\"bottom\">$v[0]</th>\n";
    }?>
 </tr>
 <?php
   while (list(,$langcode) = each($man_languages)) {
     $language = $LANGUAGES[$langcode];
     echo "<tr>\n<td bgcolor=\"#dddddd\"><b>$language</b></td>\n";
     reset($formats);
     while (list($fn,$details) = each($formats)) {
       echo "<td align=\"center\" bgcolor=\"#eeeeee\">";

       $link_to = "";
       if (file_exists("manual/$langcode/$fn")) {
         $link_to = "manual/$langcode/$fn";
       }
       elseif (file_exists("distributions/manual/php_manual_$langcode.$details[1]")) {
         $link_to = "distributions/manual/php_manual_$langcode.$details[1]";
       }
       elseif (file_exists("distributions/manual/manual-$langcode.$details[1]")) {
         $link_to = "distributions/manual/manual-$langcode.$details[1]";
       }

       if (!$link_to) {
         echo "&nbsp;";
       }
       else {
         $size = @filesize($link_to);
         $changed = @filemtime($link_to);
         $date_format = "j M Y"; // Part of the RFC date type (to be short)
         if ($size) {
           echo "<a href=\"$link_to\" title=\" Size: ", (int) ($size/1024), "Kb\n Date: ", date($date_format, $changed), "\">$details[1]</a>";
           if ($sizes) {
             echo "<br><small>Size: ", (int) ($size/1024), "Kb<br>Date: ", date($date_format, $changed), "</small>";
           }
         } else {
           echo "&nbsp;";
         }
       }
       
       // Quite bad looking code tweak to add a link to the extended CHM (en only!)
       if ($langcode == "en" && $fn == "manual-LANG.chm") {
           echo ', <a href="http://weblabor.hu/php-doc-chm">extended chm</a>';
       }

       echo "</td>\n";
     }
   }?>
</table>

<?php echo hdelim(); ?>

<h1>Documentation howto</h1>

<p>
The PHP Documentation Team has a documentation howto, including coverage
on how to set up a working environment on Unix/Linux/Windows, how to build
HTML formatted docs from the XML sources, what conventions to follow when
writing documentation, etc. If you are interested in the process, or would
like to start/join a translation, this is a must read:
<a href="http://cvs.php.net/co.php/phpdoc/howto/howto.html.tar.gz">http://cvs.php.net/co.php/phpdoc/howto/howto.html.tar.gz</a>
</p>

<?php echo hdelim(); ?>

<h1>French PHP Manual</h1>

<p>
The French PHP manual is also available on an external site, in differents formats.
Documentation is the official flavor, while formating and localization has 
been worked some more (function and examples indexes, short version, search engine..). 
Besides, those are compressed for faster download.
<a href="http://dev.nexen.net/docs/php/chargement.html">Follow this link for
more French downloads</a>
</p>

<p>
La documentation Fran&ccedil;aise est disponible sur un site secondaire,
dans diff&eacute;rents formats. C'est la version officielle, compl&egrave;tement 
francis&eacute;e et retravaill&eacute;e. De plus, ces docs sont compress&eacute;es.
</p>

<?php commonFooter(); ?>