i18n:n k\u00e4ytt\u00f6\u00f6notto teemassamme<\/h2>\n
Olemme jo tehneet ensimm\u00e4isen osan t\u00e4m\u00e4n teema-opetussarjan edellisess\u00e4 vaiheessa<\/a>, johon lis\u00e4simme Ensimm\u00e4inen argumentti on kahva, t\u00e4m\u00e4 on ainutlaatuinen merkkijono, jonka avulla voit ryhmitell\u00e4 kaikki teemaasi kuuluvat tekstit. Toistat t\u00e4m\u00e4n kahvan aina, kun teet tekstist\u00e4 k\u00e4\u00e4nnett\u00e4v\u00e4n. Toinen argumentti kertoo WordPressille, miss\u00e4 k\u00e4\u00e4nn\u00f6stiedostot ovat. M\u00e4\u00e4ritimme ne sijaitsemaan teemahakemistomme alikansiossa ’ \u00c4l\u00e4 huoli, jos t\u00e4t\u00e4 kansiota ei ole olemassa tai se ei sis\u00e4ll\u00e4 tiedostoja \u2013 mik\u00e4\u00e4n ei kaatu. Jos WordPress ei l\u00f6yd\u00e4 kansiota tai oikeita k\u00e4\u00e4nn\u00f6stiedostoja, se palaa oletuksena takaisin teemassa oleviin teksteihin.<\/p>\n Seuraava askel on k\u00e4yd\u00e4 l\u00e4pi koko koodimme ja l\u00f6yt\u00e4\u00e4 kaikki tekstitulosteet, joiden pit\u00e4isi olla k\u00e4\u00e4nnett\u00e4v\u00e4t. On hyv\u00e4 k\u00e4yt\u00e4nt\u00f6 varmistaa, ett\u00e4 katamme ehdottomasti kaikki tekstit. Mik\u00e4\u00e4n ei ole \u00e4rsytt\u00e4v\u00e4mp\u00e4\u00e4 kuin k\u00e4ytt\u00e4\u00e4 teemaa tai laajennusta, jossa kirjoittaja on koodannut tekstit, jotka tekev\u00e4t k\u00e4\u00e4nt\u00e4misen tai muuttamisen mahdottomaksi mill\u00e4\u00e4n tavalla.<\/p>\n Kaikilla teksteill\u00e4 laitamme ne johonkin WordPressin gettext-funktioista, jotka yleisimmin ovat WordPressiss\u00e4 on enemm\u00e4n gettext-toimintoja, jotka palvelevat tarkempia tarkoituksia, esimerkiksi Gettext-funktioissa on kaksi parametria; ensin itse teksti ja toiseksi kahva, jonka m\u00e4\u00e4ritit kohdassa Jos sinulla on esimerkiksi jotain t\u00e4m\u00e4n kaltaista:<\/p>\n Sinun on korvattava se seuraavalla:<\/p>\n Ja samalla tavalla muuttujaan tallentamiseen;<\/p>\n Se on kirjoitettava n\u00e4in:<\/p>\n Nyt meid\u00e4n on l\u00f6ydett\u00e4v\u00e4 kaikki tekstit malleistamme! Jos olet seurannut t\u00e4t\u00e4 opetusohjelmaa T-kirjaimeen, se ei ole montaa. Meill\u00e4 on jotkin merkkijonot sis\u00e4\u00e4n Aloitetaan Koska k\u00e4ytit, Sama teksti on meill\u00e4 T\u00e4st\u00e4 eteenp\u00e4in kaikki tekstit, jotka lis\u00e4\u00e4mme teemaomme, varmistamme, ett\u00e4 ne k\u00e4\u00e4rit\u00e4\u00e4n sis\u00e4\u00e4n On kaksi tapaa tarjota k\u00e4\u00e4nn\u00f6stiedostoja teemallesi;<\/p>\n Tiedostot Tarvitset ohjelman muokkaamiseen Lataa ja asenna PoEdit, jotta voit seurata opetusohjelman loppua.<\/p>\n Englanninkielisen k\u00e4\u00e4nn\u00f6stiedoston tekemisess\u00e4 ei yleens\u00e4 ole mit\u00e4\u00e4n j\u00e4rke\u00e4, kun kaikki teemamme tekstit ovat joka tapauksessa englantia, mutta t\u00e4t\u00e4 opetusohjelmaa varten teen englanninkielisen k\u00e4\u00e4nn\u00f6stiedoston.<\/p>\n 1 Avaa PoEdit ja napsauta Tiedosto > Uusi\u2026<\/p>\n 2 Sinua pyydet\u00e4\u00e4n valitsemaan kieli. Valitse haluamasi kieli, esimerkiksi englanti.<\/p>\n 3 Paina Tallenna (Ctrl+S). Etsi teemakansiosi ja siirry 4 Valitse valikosta Katalogi > Ominaisuudet\u2026<\/p>\n 5 Ensimm\u00e4iselle v\u00e4lilehdelle voit kirjoittaa joitakin tietoja, kuten projektin (teeman) nimen, tai vaihtaa kielt\u00e4 \u2013 mutta se ei ole v\u00e4ltt\u00e4m\u00e4t\u00f6nt\u00e4. Suosittelen, ett\u00e4 pid\u00e4t merkkisarjan UTF-8:ssa, koska kirjoitamme t\u00e4m\u00e4n WordPressille.<\/p>\n 6 Napsauta L\u00e4hteiden polut -v\u00e4lilehte\u00e4. T\u00e4ss\u00e4 sinun on m\u00e4\u00e4ritett\u00e4v\u00e4, mist\u00e4 kansioista tiedoston tulee etsi\u00e4 k\u00e4\u00e4nnett\u00e4v\u00e4\u00e4 teksti\u00e4. Polut ovat suhteellisia, ja koska olemme jo tallentaneet sen teemamme alikansioon, tied\u00e4mme, ett\u00e4 sen t\u00e4ytyy menn\u00e4 yksi hakemisto yl\u00f6sp\u00e4in. Paina +-painiketta Polut-ruudun alla ja valitse Lis\u00e4\u00e4 kansioita. Valitse teemahakemistosi. T\u00e4m\u00e4n pit\u00e4isi lis\u00e4t\u00e4 polkuelementti "." (siirry yksi kansio yl\u00f6sp\u00e4in). Tarkista, ett\u00e4 "Peruspolku" viittaa juuriteeman hakemistoon.<\/p>\n 7 Napsauta seuraavaa "L\u00e4hteet avainsanat" -v\u00e4lilehte\u00e4. T\u00e4ss\u00e4 sinun on kerrottava PoEditille, mit\u00e4 toimintoja olet k\u00e4ytt\u00e4nyt k\u00e4\u00e4nnett\u00e4v\u00e4lle tekstille (esimerkiksi load_theme_textdomain<\/code>teemamme asetustoiminnon. Jos unohdat, lis\u00e4simme t\u00e4m\u00e4n:<\/p>\nload_theme_textdomain('wptutorial', get_stylesheet_directory(). '\/lang');<\/code><\/pre>\nlang<\/code>’.<\/p>\nKuinka saada tekstit k\u00e4\u00e4nnett\u00e4v\u00e4ksi<\/h2>\n
_e()<\/code>tai __()<\/code>. Ensimm\u00e4inen on alaviiva, jossa on "e", jota k\u00e4ytet\u00e4\u00e4n, kun haluat toistaa teksti\u00e4 samanaikaisesti. Toinen on kaksi alaviivaa ja sit\u00e4 k\u00e4ytet\u00e4\u00e4n, kun et halua toistaa sit\u00e4, vaan tallentaa sen tai k\u00e4ytt\u00e4\u00e4 sit\u00e4 muuttujassa.<\/p>\nesc_html__()<\/code>, _n()<\/code>ja _x()<\/code>paljon muuta. Emme kuitenkaan mene yksityiskohtiin t\u00e4ss\u00e4 opetusohjelmassa.<\/p>\nload_theme_textdomain<\/code>. T\u00e4ss\u00e4 tapauksessa se on ’ wptutorial<\/code>’.<\/p>\necho 'Read more';<\/code><\/pre>\n_e('Read more', 'wptutorial');<\/code><\/pre>\n$myvariable = 'Read more';<\/code><\/pre>\n$myvariable = __('Read more', 'wptutorial');<\/code><\/pre>\nindex.php<\/code>ja osa sis\u00e4\u00e4n single.php<\/code>.<\/p>\nK\u00e4\u00e4nn\u00f6stuen lis\u00e4\u00e4minen teemaamme<\/h2>\n
index.php<\/code>ja etsit\u00e4\u00e4n "Ei viestej\u00e4, anteeksi" -viesti, jonka lis\u00e4simme, jos silmukka ei sis\u00e4lt\u00e4nyt viestej\u00e4. K\u00e4\u00e4rimme t\u00e4m\u00e4n tekstin sis\u00e4\u00e4n, _e()<\/code>koska haluamme silti toistaa sen. Joten t\u00e4m\u00e4n saamme:<\/p>\n...\n} else {\n ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n...<\/code><\/pre>\n_e()<\/code>sinun ei pit\u00e4isi n\u00e4hd\u00e4 muutosta, kun painat p\u00e4ivitt\u00e4\u00e4 etusivulla tai arkistossa. Mutta konepellin alla t\u00e4m\u00e4 teksti on nyt k\u00e4\u00e4nnett\u00e4v\u00e4!<\/p>\nsingle.php<\/code>ja page.php<\/code>. P\u00e4ivit\u00e4 n\u00e4m\u00e4 samalla tavalla kuin teimme vuonna index.php<\/code>. Lis\u00e4simme joitain tekstej\u00e4 sis\u00e4\u00e4n single.php<\/code>, joten t\u00e4lt\u00e4 se n\u00e4ytt\u00e4\u00e4, kun kaikki tekstit on k\u00e4\u00e4nnett\u00e4v\u00e4:<\/p>\n...\n <?php the_category(); ?>\n <p><?php _e('Posted', 'wptutorial'); ?>: <?php the_date(); ?> <?php _e('at', 'wptutorial'); ?> <?php the_time(); ?><\/p>\n <p><?php _e('Author', 'wptutorial'); ?>: <?php the_author(); ?><\/p>\n <\/article>\n <?php endwhile;\n} else {\n ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n\u00a0\n...<\/code><\/pre>\n__()<\/code>tai _e()<\/code>.<\/p>\nK\u00e4\u00e4nn\u00f6stiedostot<\/h2>\n
\n
.pot<\/code>-tiedosto<\/li>\n.po<\/code>ja .mo<\/code>tiedostot.<\/li>\n<\/ul>\n.pot<\/code>-tiedostoa suositellaan teemalle, jonka myyt tai annat muille k\u00e4ytt\u00e4jille, koska t\u00e4ll\u00e4 tiedostolla on eritt\u00e4in helppo luoda k\u00e4\u00e4nn\u00f6stiedosto uudelle kielelle. N\u00e4iden tiedostojen luominen ei kuitenkaan ole helppoa (tai ilmaista). Jos olet perehtynyt WP-CLI:hen (komentorivi WordPress) tai Grunt, voit seurata WordPressin dokumentaation ohjeita t\u00e4\u00e4lt\u00e4<\/a>. Jos ei, toinen vaihtoehto voi olla sinulle.<\/p>\n.po<\/code>ja .mo<\/code>ty\u00f6skennell\u00e4 yhdess\u00e4. WordPress vaatii .mo<\/code>tekstien k\u00e4\u00e4nt\u00e4miseen, mutta t\u00e4m\u00e4 tiedosto ei ole ihmisen luettavissa. Siksi meill\u00e4 on .po<\/code>tiedosto, joka on meille luettavissa. Oikealla ohjelmistolla se luo .mo<\/code>tiedoston aina, kun teet muutoksia.<\/p>\n.po<\/code>Tiedostojen ja -tiedoston haittana .mo<\/code>on, ett\u00e4 jokaiselle kielelle on luotava yksi pari, ja kun olet k\u00e4\u00e4nt\u00e4nyt sen jollekin kielelle, ei ole helppoa tapaa tyhjent\u00e4\u00e4 kaikkia k\u00e4\u00e4nn\u00f6ksi\u00e4 toisen uuden kielen tekemiseksi.<\/p>\n.pot<\/code>ja .po<\/code>tiedostoihin. Yleisin on PoEdit<\/a>. PoEdit on ilmainen ja toimii sek\u00e4 iOS:ss\u00e4 ett\u00e4 Windowsissa. Mutta jotkut lis\u00e4ominaisuudet (kuten .pot<\/code>-tiedoston luominen) vaativat valitettavasti maksullisen version. K\u00e4yt\u00e4mme ilmaista versiota .po<\/code>tiedoston tekemiseen teemallemme.<\/p>\n.po-tiedoston luominen teemallemme PoEditin avulla<\/h2>\n
\/lang\/<\/code>alikansioon. (Jos et luonut sit\u00e4 viimeisess\u00e4 vaiheessa, luo se nyt). Tiedostosi nimi on t\u00e4rke\u00e4. Teemoja varten se tulee nimet\u00e4 vain kielikoodisi. Amerikan englannin kielelle se olisi en_US<\/code>, norjalle se on nb_NO<\/code>. Googlettamalla se tai katso t\u00e4m\u00e4 yleiskatsaus<\/a> l\u00f6yt\u00e4\u00e4ksesi kielikoodisi. Nimet\u00e4\u00e4n se en_US.po<\/code>.<\/p>\n![\"WordPress-teeman](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69a10501.png\")
<\/a><\/p>\n![\"WordPress-teeman](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69b261fd.png\")
<\/a><\/p>\n__<\/code>, _e<\/code>, esc_html_e<\/code>ja niin edelleen). Napsauta +-painiketta lis\u00e4t\u00e4ksesi kunkin funktion ja kirjoita ne ilman "()". On sinun p\u00e4\u00e4tett\u00e4viss\u00e4si, haluatko kattaa kaikki perustasi ja lis\u00e4t\u00e4 kaikki WordPressin gettext-toiminnot, mutta t\u00e4ss\u00e4 opetusohjelmassa tied\u00e4mme, ett\u00e4 olemme k\u00e4ytt\u00e4neet vain kahta. Joten lis\u00e4\u00e4mme kaksi elementti\u00e4; __()<\/code>ja _e()<\/code>. Lis\u00e4\u00e4 funktiot ilman sulkuja.<\/p>\n
![\"WordPress-teeman](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69c29a5b.png\")
<\/a><\/p>\n![\"WordPress-teeman](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69d34b4a.png\")
<\/a><\/p>\n