|
Ako v rozÅ¡Ãrenà lokalizovaÅ¥ reÅ¥azce súboru help.html |
|
|
Written by SlovakSoft
|
|
Saturday, 30 June 2007 |
Ako v rozšírení lokalizovaÅ¥ reÅ¥azce súboru help.htmlAk Äítate tento tutoriál, ste vývojár zasluhujúci si uznanie, pretože vaše rozšírenie obsahuje dokumentáciu. Je to veľmi dobrý nápad, ak chcete svoje rozšírenie urobiÅ¥ pre používateľov komfortnejšie.
Takže vo svojom rozšírení máte súbor help.html alebo howto.html. Predpokladajme, že sa tento súbor nachádza v prieÄinku locale, takže sa prekladatelia môžu pustiÅ¥ do svojej práce a rozšíriÅ¥ to do sveta.
Problém je, že:
- Súbor help.html umiestnený do každého jazykového podprieÄinka rozšírenie zväÄšuje (zoberte do úvahy, že na BabelZille máme niekoľko rozšírení až s 25 jazykmi).
- Prekladatelia nie sú vývojári, takže prechádzanie kódom HTML pre nich nie je niÄ príjemné. KľuÄkujú medzi tagmi a atribútmi a hľadajú reÅ¥azce na preklad. Pri úprave dokumentu vo formáte HTML môže navyše dôjsÅ¥ k chybám v kódovaní.
Riešením môže byÅ¥: - PreveÄte svoje súbory HTML na jeden súbor help.xhtml a presuňte ho do prieÄinka content.
- Vytvorte entity pre všetky reÅ¥azce súboru XHTML a umiestnite ich do súboru locale/help.dtd.
Teraz sa pozrieme, ako to urobiÅ¥. Ako testovací prípad sme si zobrali návrh rozšírenia, ktoré vytvoril Roman Mashirov.
Najprv vytvorte súbor help.dtd alebo použite v prieÄinku locale už existujúci súbor DTD a presuňte súbor HTML do prieÄinka content. Potom postupujte podľa týchto jednoduchých krokov:
Vytvorte zo súboru HTML súbor XHTML.
Odstráňte všetko pred tagom <head> a prilepte namiesto toho tento kód:
<?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"> | Mimochodom, môžete vložiÅ¥ názov svojho rozšírenia a názov súboru DTD.
ÄŒasÅ¥ ENTITY je dôležitá, pretože ukazuje rozšíreniu, kde má hľadaÅ¥ reÅ¥azce. |
Pretvorte reÅ¥azce do lokalizovateľných entít. Je to rovnaký proces, ako pri presúvaní reÅ¥azcov zo súboru content/*.xul do prieÄinka locale/*.dtd. Vždy, keÄ ide o hlásenie z používateľského prostredia:
1. Použite namiesto toho entitu.
| Ak máte napríklad toto: | |
Napíšte jednoducho toto: | <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. Umiestnite entitu a hlásenie do súboru DTD. <!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."> |
Urobte urÄité úpravy:Nezabudnite upraviÅ¥ cestu k súboru Pomocníka všade, kde sa na neho odkazuje (zvyÄajne v súbore .JS). chrome://outliner/locale/help.html ---> chrome://outliner/content/help.xhtml
- Ak odkazujete vo svojom dokumente na obrázky, JavaScript alebo CSS, tiež skontrolujte novú cestu.
- Syntax XHTML je nároÄnejšia na tagy. Skontrolujte každý uzatvorený tag, najmä ak sa vyskytne chyba analýzy.
- Môžete pridaÅ¥ nejaké tvrdé medzery a dosiahnuÅ¥ tak lepšie rozloženie.
- Ak potrebujete Äalšiu pomoc, pozrite pôvodný návrh rozšírenia a upravené rozšírenie.
...A je to hotové. Blahoželáme!  Tutoriál napísal Goofy
|
|
Last Updated ( Tuesday, 03 July 2007 )
|
Working...
