|
Hogyan honosÃtsunk szöveget egy kiterjesztéshez tartozó help.html fájlban |
|
|
Written by Cashman
|
|
Wednesday, 27 June 2007 |
Szöveg honosítása a help.html fájlban
Ha ezeket a sorokat olvassa, Ön egy olyan fejlesztÅ‘, aki dokumentálta a kiterjesztését. Ez egy hasznos dolog, amellyel érthetÅ‘bbé teheti kiterjesztését. Tehát van egy help.html vagy howto.html fájl csatolva kiterjesztéséhez. Tételezzük fel, hogy a nyelvi mappában található, így a fordítók világszerte hozzáférhetnek és dolgozhatnak vele.
Ezek után a probléma a következÅ‘:
- a help.html fájl az összes nyelvi mappában nagyobb méretűvé teszik kiterjesztését (a BabelZilla-n több olyan kiterjesztés található, melyet több mint 25 nyelvre fordítottak)
- a fordítók nem fejlesztÅ‘k, így tehát elképzelhetetlen, hogy a html kódolás ismert mindegyikük számára. Kódolási hibák léphetnek fel egy-egy html fájl szerkesztése közben.
Lehetséges megoldás:
- az html fájlból egy help.xhtml fájl kialakítása és a 'content' mappába helyezése
- Az xhtml fájlvalamennyi szövegének entitásokká alakítása és elhelyezése a locale/help.dtd fájlba
Nézzük, hogy tehetjük ezt meg. Tesztelésünkhöz nézzük Roman Mashirov outliner kiterjesztését.
ElÅ‘ször, készítsünk egy help.dtd fájtl vagy használjunk egy már meglévÅ‘ .dtd fájlt a honosítások mappából ( helyezzük át a .html fájlt a 'content' mappába. Folytassuk a következÅ‘kkel:
Make a xhtml file out of a html one
Töröljön ki mindent a <head> elÅ‘tt és másolja be a helyére a következÅ‘ket:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" [ <!ENTITY % helpDTD SYSTEM "chrome://outliner/locale/help.dtd" > %helpDTD; ]> <html xmlns="http://www.w3.org/1999/xhtml"> | természetesen, bemásolhatja saját kiterjesztésének, dtd fájljának nevét, amennyiben óhajtja.
Az ENTITY rész fontos, mert álatala ismeri fel a kiterjesztés, hogy hol találhatóak a honosított szövegek |
Szövegek átalakítása honosítható entitásokká Ugyanaz a teendÅ‘, mint a szövegek áthelyezésekor (content/*.xul --> locale/*.dtd). Minden esetben, ha felhasználói üzenetet használ:
1. Használjon entitást.
| Például ez helyett: | |
írja ezt: | <h1>Outliner Help</h1>
<p>This is Outliner extension for Mozilla, or at least some day it will be.
For now this is just notekeeper with notes arranged in tree.</p>
| | <h1>&page.title;</h1>
<p>&this.is.outliner;</p> |
2. Helyezze az entitást és az üzenetet a dtd fájlba <!ENTITY page.title "Outliner Help">
<!ENTITY this.is.outliner "This is Outliner extension for Mozilla, or at least some day it will be.
For now this is just notekeeper with notes arranged in tree."> |
Tegyen néhány bÅ‘vítést - ne felejtse el módosítani az áthelyezett SÚGÓ fájl útvonalát (általában a .js fájlban)
chrome://outliner/locale/help.html ---> chrome://outliner/content/help.xhtml
- amennyiben képet, javascriptet vagy css stílust is csatolt, véltoztassa meg azok útvonalát is.
- az xhtml szintaxis címkéi több odafigyelést igényelnek. Figyeljen azok bezárására, ellenkezÅ‘ esetben hibaüzenetet kaphat.
- a jobb olvashatóság és kinézet érdekében több szóközt is elhelyezhet.
- amennyiben több információra lenne szüksége, megtalálhatja azt a tesztelt outliner kiterjesztés eredeti illetve módosított változatánál.
|
|
Last Updated ( Thursday, 28 June 2007 )
|
Working...
