View source for Quanta RefreshDoc/uk

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

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

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

В системі Ubuntu віддайте команду:
{{Input|1= sudo apt-get install php-doc}}


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

{{Note_(uk)|1=Якщо ви виконаєте запропоновані настанови, доступ до файлів doc матимуть звичайні користувачі. У нашому випадку це не важливо.}}

* Відкрийте сторінку http://www.php.net/download-docs.php і звантажте архів у форматі "Many HTML files " мовою, яку ви знаєте.
* Виконайте видобування цього пакунка до вашого домашнього каталогу так, щоб у вас був каталог /home/користувач/html
* Скопіюйте видобуті файли до каталогу документації. (в Ubuntu: /usr/share/doc/php-doc/html)<br />
{{Input|1= # rm -fr /usr/share/doc/php-doc/html
 # mv /home/user/html /usr/share/doc/php-doc/html}}<br />
* Віддайте команду
{{Input|1= # chmod -R o+rwx /usr/share/doc/php-doc/html}}


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

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

В Ubuntu віддайте команду:
{{Input|1=sudo apt-get install php-cli}}

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

The script uses the '''php-XML-Reader'''. Because of that you have to make some html-files XML-valid:
* Open /usr/share/apps/quanta/doc/php/index.html and /usr/share/apps/quanta/doc/php/funcref.html
* Change the line
{{Output|1=<meta http-equiv="content-type" content="text/html; charset=UTF-8">}}
into
{{Input|1=<meta http-equiv="content-type" content="text/html; charset=UTF-8" />}}
* cd into /usr/share/apps/quanta/doc/
* Execute (as root)
{{Input|1=php gendoc.php php}}

That script will update '''php.docrc''' and create '''php_fref.docrc'''.

'''php.docrc''' is the file for the normal index of the php-documentation.

'''php-fref.docrc''' is an additional index file for all pages, functions are listed in it. I thought it could be convenient.


=== Fourth: Optional: Get better look-and-feel for the pages ===

It's possible to use a css-file on the documentation. Install and open '''KFileReplace'''.

* Click ''Customize Search/Replace Session''
* Change ''Location'' to /usr/share/doc/php-doc/html
* Set ''Filter'' to    *.html
* Disable including subfolders
* Set Encoding to utf8
* Don't type anything in ''Search'' or ''Replace''
* Click <menuchoice>Search Later</menuchoice>
* Click on the <menuchoice>Add string</menuchoice> Button in main window
* Activate ''Search and replace'' mode
* Search for:
{{Output|1= <!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"}}<br />
* Replace with:
{{Input|1= <!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"}}

{{Warning|1=Make sure that you don't have a newline at the end!}}
* Click on the -> arrow.
* Click <menuchoice>OK</menuchoice>
* Click on the <menuchoice>Replace</menuchoice> Button (not ''Simulate'') in the main window.
* Create a style.css-File in /usr/share/doc/php-doc/html

Here you could modify the appearance.

If you like the php.net-style, download it from 
 http://www.php.net/styles/site.css and modify it. Maybe you want to make the font-size smaller etc.

Щасти

[[Category:Розробка/uk]]
[[Category:Підручники/uk]]