DITA сідає на дієту Моя бесіда на щорічній конференції tekom 2018; ARAKANGA GmbH

Я прочитаю лекцію на щорічній конференції tekom 13-15 листопада 2018 року в Штутгарті. Якщо бути точнішим: 15 листопада (Четвер), перше, що відбувається вранці о 8:45 ранку в кімнаті С4.2.

сідає

Вас цікавить легкий DITA і що з ним можна зробити? Тоді я сподіваюся побачити вас!

Текст збірника матеріалів конференції:

DITA сідає на дієту - приєднуйтесь до нас!

Я хотів би представити концепцію побудови системи управління вмістом на основі легкої DITA самостійно - за допомогою недорогих інструментів. Для цього я піду в наступні пункти:

  • Що таке легкий DITA?
  • Які переваги та обмеження полегшеного DITA?
  • Ви можете використовувати його, щоб зібрати гнучке редакторське середовище із стандартних інструментів, замість того, щоб покладатися на монолітну CMS?

Відправна точка 1: ринкові тенденції

У галузі технічної документації та редакційного середовища існують дві протилежні тенденції:

З одного боку, стандарти з часом стають дедалі складнішими, напр. Б. ДІТА. Це зросло з майже 200 елементів, коли версія 1.0 вийшла до понад 600 елементів у версії 1.3. З іншого боку, завжди є зустрічні рухи. Як і 20 років тому, коли надзвичайно складний SGML отримав подальший розвиток у значно простіший XML.

Той самий розвиток відбувається також у DITA, де прагнення спрощення призвело до нового легкого стандарту DITA. Тепер він містить трохи менше 50 елементів і відкриває абсолютно нові групи користувачів із додатковими форматами HTML та Markdown.

Маркування та інші так звані мови "легкої розмітки" - ще одна тенденція, особливо в документації на програмне забезпечення, яка значно зменшує перешкоди для створення якісної документації.

Що таке легкий DITA?

У квітні 2018 року була прийнята перша остаточна версія 1.0 полегшеної DITA. Основними властивостями легкої DITA є:

  • Залишилося лише 48 елементів (замість понад 600 із DITA 1.3)
  • 3 формати даних, крім XML (= XDITA), тепер існують також HTML (= HDITA) та Markdown (= MDITA)
  • Нові мультимедійні елементи
  • Спеціалізація все ще можлива, як у DITA
  • Все-таки ДІТА

Велике спрощення, природно, означає, що полегшені DITA більш обмежені у своїх можливостях, ніж DITA. Наприклад, більше не існує жодних типів інформації та семантичного форматування. Загалом, легкий DITA, безумовно, менш придатний для більш складних вимог.

Нові формати та значне спрощення відкривають абсолютно нові можливості. Легкий DITA має можливість поєднати світ “великих” та складних (і дорогих) систем управління вмістом з повною підтримкою DITA зі світом набагато простішого створення та розповсюдження вмісту в галузі Інтернет-довідки для програмних продуктів.

Вихідний пункт 2: визначення проблеми в компанії

Уявіть, що ви несете відповідальність за документацію продуктової галузі у глобальній інтернет-компанії. Ваша невеличка команда розкидана по всьому світу і має обмежені фінансові та часові ресурси. Кілька придбань за останні кілька років призвели до різнобарвного портфоліо процесів та інструментів для створення та публікації. І з точки зору замовника, існує дуже різна документація, яку можна знайти за різними URL-адресами.

Ваша робота зараз - це закріпити. Ви маєте на увазі рішення, яке підходить для всіх. Вимоги такі:

  • Повинна бути можлива глобальна співпраця, бажано через Інтернет.
  • Рішення повинно бути гнучким, незалежним від операційної системи та браузера.
  • Рішення має бути адаптоване до конкретної ситуації, але воно має бути адаптованим та розширюваним у майбутньому.
  • Ви хочете працювати з недорогими та широко використовуваними інструментами, які можуть бути індивідуально адаптовані з відносно невеликими зусиллями.
  • Ви хочете використовувати стандарти, щоб у майбутньому вам не довелося покладатися на певне фірмове програмне забезпечення. Це також полегшує обмін даними між різними інструментами.

У мене була ідея.

Ідея: Створіть своє власне середовище на основі легкої DITA!

З урахуванням вимог та нового, захоплюючого легкого стандарту DITA, тепер можна розробити «архітектуру» для редакційного середовища. Необхідний принаймні один спосіб збереження файлів, редактор та середовище публікації:

І ви не прив’язані до конкретного виробника для інших завдань. Вміст у LwDITA легко експортувати, легко конвертувати, легко використовувати повторно тощо:

  • Огляд: Інструменти зі сховищ вмісту можна використовувати для запусків корекції. Або ви можете створювати документи PDF або редаговані формати з вихідних файлів.
  • Переклад: Кожна загальна система пам'яті перекладів може обробляти файли у форматі XML, HTML або текстовому форматі, наприклад Markdown.
  • термінологія
  • Перетворення
  • І т. Д.

Залиште коментар скасувати відповідь

Ви повинні увійти в систему, щоб залишити коментар.