DITA Open Toolkit (DITA-OT) er opinn forritunarvél sem breytir DITA efni í ýmis úttaksform, þar á meðal HTML, PDF og fleiri. Með því að nýta DITA-OT er hægt að sérsníða úttakið til að uppfylla tiltekin skilyrði, sem er einn af mikilvægum kostum þess.
Í þessari grein verður farið yfir hvernig hægt er að sérsníða HTML og PDF úttak með einfaldri DITA-OT viðbót.
Skilningur á DITA-OT og úttaksformum
DITA (Darwin Information Typing Architecture) er öflugt XML-bundið byggingarkerfi fyrir skrif og stjórnun efnis. DITA-OT auðveldar ferlið við að búa til mismunandi tegundir af útgáfum úr DITA efni. Hvort sem þörf er á að búa til notendahandbækur, aðstoðarkerfi eða vefskjöl, þá hefur DITA-OT getu til að umbreyta upphaflegum skjölum í ýmis form.
Ástæður fyrir því að búa til viðbót
Með því að búa til sérsniðna viðbót er hægt að aðlaga úttakið að þörfum stofnunarinnar eða áhorfenda. Þetta getur falið í sér breytingar á útliti, viðbót sértækra metadata, breytingar á uppbyggingu eða samþætting auka virkni. Viðbætur geta hjálpað til við að einfalda vinnuferli og tryggja að efnið sé jafnan sniðið og birt samkvæmt tilteknum leiðbeiningum.
Skref-fyrir-skref leiðbeiningar um að búa til einfaldan DITA-OT viðbót
Skref 1: Setja upp umhverfið
Fyrst þarftu að tryggja að þú hafir DITA Open Toolkit uppsett á þínum staðbundna vélinni. Þú getur sótt nýjustu útgáfuna af heimasíðu DITA-OT. Þegar þú hefur sett það upp, kynnirðu þig í verkefnaskipulaginu. Helstu möppurnar eru:
- lib/: Inniheldur bókasöfn og háð.
- plugins/: Hér býrðu til þína sérsniðnu viðbót.
- src/: Þetta er uppsprettukóðinn fyrir umbreytingar.
- xsl/: Inniheldur skrár fyrir XSLT (Extensible Stylesheet Language Transformations).
Skref 2: Búa til viðbótina
Stofnaðu nýja möppu fyrir viðbótina þína. Fara í plugins/ möppuna og búa til nýja möppu, t.d. custom-html-pdf-plugin. Innan viðbótarmöppunnar skaltu búa til plugin.xml skrá. Þessi skrá lýsir viðbótinni þinni og virkni hennar.
Til að sérsníða HTML úttak, búa til möppu sem heitir xsl innan viðbótarmöppunnar. Innan þessarar möppu skaltu búa til XSLT skrá, eins og custom-html.xsl, þar sem þú getur breytt því hvernig HTML úttakið mun líta út.
Svipað skaltu búa til aðra XSLT skrá fyrir PDF sérsnið, t.d. custom-pdf.xsl, og framkvæma þær breytingar sem þú vilt á PDF útlitinu.
Skref 3: Byggja og prófa viðbótina
Til að byggja viðbótina skaltu fara í DITA-OT uppsetningarmöppuna og keyra eftirfarandi skipun: ant -Dplugin=custom-html-pdf-plugin. Þú getur prófað úttakið með DITA-OT til að búa til bæði HTML og PDF form.
Skref 4: Lokaskref og skjalagerð
Þegar þú hefur staðfest að viðbótin þín sé að framleiða óskað úttak, íhugaðu að skrifa skjal um viðbótina. Þetta ætti að innihalda leiðbeiningar um hvernig á að setja upp, stilla og nota viðbótina, sem hjálpar öðrum í stofnun þinni að skilja hvernig hægt er að samþætta hana í vinnuferli sínu.
Í lokin er að sérsníða HTML og PDF úttak með því að nota DITA Open Toolkit viðbót einfalt ferli sem getur aukið gildi skjala þinna. Með því að fylgja skrefunum í þessari grein geturðu búið til viðbót sem aðlaga úttakið að merkingu og virkni stofnunarinnar. Með sveigjanleika DITA-OT getur teymið þitt tryggt að skjöl séu notendavæn og sjónrænt aðlaðandi í öllum formum.
