DITA преминава на диета Моят разговор на годишната конференция на tekom 2018; ARAKANGA GmbH

Ще изнеса лекция на годишната конференция на tekom от 13 до 15 ноември 2018 г. в Щутгарт. За да бъдем по-точни: На 15 ноември (Четвъртък), първо нещо сутрин в 8:45 сутринта в стая C4.2.

преминава

Интересувате ли се от лека DITA и какво можете да направите с нея? Тогава се надявам да се видим!

Текстът на доклада на конференцията следва:

DITA се подлага на диета - присъединете се към нас!

Бих искал да представя концепция за самостоятелно изграждане на система за управление на съдържанието, базирана на лека DITA - с помощта на евтини инструменти. За това ще навляза в следните точки:

  • Какво е лека DITA?
  • Какви са предимствата и ограниченията на лека DITA?
  • Можете ли сами да съберете гъвкава редакторска среда от стандартни инструменти, вместо да се налага да разчитате на монолитна CMS?

Отправна точка 1: пазарни тенденции

Има две противоположни тенденции в областта на техническата документация и редакционната среда:

От една страна, стандартите с времето стават все по-сложни, напр. Б. ДИТА. Това е нараснало от почти 200 елемента, когато версия 1.0 беше пусната, до над 600 елемента във версия 1.3. От друга страна винаги има контрадвижения. Както преди 20 години, когато изключително сложният SGML беше доразвит в много по-опростен XML.

Същото развитие се случва и в DITA, където новият олекотен стандарт DITA възниква от желанието за опростяване. Сега това включва малко под 50 елемента и отваря напълно нови потребителски групи с HTML и Markdown като допълнителни формати.

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 има потенциала да комбинира света на „големите“ и сложни (и скъпи) системи за управление на съдържанието с пълна DITA поддръжка със света на много по-опростено създаване и разпространение на съдържание в областта на онлайн помощта за софтуерни продукти.

Отправна точка 2: определяне на проблема във фирмата

Представете си, че сте отговорни за документирането на продуктова област в глобална интернет компания. Вашият малък екип е разпръснат по целия свят и разполага с ограничени финансови и времеви ресурси. Няколко придобивания през последните няколко години доведоха до пъстро портфолио от процеси и инструменти за създаване и публикуване. И от гледна точка на клиента има много различна документация, която може да бъде намерена под различни URL адреси.

Вашата работа сега е да консолидирате това. Имате предвид решение, което работи за всички. Изискванията са както следва:

  • Трябва да е възможно глобално сътрудничество, за предпочитане базирано на уеб.
  • Решението трябва да бъде гъвкаво, независимо от операционната система и браузъра.
  • Решението трябва да бъде съобразено с конкретната ситуация, но трябва да бъде адаптивно и разширяемо в бъдеще.
  • Искате да работите с евтини и широко използвани инструменти, които могат да бъдат персонализирани с относително малко усилия.
  • Искате да използвате стандарти, за да не се налага да разчитате на определен патентован софтуер в бъдеще. Освен това ви улеснява обмена на данни между различни инструменти.

Имах идея.

Идея: Изградете своя собствена среда, базирана на лека DITA!

С изискванията и новия, вълнуващ лек стандарт DITA, вече е възможно да се проектира „архитектура“ за редакционна среда. Необходим е поне един начин за запазване на файловете, редактор и среда за публикация:

И вие не сте обвързани с конкретен производител за други задачи. Съдържанието в LwDITA е лесно за експортиране, лесно за конвертиране, лесно за повторно използване и т.н.:

  • Преглед: Инструменти от хранилищата на съдържанието могат да се използват за корекции. Или можете да генерирате PDF документи или редактируеми формати от изходните файлове.
  • Превод: Всяка обща система за памет за преводи може да обработва файлове в XML, HTML или текстов формат като Markdown.
  • терминология
  • Преобразувания
  • И т.н.

Оставете коментар отмяна отговор

Трябва да сте влезли, за да оставите коментар.