Friday, 10 April 2020
 
 
Hogyan honosítsunk szöveget egy kiterjesztéshez tartozó help.html fájlban Print
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 )
 
 
Top! Top!