1 files changed, 124 insertions, 0 deletions
diff --git a/uk/doc/dcop.docbook b/uk/doc/dcop.docbook
new file mode 100644
index 0000000..ad69445
--- /dev/null
+++ b/uk/doc/dcop.docbook
@@ -0,0 +1,124 @@
+<chapter id="dcop">
+  <title
+>Інтерфейс &DCOP; для &k3b;</title>
+  <para
+>&k3b;, як і інші програми &kde; має підтримку інтерфейсу &DCOP;, який дає змогу керувати деякою її функціональністю з іншої програми, напр., скрипту оболонки.</para>
+  <para
+>Для використання цих функцій &DCOP; можна вживати або програму командного рядка <command
+>dcop</command
+>, або зручнішу програму <application
+>Kdcop</application
+>. Обидва шляхи надають доступ до однакової функціональності, тому рішення яку з них вживати залежатиме тільки від ваших вподобань і контексту використання.</para>
+  <para
+>Цей розділ припускає, що ви користуєтесь програмою командного рядка <command
+>dcop</command
+>. Щоб отримати доступ до функцій &k3b; через &DCOP;, переконайтесь, що &k3b; запущено і тоді введіть в консолі щось подібне до цього: <screen
+><prompt
+>#</prompt
+> <command
+>dcop</command
+> <option
+>k3b</option
+> <option
+>K3bInterface</option
+> <replaceable
+>[функція]</replaceable
+>
+</screen>
+</para>
+
+<para
+>Окрім загальних функцій &DCOP; доступних для всіх програм &kde;, інтерфейс DCOP для &k3b; в основному складається з двох частин, які описані нижче.</para>
+
+<sect1>
+<title
+>Типовий інтерфейс K3bInterface</title>
+
+<para
+>Типовий інтерфейс до K3b через DCOP надає функціональність копіювання компакт-дисків (copyCD), форматування DVD (formatDVD) і методів для створення нових проектів.</para>
+
+<programlisting
+>DCOPRef createDataCDProject()
+DCOPRef createAudioCDProject()
+DCOPRef createMixedCDProject()
+DCOPRef createVideoCDProject()
+DCOPRef createMovixCDProject()
+DCOPRef createDataDVDProject()
+DCOPRef createVideoDVDProject()
+DCOPRef createMovixDVDProject()
+DCOPRef openProject(KURL url)
+QValueList&lt;DCOPRef&gt; projects()
+DCOPRef currentProject()
+void copyCd()
+void copyDvd()
+void eraseCdrw()
+void formatDvd()
+void burnCdImage(KURL url)
+void burnDvdImage(KURL url)
+</programlisting>
+
+<para
+>Результат з будь-якого методу createXXXProject отримує посилання DCOP до новоствореного проекту: <programlisting
+>DCOPRef(k3b,K3bProject-0)</programlisting
+> Також, можна створити проект за допомогою командного рядка: <screen>
+<prompt
+>#</prompt
+> <command
+>k3b</command
+> <replaceable
+>--audiocd</replaceable>
+</screen
+> а потім отримати посилання до цього проекту за допомогою <screen>
+<prompt
+>#</prompt
+> <command
+>dcop</command
+> <option
+>k3b</option
+> <option
+>K3bInterface</option
+> <replaceable
+>поточнийПроект</replaceable>
+</screen
+> Через це посилання можна маніпулювати проект, користуючись <link linkend="k3bprojectinterface"
+>K3bProjectInterface</link
+>.</para>
+
+</sect1>
+
+<sect1 id="k3bprojectinterface">
+<title
+>K3bProjectInterface</title>
+
+<programlisting
+>void addUrls(KURL::List urls)
+void addUrl(KURL url)
+void burn()
+</programlisting>
+
+<para
+>K3b надає інтерфейс K3bProjectInterface або більш потужний інтерфейс K3bDataProjectInterface, який застосовується тільки для проектів з даними (КД і DVD): <programlisting
+>void createFolder(QString name)
+void createFolder(QString name,QString parent)
+void addUrl(KURL url,QString parent)
+void addUrls(KURL::List urls,QString parent)
+void removeItem(QString path)
+void renameItem(QString path,QString newName)
+void setVolumeID(QString id)
+</programlisting>
+</para>
+
+<para
+>За його допомогою можна через скрипт наповнити проект з даними різними файлами і теками. Наступний скрипт, наприклад, створює новий проект з даними, додає до нього декілька тек і додає файли у новостворені теки: <programlisting
+>#!/bin/bash
+PROJECT=$(dcop k3b K3bInterface createDataCDProject)
+dcop $PROJECT createFolder test
+dcop $PROJECT createFolder foo
+dcop $PROJECT createFolder bar /foo
+dcop $PROJECT addUrl /home/trueg/якийсьфайл.txt /foo/bar
+</programlisting>
+
+</para>
+
+</sect1>
+</chapter>