BabelZilla - Hogyan honosítsunk szöveget egy kiterjesztéshez tartozó help.html fájlban

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 )

[ Back ]