Dokumentumok előkészítése xml sablonok segítségével a fejlesztői munkákból

Szeretnél Word sablonokat vagy OpenDocument-ot használni XML sablonok helyett?

Első lépések

Minden anyag megjelent a developerWorksön HTML formátumban, de kezdetben létre, az XML dokumentumok (Extensible Markup Language). Közzététele előtt XML-tartalom minden anyagot ellenőrizni a szabályok betartásának a jelölés előre meghatározott séma developerWorks, és úgy alakítjuk át HTML-oldalak XSLT (Extensible Stylesheet Language for transzformációk). Egy ilyen szétválasztása cikkeket a jellemzői a design segít, hogy automatizálják a vezetés a nagy developerWorksön.

Az általunk kínált anyagkészítési eljárások egyike sem igényel speciális készségeket. Ha korábban már foglalkozott az XML vagy a HTML használatával, akkor ne legyen gondja a sablonok használatával. Ellenkező esetben megismerheti az XML-t, olvassa el az alábbi anyagok elkészítéséhez szükséges tippeket, és olvassa el a developerWorks XML developerWorks oldalát is.

Alapvető lépések

Saját anyag létrehozásához kövesse az alábbi lépéseket:

Töltse le a file author-package zip-t, és mentse el a kívánt könyvtárba (például C: \ Windows alatt vagy a Linux otthoni könyvtárában) és vegye ki a programot.

Ha Linux alatt dolgozik, akkor le kell töltenie az IBM Developer Kit for Java programot (lásd az Erőforrások részt). Célszerű telepíteni a / opt / ibm, bár, ha nem rendelkezik rendszergazdai jogosultságokkal, akkor is töltse le a tar-fájlt, és telepítse a saját könyvtárban. Az XML-hitelesítési eszközök csak a Xalanra kiterjedő Java platformokon működnek (a Xalan 2.7 a Java 5.0-ben szerepel). További információ: Az XML Validation Tools használata a developerWorks alkalmazásból. .

Az archívum kicsomagolása után meg kell jelennie a fejlesztõi könyvtárban, amely a következõ könyvtárakat tartalmazza:

Verzióinformációk

Mielőtt elkezdené a következő lépést, elmondjuk, mi változott a legújabb verziókban.

2. lépés: Hozzon létre egy új sablont

Amikor a Microsoft Windows rendszerrel dolgozik

Egy cikk létrehozásához menjen a developerworks könyvtárba, és futtassa az új-article.vbs szkriptet. Megadhatja az érvényes címtárnevet saját belátása szerint. Alapértelmezés szerint a my-article könyvtárat használják.

1. ábra Új cikk létrehozása és elnevezése a Windows rendszerben

Kattintson az OK gombra. el kell látni egy új könyvtárat a developerworks könyvtárba (ez lehet, hogy frissítenie kell a mappák listáját, válasszuk (Nézet> Frissítés) a menüből. Ez tartalmazza a cikk sablont (a index.xml fájl), valamint az ellenőrzés és a konverziós script HTML (dw fájl -transform.vbs).

Amikor Linux alatt dolgozik

Futtassa az új-article.sh szkriptet a developerworks könyvtárban. (Ha már telepítve van a GNOME vagy KDE héj, a szkriptek lehívhatók keresztül grafikus menedzser, mint a Nautilus vagy a Konqueror. Ellenkező esetben kövesse őket a parancsértelmező.) Ebben az esetben, akkor megjelenik egy párbeszédablak, amelyben felkérik, hogy adjon meg egy nevet a projekt. Kiválaszthatja saját belátása szerint. Az alapértelmezett név az én-cikkem.

Az OK (vagy az Enter megnyomásával) kiválasztásával új könyvtárat kell létrehoznia a fejlesztői munkákban. Ez tartalmazza a cikk (file index.xml) sablon és script ellenőrzés és átalakítása HTML (File dw-transform.sh).

Megjegyzés. Ha grafikus környezetet (GNOME vagy KDE) használ, akkor szüksége lesz zenityre, gdialogra vagy kdialogra. Más esetekben elegendő lesz a párbeszédpanel.

3. lépés: XML szerkesztése és ellenőrzése

Az anyag XML formátumban történő szerkesztéséhez és érvényesítéséhez két fő módja van.

Tippek sablonok szerkesztésére

Az XML-vel dolgozó kezdőknek

• Szerkesztés a Microsoft Word vagy az OpenDocument programban?

Az XML helyett Word és OpenDocument dokumentum sablonokat használhat. Részletes utasításokat a Dokumentumok előkészítése a Word és az OpenDocument sablonok segítségével a developerWorks alkalmazásból.

Ezenkívül XML fájlokból XML formátumú szövegeket is átmásolhat.

• A cikksablonban két különböző elem található a programkóddal való együttműködéshez: és . Elem használata A példakód elkülönítése a környező szövegből. Ha parancsot szeretne elhelyezni a bekezdés szövegében (a beépített kódot), használja az elemet .
• Az egy listázási sor hossza nem haladhatja meg a 105 karaktert. figyelembe véve a hiányosságokat. A sablon tartalmaz egy vonalzó mintát, amely segít Önnek ennek a követelménynek.
• A lista maximális mérete 100 sor. figyelembe véve az üres sorokat.