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

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This page is a translated version of the page Quanta RefreshDoc and the translation is 100% complete.

Other languages:

English
dansk
українська

У цьому підручнику наведено настанови щодо підтримання актуальності даних 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, звантажте і замініть його. Ви можете, наприклад, зробити розмір шрифту меншим або внести інші зміни.

Щасти