Pregătirea documentelor utilizând șabloane xml din dezvoltatori

Doriți să utilizați șabloane Word sau OpenDocument în locul șabloanelor XML?

Noțiuni de bază

Toate materialele sunt publicate pe developerWorks în format HTML, dar sunt inițial create ca documente XML (Extensible Markup Language). Înainte de publicare, conținutul XML al fiecărui material este verificat în raport cu regulile de marcare definite de schema developerWorks și apoi convertit în HTML utilizând paginile XSLT (Extensible Stylesheet Language for Transformations). Această separare a conținutului articolelor de caracteristicile designului acestora ne ajută să automatizăm gestionarea unui site mare de dezvoltatoriWorks.

Nici una dintre procedurile de pregătire materială pe care le oferim nu necesită aptitudini speciale. Dacă ați avut anterior de a face cu XML sau HTML, atunci nu ar trebui să aibă dificultăți în utilizarea șabloanelor. În caz contrar, puteți să vă familiarizați cu XML, să citiți sfaturile pentru pregătirea materialelor de mai jos și să consultați pagina dezvoltatoruluiWorks XML de pe dezvoltatorWorks.

Pașii de bază

Pentru a vă crea propriul material, urmați acești pași:

Descărcați fișierul author-package zip salvați-l în directorul dorit (de exemplu, în C: \ în Windows sau în directorul home din Linux) și dezarhivați.

Când lucrați cu Linux, trebuie să descărcați și IBM Developer Kit pentru Java (consultați secțiunea Resurse). Este de dorit să îl instalați în directorul / opt / ibm, deși dacă nu aveți privilegii administrative, puteți descărca și arhiva tar și instalați-o în directorul de domiciliu. Instrumentele de validare XML funcționează numai pe platformele Java care includ Xalan (Xalan 2.7 este inclus în Java 5.0). Pentru mai multe informații, consultați Utilizarea instrumentelor de validare XML din developerWorks. .

După despachetarea arhivei, ar trebui să vedeți directorul dezvoltator care conține următoarele directoare pentru copii:

Informații despre versiune

Înainte de a trece la următorul pas, vom discuta despre ce sa schimbat în cele mai recente versiuni.

Pasul 2. Creați un nou șablon

Când lucrați cu Microsoft Windows

Pentru a crea un articol, accesați directorul dezvoltator și rulați scriptul new-article.vbs. Puteți să specificați orice nume de director valabil la discreția dvs. În mod implicit, se folosește directorul meu de articol.

Figura 1. Crearea și denumirea unui articol nou în Windows

Faceți clic pe OK. ar trebui să vedeți un nou director în directorul developerWorks (pentru acest lucru poate fi necesar pentru a actualiza lista de dosare, selectați (Vizualizare> Reîmprospătare) din meniu. Acesta conține șablonul de articol (fișierul index.xml), precum și de verificare și de conversie script în HTML (fișier dw -transform.vbs).

Când lucrați cu Linux

Rulați scriptul new-article.sh din directorul dezvoltatorilor. (Dacă ați instalat sau GNOME shell KDE, scripturile pot fi apelate prin intermediul unui manager de grafic, cum ar fi Nautilus sau Konqueror. În caz contrar, urmați-le prin intermediul interpretului de comandă.) În acest caz, veți vedea o casetă de dialog, care se va cere să introduceți un nume pentru proiect. Puteți alege acest lucru la discreția dvs. Numele implicit este articolul meu.

Selectând OK (sau apăsând Enter), ar trebui să vedeți un nou director în interiorul dezvoltatorilor. Acesta conține un șablon pentru articolul dvs. (fișier index.xml), precum și un script pentru verificarea și conversia în HTML (fișier dw-transform.sh).

Notă. Dacă utilizați un mediu grafic (GNOME sau KDE), veți avea nevoie de zenitate, gdialog sau kdialog. În alte cazuri, pachetul de dialog va fi suficient.

Pasul 3. Editare și verificare XML

Există două modalități principale de a edita și de a valida materialul dvs. în format XML.

Sfaturi pentru editarea șabloanelor

Pentru incepatori care lucreaza cu XML

• Editarea în Microsoft Word sau OpenDocument?

În loc de XML, puteți utiliza șabloane de documente Word și OpenDocument. Pentru instrucțiuni detaliate, consultați Pregătirea documentelor utilizând șabloanele Word și OpenDocument din developerWorks.

În plus, puteți copia text din fișiere XML în șablon XML.

• În șablonul articol există două elemente diferite pentru a lucra cu codul programului: și . Utilizați elementul Pentru a separa exemplul de cod de textul din jur. Dacă doriți să introduceți o comandă în interiorul textului paragrafului (codul încorporat), utilizați elementul .
• Lungimea unei linii de listare nu trebuie să depășească 105 de caractere. luând în considerare decalajele. Șablonul conține un eșantion cu o riglă care vă va ajuta să rezistați acestei cerințe.
• Dimensiunea maximă de listare este de 100 de linii. luând în considerare liniile goale.