Quanta RefreshDoc/uk: Difference between revisions

Latest revision as of 12:30, 23 November 2010

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

Щасти

@@ Line 19: / Line 19: @@
 * Скопіюйте видобуті файли до каталогу документації. (в 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 />
+# mv /home/user/html /usr/share/doc/php-doc/html}}<br />
 * Віддайте команду
 {{Input|1= # chmod -R o+rwx /usr/share/doc/php-doc/html}}
@@ Line 36: / Line 36: @@
 * Відкрийте /usr/share/apps/quanta/doc/php/index.html і /usr/share/apps/quanta/doc/php/funcref.html
 * Змініть рядок
-{{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>>}}
 на
-{{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> />}}
 * Перейдіть до каталогу /usr/share/apps/quanta/doc/
 * Виконайте команду (від імені користувача root)
@@ Line 45: / Line 45: @@
 Цей скрипт виконає оновлення '''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">
   <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">
+{{Input|1= <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" <nowiki>"http://www.w3.org/TR/html4/loose.dtd"</nowiki>>
   <html>
    <head>
@@ Line 75: / Line 75: @@
     <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.
 Щасти