Оновлення документації до PHP для Quanta

    From KDE UserBase Wiki
    This page is a translated version of the page Quanta RefreshDoc and the translation is 100% complete.
    Other languages:

    У цьому підручнику наведено настанови щодо підтримання актуальності даних quanta-php-documentation

    Будь ласка, виконуйте ці покрокові настанови.

    Перше: встановіть пакунок php-documentation

    По-перше, вам слід встановити пакунок php-documentation вашого дистрибутива.

    В системі Ubuntu віддайте команду:

    sudo apt-get install php-doc


    Друге: оновіть документацію до PHP

    Зауваження

    Якщо ви виконаєте запропоновані настанови, доступ до файлів doc матимуть звичайні користувачі. У нашому випадку це не важливо.


    • Відкрийте сторінку http://www.php.net/download-docs.php і звантажте архів у форматі "Many HTML files " мовою, яку ви знаєте.
    • Виконайте видобування цього пакунка до вашого домашнього каталогу так, щоб у вас був каталог /home/користувач/html
    • Скопіюйте видобуті файли до каталогу документації. (в Ubuntu: /usr/share/doc/php-doc/html)
    # rm -fr /usr/share/doc/php-doc/html
    # mv /home/user/html /usr/share/doc/php-doc/html


    • Віддайте команду
    # chmod -R o+rwx /usr/share/doc/php-doc/html


    Третє: оновіть файл docrc, щоб у Quanta ви мали справу з новим покажчиком

    Встановіть php-cli

    В Ubuntu віддайте команду:

    sudo apt-get install php-cli

    Скопіюйте код з цієї сторінки і збережіть його до каталогу quanta-doc з назвою /usr/share/apps/quanta/doc/gendoc.php

    Цей скрипт використовує php-XML-Reader. Через це вам слід скоригувати деякі з html відповідно до правил XML:

    • Відкрийте /usr/share/apps/quanta/doc/php/index.html і /usr/share/apps/quanta/doc/php/funcref.html
    • Змініть рядок
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">

    на

    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    • Перейдіть до каталогу /usr/share/apps/quanta/doc/
    • Виконайте команду (від імені користувача root)
    php gendoc.php php

    Цей скрипт виконає оновлення php.docrc і створить php_fref.docrc.

    php.docrc — файл звичайного покажчика документації до PHP.

    php-fref.docrc — додатковий файл покажчика для всіх сторінок, на яких показано дані функції. Він може бути дуже зручним.


    Четверте (необов’язкове): надання сторінкам кращого і зручнішого вигляду

    До документації можна застосувати файл css. Встановіть і запустіть KFileReplace.

    • Виберіть пункт Налагодити сеанс пошуку/заміни.
    • Змініть Адресу на /usr/share/doc/php-doc/html.
    • Встановіть значення Фільтр у *.html
    • Зніміть позначку з пункту включення підтек.
    • Встановіть кодування utf8
    • Не вводьте нічого у поля Шукати і Замінити.
    • Натисніть Шукати пізніше.
    • Натисніть кнопку Додати рядок у головному вікні програми.
    • Увімкніть режим Пошук з заміною.
    • Виконайте пошук:
    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     <html>
      <head>
       <meta http-equiv="content-type" content="text/html; charset=UTF-8"


    • З заміною на:
    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     <html>
      <head>
       <link rel="stylesheet" type="text/css" href="style.css" />
       <meta http-equiv="content-type" content="text/html; charset=UTF-8"

    Попередження

    Переконайтеся, що наприкінці тексту немає символу нового рядка!


    • Натисніть стрілку ->.
    • Натисніть кнопку Гаразд.
    • Натисніть кнопку Замінити (не Імітувати) у головному вікні програми.
    • Створіть файл style.css у каталозі /usr/share/doc/php-doc/html

    За допомогою цього файла ви зможете змінити вигляд сторінок.

    Якщо вам подобається стиль php.net, звантажте і замініть його. Ви можете, наприклад, зробити розмір шрифту меншим або внести інші зміни.

    Щасти