Quanta RefreshDoc/uk: Difference between revisions

From KDE UserBase Wiki
(Created page with "==У цьому підручнику наведено настанови щодо підтримання актуальності даних quanta-php-documentation==")
No edit summary
 
(27 intermediate revisions by 2 users not shown)
Line 2: Line 2:
==У цьому підручнику наведено настанови щодо підтримання актуальності даних quanta-php-documentation==
==У цьому підручнику наведено настанови щодо підтримання актуальності даних quanta-php-documentation==


Please follow the step-by-step guide.
Будь ласка, виконуйте ці покрокові настанови.


=== First: Install php-documentation ===
=== Перше: встановіть пакунок php-documentation ===
First, you have to install the php-documentation packet for your Distribution.
По-перше, вам слід встановити пакунок php-documentation вашого дистрибутива.


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




=== Second: Download newest php-documentation ===
=== Друге: оновіть документацію до PHP ===


{{Note|1= If you do as proposed, the doc-files will have user-rights. In this case that is not important.}}
{{Note_(uk)|1=Якщо ви виконаєте запропоновані настанови, доступ до файлів doc матимуть звичайні користувачі. У нашому випадку це не важливо.}}


* Visit http://www.php.net/download-docs.php and download the "Many HTML files "-archive for your prefered language.
* Відкрийте сторінку http://www.php.net/download-docs.php і звантажте архів у форматі "Many HTML files " мовою, яку ви знаєте.
* Extract that package into your home-directory, so you have a directory /home/user/html
* Виконайте видобування цього пакунка до вашого домашнього каталогу так, щоб у вас був каталог /home/користувач/html
* Copy these files into the doc-dir. (in Ubuntu: /usr/share/doc/php-doc/html)<br />
* Скопіюйте видобуті файли до каталогу документації. (в Ubuntu: /usr/share/doc/php-doc/html)<br />
{{Input|1= # rm -fr /usr/share/doc/php-doc/html
{{Input|1= # rm -fr /usr/share/doc/php-doc/html
# mv /home/user/html /usr/share/doc/php-doc/html}}<br />
# mv /home/user/html /usr/share/doc/php-doc/html}}<br />
* Execute
* Віддайте команду
{{Input|1= # chmod -R o+rwx /usr/share/doc/php-doc/html}}
{{Input|1= # chmod -R o+rwx /usr/share/doc/php-doc/html}}




=== Third: refresh docrc-file, so that Quanta has a new index ===
=== Третє: оновіть файл docrc, щоб у Quanta ви мали справу з новим покажчиком ===


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


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


Copy the code from [[Quanta_RefreshDoc_script|this page]] and save it into the quanta-doc dir as /usr/share/apps/quanta/doc/gendoc.php
Скопіюйте код з [[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:
Цей скрипт використовує '''php-XML-Reader'''. Через це вам слід скоригувати деякі з html відповідно до правил XML:
* Open /usr/share/apps/quanta/doc/php/index.html and /usr/share/apps/quanta/doc/php/funcref.html
* Відкрийте /usr/share/apps/quanta/doc/php/index.html і /usr/share/apps/quanta/doc/php/funcref.html
* Change the line
* Змініть рядок
{{Output|1=<meta http-equiv="content-type" content="text/html; charset=UTF-8">}}
{{Input|1=<meta http-equiv="content-type" content=<nowiki>"text/html; charset=UTF-8"</nowiki>>}}
into
на
{{Input|1=<meta http-equiv="content-type" content="text/html; charset=UTF-8" />}}
{{Input|1=<meta http-equiv="content-type" content=<nowiki>"text/html; charset=UTF-8"</nowiki> />}}
* cd into /usr/share/apps/quanta/doc/
* Перейдіть до каталогу /usr/share/apps/quanta/doc/
* Execute (as root)
* Виконайте команду (від імені користувача root)
{{Input|1=php gendoc.php php}}
{{Input|1=php gendoc.php php}}


That script will update '''php.docrc''' and create '''php_fref.docrc'''.
Цей скрипт виконає оновлення '''php.docrc''' і створить '''php_fref.docrc'''.


'''php.docrc''' is the file for the normal index of the php-documentation.
'''php.docrc''' — файл звичайного покажчика документації до PHP.


'''php-fref.docrc''' is an additional index file for all pages, functions are listed in it. I thought it could be convenient.
'''php-fref.docrc''' — додатковий файл покажчика для всіх сторінок, на яких показано дані функції. Він може бути дуже зручним.




=== 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'''.
До документації можна застосувати файл css. Встановіть і запустіть '''KFileReplace'''.


* Click ''Customize Search/Replace Session''
* Виберіть пункт ''Налагодити сеанс пошуку/заміни''.
* Change ''Location'' to /usr/share/doc/php-doc/html
* Змініть ''Адресу'' на /usr/share/doc/php-doc/html.
* Set ''Filter'' to    *.html
* Встановіть значення ''Фільтр'' у *.html
* Disable including subfolders
* Зніміть позначку з пункту включення підтек.
* Set Encoding to utf8
* Встановіть кодування utf8
* Don't type anything in ''Search'' or ''Replace''
* Не вводьте нічого у поля ''Шукати'' і ''Замінити''.
* Click <menuchoice>Search Later</menuchoice>
* Натисніть <menuchoice>Шукати пізніше</menuchoice>.
* Click on the <menuchoice>Add string</menuchoice> Button in main window
* Натисніть кнопку <menuchoice>Додати рядок</menuchoice> у головному вікні програми.
* 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">
{{Output|1= <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  <html>
  <html>
   <head>
   <head>
   <meta http-equiv="content-type" content="text/html; charset=UTF-8"}}<br />
   <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">
{{Input|1= <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" <nowiki>"http://www.w3.org/TR/html4/loose.dtd"</nowiki>>
  <html>
  <html>
   <head>
   <head>
Line 75: Line 75:
   <meta http-equiv="content-type" content="text/html; charset=UTF-8"}}
   <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!}}
{{Warning_(uk)|1=Переконайтеся, що наприкінці тексту немає символу нового рядка!}}
* Click on the -> arrow.
* Натисніть стрілку ->.
* Click <menuchoice>OK</menuchoice>
* Натисніть кнопку <menuchoice>Гаразд</menuchoice>.
* Click on the <menuchoice>Replace</menuchoice> Button (not ''Simulate'') in the main window.
* Натисніть кнопку <menuchoice>Замінити</menuchoice> (не ''Імітувати'') у головному вікні програми.
* Create a style.css-File in /usr/share/doc/php-doc/html
* Створіть файл style.css у каталозі /usr/share/doc/php-doc/html


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


If you like the php.net-style, download it from
Якщо вам подобається стиль php.net, [http://www.php.net/styles/site.css звантажте] і замініть його. Ви можете, наприклад, зробити розмір шрифту меншим або внести інші зміни.
http://www.php.net/styles/site.css and modify it. Maybe you want to make the font-size smaller etc.


Good luck
Щасти


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

Latest revision as of 12:30, 23 November 2010

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

Щасти