DITA continuă o dietă Discursul meu la conferința anuală tekom 2018; ARAKANGA GmbH

La conferința anuală tekom din 13-15 noiembrie 2018 la Stuttgart, voi susține o prelegere de specialitate. Mai exact: pe 15 noiembrie (Joi), primul lucru dimineața la 8:45 în camera C4.2.

conferința

Sunteți interesat de Lightweight DITA și ce puteți face cu el? Atunci sper să te văd!

Urmează textul pentru lucrările conferinței:

DITA continuă o dietă - alătură-te nouă!

Aș dori să vă prezint un concept pentru a construi un sistem de gestionare a conținutului bazat pe Lightweight DITA - cu ajutorul unor instrumente ieftine. Pentru aceasta, voi intra în următoarele puncte:

  • Ce este Lightita DITA?
  • Care sunt avantajele și limitele Lightweight DITA?
  • Puteți să-l utilizați pentru a crea un mediu editorial flexibil din instrumentele standard, în loc să vă bazați pe un CMS monolitic?

Punctul de plecare 1: tendințele pieței

Există două tendințe opuse în domeniul documentației tehnice și al mediului editorial:

Pe de o parte, standardele devin din ce în ce mai complexe în timp, de ex. B. DITA. Aceasta a crescut de la aproape 200 de elemente când versiunea 1.0 a fost lansată la peste 600 de elemente în versiunea 1.3. Pe de altă parte, există întotdeauna contra-mișcări. Ca acum 20 de ani, când enormul complex SGML a fost dezvoltat în continuare într-un XML mult mai simplu.

Aceeași dezvoltare are loc și la DITA, unde a apărut dorința de a simplifica noul standard ușor DITA. Aceasta cuprinde acum sub 50 de elemente și deschide grupuri de utilizatori complet noi cu HTML și Markdown ca formate suplimentare.

Markdown și alte așa-numite limbaje de „markup ușor” sunt o altă tendință, în special în documentația software, care reduce semnificativ obstacolele pentru crearea unei documentații bune.

Ce este Lightita DITA?

În aprilie 2018, a fost adoptată prima versiune finală 1.0 a Lightweight DITA. Principalele proprietăți ale DITA ușoare sunt:

  • Au mai rămas doar 48 de elemente (în loc de peste 600 cu DITA 1.3)
  • 3 formate de date, pe lângă XML (= XDITA) există acum și HTML (= HDITA) și Markdown (= MDITA)
  • Elemente multimedia noi
  • Specializarea este încă posibilă ca în DITA
  • Încă DITA

Marea simplificare înseamnă în mod natural că DITA ușor este mai limitat în posibilitățile sale decât DITA. De exemplu, nu mai există niciun tip de informații și nici o formatare semantică. În general, DITA ușor este cu siguranță mai puțin potrivit pentru cerințe mai complexe.

Noile formate și simplificarea semnificativă deschid oportunități complet noi. DITA ușor are potențialul de a combina lumea sistemelor de gestionare a conținutului „mari” și complexe (și costisitoare) cu suport DITA complet cu lumea creației și distribuției mult mai simple a conținutului în domeniul ajutorului online pentru produsele software.

Punctul de plecare 2: definirea problemei în companie

Imaginați-vă că sunteți responsabil pentru documentarea unei zone de produs într-o companie globală de internet. Echipa ta mică este răspândită în întreaga lume și are resurse financiare și de timp limitate. Mai multe achiziții din ultimii ani au dus la un portofoliu diversificat de procese și instrumente pentru creare și publicare. Și din punctul de vedere al clientului, există o documentație foarte diferită, care poate fi găsită sub diferite adrese URL.

Treaba ta acum este să consolidezi acest lucru. Aveți în minte o soluție care funcționează pentru toată lumea. Cerințele sunt după cum urmează:

  • Colaborarea globală trebuie să fie posibilă, de preferință pe web.
  • Soluția trebuie să fie flexibilă, independentă de sistemul de operare și browser.
  • Soluția ar trebui să fie adaptată la situația specifică, dar ar trebui să fie adaptabilă și extensibilă în viitor.
  • Doriți să lucrați cu instrumente ieftine și utilizate pe scară largă, care pot fi adaptate individual cu un efort relativ mic.
  • Doriți să utilizați standarde, astfel încât să nu vă bazați pe anumite programe software proprietar în viitor. De asemenea, vă facilitează schimbul de date între diferite instrumente.

Am avut o idee.

Ideea: Construiește-ți propriul mediu bazat pe DITA ușor!

Cu cerințele și noul standard DITA ușor și captivant, este acum posibil să proiectăm o „arhitectură” pentru un mediu editorial. Sunt necesare cel puțin o modalitate de a salva fișierele, un editor și un mediu de publicare:

Și nici nu sunteți legat de un producător specific pentru alte sarcini. Conținutul din LwDITA este ușor de exportat, ușor de convertit, ușor de reutilizat etc.:

  • Revizuire: instrumentele din depozitele de conținut pot fi utilizate pentru corecții. Sau puteți genera documente PDF sau formate editabile din fișierele sursă.
  • Traducere: Fiecare sistem comun de memorie de traducere poate procesa fișiere în XML, HTML sau într-un format text, cum ar fi Markdown.
  • terminologie
  • Conversii
  • Etc.

Lasă un comentariu anulează răspunsul

Trebuie să fiți conectat pentru a lăsa un comentariu.