.dtd» []>
Номери
6. ВИБІР СТИЛЮ ДЛЯ ОПИСУ ДОКУМЕНТАЦІЇ
(eXtensible Stylesheet Language) - сімейство рекомендацій консорціуму W3C, що описує мови перетворення і візуалізації XML-документів. XSL Складається з трьох частин:
XSL Transformation (XSLT) - мова перетворення XML-документів;
XSL Formatting Objects (XSL-FO) - мова розмітки типографських макетів та інших предпечатном матеріалів;
XPath - мова шляхів і виразів, використовуваний в XSLT для доступу до окремих частин XML-документа.
За допомогою XSL можна трансформувати XML-документ в будь-який вид (HTML, WML, RTF, PDF, SQL і т. д.). XSL несе в собі інформацію про те, як буде оформлений документ, де і як будуть розташовуватися дані.
Для створення документації в даному проекті використовуються офіційні таблиці стилів для DocBook v4.4.
7. Створення фрагментів
Як вже говорилося вище, для забезпечення контролю версій розроблюваної документації використовується система Subversion та її графічна оболонка TortoiseSVN. Для початку роботи створимо робочу копію (малюнок 2, малюнок 3).
Далі необхідно додати в робочу копію заготовки технічної документації, описані в розділі 5. Скористаємося TortoiseSVN (малюнок 4, рисунок 5).
Малюнок 2 - Створення робочої копії
Рисунок 3 - Результат створення робочої копії
Малюнок 4 - Додавання заготовок фрагментів в робочу копію
Малюнок 5 - Результат додавання файлів в робочу копію
Тепер необхідно зафіксувати зміни (малюнок 6, рисунок 7).
Малюнок 6 - Фіксація змін, зроблених в робочій копії
Малюнок 7 - Результат виконання фіксації змін
При створенні документації використовуються також графічні файли, наприклад картинки, які також необхідно додати в робочу копію (малюнки 8,9).
Рисунок 8 - Фіксація змін до робочої копії
Рисунок 9 - Результат додавання картинки і фіксації змін
Далі необхідно приступити до редагування підготовлених заготовок фрагментів.
Розглянемо редагування фрагмента на прикладі редагування файлу overview.xml (загальні відомості) .
Для створення і редагування XML-файлів використовується простий текстовий редактор, здатний відображати синтаксис XML-документа, і візуальний редактор XML Syntext Serna. Інша назва візуальних редакторів - WYSIWYG (What You See Is What You Get) редактори. Це означає, що вміст відображається в процесі редагування і виглядає максимально близько схожим на кінцеву продукцію, яка може бути друкованим документом або веб-сторінкою. У Syntext Serna зовнішній вигляд документа контролюється за допомогою стилів XSLT / XSL-FO.
Рисунок 10 - Результат фіксації змін, зроблених у файлі overview.xml
