Impl\u00e9menter i18n dans notre th\u00e8me<\/h2>\n
Nous avons d\u00e9j\u00e0 fait la premi\u00e8re partie de l’ \u00e9tape pr\u00e9c\u00e9dente<\/a> de cette s\u00e9rie de didacticiels sur le th\u00e8me, o\u00f9 nous avons ajout\u00e9 Le premier argument est le handle, il s’agit d’une cha\u00eene unique que vous utiliserez pour regrouper tous les textes appartenant \u00e0 votre th\u00e8me. Vous r\u00e9p\u00e9terez cette poign\u00e9e chaque fois que vous rendrez un texte traduisible. Le deuxi\u00e8me argument indique \u00e0 WordPress o\u00f9 se trouvent les fichiers de traduction. Nous les avons d\u00e9finis pour qu’ils r\u00e9sident dans un sous-dossier ‘ Ne vous inqui\u00e9tez pas si ce dossier n’existe pas ou ne contient aucun fichier – rien ne plantera. Si WordPress ne trouve pas le dossier ni les fichiers de traduction corrects, il reviendra par d\u00e9faut aux textes que nous avons dans le th\u00e8me.<\/p>\n La prochaine \u00e9tape consiste \u00e0 parcourir tout notre code et \u00e0 trouver toute sortie de texte qui devrait \u00eatre traduisible. C’est une bonne pratique de s’assurer que nous couvrons absolument tous les textes. Rien n’est plus ennuyeux que d’utiliser un th\u00e8me ou un plugin o\u00f9 l’auteur a cod\u00e9 en dur des textes rendant impossible la traduction ou la modification de quelque mani\u00e8re que ce soit.<\/p>\n Ce que nous faisons avec tous les textes, c’est de les placer dans l’une des fonctions gettext de WordPress, qui sont le plus souvent WordPress a plus de fonctions gettext qui servent \u00e0 des fins plus sp\u00e9cifiques, par exemple, Les fonctions gettext prennent deux param\u00e8tres ; d’abord le texte lui-m\u00eame, et deuxi\u00e8mement la poign\u00e9e que vous avez d\u00e9finie dans Par exemple, si vous avez quelque chose comme \u00e7a :<\/p>\n Vous devrez le remplacer par :<\/p>\n Et de m\u00eame pour le stockage dans une variable\u00a0;<\/p>\n Il doit \u00eatre \u00e9crit comme ceci :<\/p>\n Maintenant, nous devons trouver tous les textes dans nos mod\u00e8les\u00a0! Si vous avez suivi ce tutoriel jusqu’\u00e0 un "T" ce n’est pas beaucoup. Nous avons des cha\u00eenes dans Commen\u00e7ons par Parce que vous avez utilis\u00e9 Nous avons ce m\u00eame texte dans nos \u00c0 partir de maintenant, tous les textes que nous ajoutons dans notre th\u00e8me, nous nous assurons de les envelopper \u00e0 l’int\u00e9rieur Il existe deux fa\u00e7ons de fournir des fichiers de traduction \u00e0 votre th\u00e8me\u00a0;<\/p>\n Le Les fichiers L’inconv\u00e9nient des fichiers Vous avez besoin d’un programme pour \u00e9diter T\u00e9l\u00e9chargez et installez PoEdit afin de suivre la suite du tutoriel.<\/p>\n Cr\u00e9er un fichier de traduction pour l’anglais n’a g\u00e9n\u00e9ralement aucun sens lorsque tous les textes de notre th\u00e8me sont de toute fa\u00e7on en anglais, mais pour les besoins de ce didacticiel, je vais cr\u00e9er un fichier de traduction en anglais.<\/p>\n 1 Ouvrez PoEdit et cliquez sur Fichier > Nouveau\u2026<\/p>\n 2 Vous serez invit\u00e9 \u00e0 choisir une langue. Choisissez la langue souhait\u00e9e, par exemple l’anglais.<\/p>\n 3 Appuyez sur Enregistrer (Ctrl+S). Localisez votre dossier de th\u00e8me et entrez dans le sous- 4 Dans le menu cliquez sur Catalogue > Propri\u00e9t\u00e9s\u2026<\/p>\n 5 Dans le premier onglet, vous pouvez remplir certaines informations telles que le nom de votre projet (th\u00e8me) ou changer la langue – mais ce n’est pas n\u00e9cessaire. Je vous recommande de conserver le jeu de caract\u00e8res en UTF-8 car c’est ce que nous \u00e9crivons pour WordPress.<\/p>\n 6 Cliquez sur l’onglet Chemins des sources. Ici, vous devrez d\u00e9finir les dossiers dans lesquels le fichier doit rechercher les textes traduisibles. Les chemins sont relatifs, et comme nous l’avons d\u00e9j\u00e0 enregistr\u00e9 dans un sous-dossier de notre th\u00e8me, nous savons qu’il doit remonter d’un r\u00e9pertoire. Appuyez sur le bouton + sous la zone Chemins et choisissez Ajouter des dossiers. Choisissez votre r\u00e9pertoire de th\u00e8mes. Cela devrait ajouter un \u00e9l\u00e9ment de chemin "." (remonter d’un dossier). V\u00e9rifiez que "Chemin de base" fait r\u00e9f\u00e9rence \u00e0 votre r\u00e9pertoire de th\u00e8me racine.<\/p>\n 7 Cliquez sur l’onglet suivant, \u00abMots-cl\u00e9s sources \u00bb. Ici, vous devez indiquer \u00e0 PoEdit quelles fonctions vous avez utilis\u00e9es pour les textes traduisibles (par exemple load_theme_textdomain<\/code>la fonction de configuration de notre th\u00e8me. Au cas o\u00f9 vous auriez oubli\u00e9, voici ce que nous avons ajout\u00e9\u00a0:<\/p>\nload_theme_textdomain('wptutorial', get_stylesheet_directory(). '\/lang');<\/code><\/pre>\nlang<\/code>‘ de notre r\u00e9pertoire de th\u00e8mes.<\/p>\nComment rendre les textes traduisibles<\/h2>\n
_e()<\/code>ou __()<\/code>. Le premier est un trait de soulignement avec "e" qui est utilis\u00e9 lorsque vous souhaitez faire \u00e9cho au texte en m\u00eame temps. Le second est compos\u00e9 de deux traits de soulignement et est utilis\u00e9 lorsque vous ne voulez pas l’\u00e9cho mais le stocker ou l’utiliser dans une variable.<\/p>\nesc_html__()<\/code>et plus encore. Cependant, nous n’entrerons pas dans les d\u00e9tails pour ceux de ce tutoriel._n()``_x()<\/code><\/p>\nload_theme_textdomain<\/code>. Dans ce cas c’est ‘ 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>et d’autres dans single.php<\/code>.<\/p>\nAjout du support de traduction dans notre th\u00e8me<\/h2>\n
index.php<\/code>localiser le message "Pas de messages, d\u00e9sol\u00e9" que nous avons ajout\u00e9 si la boucle ne contenait aucun message. Nous enveloppons ce texte \u00e0 l’int\u00e9rieur _e()<\/code>parce que nous voulons toujours lui faire \u00e9cho. Voici donc ce que nous obtenons\u00a0:<\/p>\n...\n} else {\n ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n...<\/code><\/pre>\n_e()<\/code>, vous ne devriez voir aucun changement lorsque vous cliquez sur Actualiser sur la page d’accueil ou l’archive. Mais sous le capot, ce texte est d\u00e9sormais traduisible !<\/p>\nsingle.php<\/code>et page.php<\/code>. Mettez-les \u00e0 jour de la m\u00eame mani\u00e8re que nous l’avons fait dans index.php<\/code>. Nous avons ajout\u00e9 quelques textes suppl\u00e9mentaires dans single.php<\/code>, alors voici \u00e0 quoi cela ressemble apr\u00e8s avoir rendu tous les textes traduisibles\u00a0:<\/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>ou _e()<\/code>.<\/p>\nFichiers de traduction<\/h2>\n
\n
.pot<\/code>-fichier<\/li>\n.po<\/code>et ..mo<\/code><\/li>\n<\/ul>\n.pot<\/code>fichier -file est recommand\u00e9 pour un th\u00e8me que vous vendez ou donnez \u00e0 d’autres utilisateurs, car avec ce fichier, il est tr\u00e8s facile de g\u00e9n\u00e9rer un fichier de traduction pour une nouvelle langue. Cependant, il n’est pas facile (ou gratuit) de cr\u00e9er un de ces fichiers. Si vous connaissez WP-CLI (ligne de commande WordPress) ou Grunt, vous pouvez suivre les directives de la documentation de WordPress ici<\/a>. Sinon, l’autre alternative pourrait \u00eatre pour vous.<\/p>\n.po<\/code>et .mo<\/code>travailler ensemble. WordPress n\u00e9cessite un .mo<\/code>pour la traduction des textes, mais ce fichier n’est pas humainement lisible. Nous avons donc le .po<\/code>fichier qui est lisible pour nous. Avec le bon logiciel, il g\u00e9n\u00e8re le .mo<\/code>fichier chaque fois que vous apportez des modifications.<\/p>\n.po<\/code>et .mo<\/code>est que vous devez g\u00e9n\u00e9rer une paire pour chaque langue, et une fois que vous l’avez traduite dans une langue, il n’y a pas de moyen facile de vider toutes les traductions afin de cr\u00e9er une autre nouvelle langue.<\/p>\n.pot<\/code>et .po<\/code>fichiers. Le plus courant est PoEdit<\/a>. PoEdit est gratuit et fonctionne \u00e0 la fois pour iOS et Windows. Mais certaines fonctionnalit\u00e9s avanc\u00e9es (comme la g\u00e9n\u00e9ration d’un .pot<\/code>fichier -) n\u00e9cessitent malheureusement une version payante. Nous utiliserons la version gratuite pour cr\u00e9er un .po<\/code>fichier pour notre th\u00e8me.<\/p>\nCr\u00e9er un fichier .po pour notre th\u00e8me avec PoEdit<\/h2>\n
\/lang\/<\/code>dossier. (Si vous ne l’avez pas cr\u00e9\u00e9 \u00e0 la derni\u00e8re \u00e9tape, cr\u00e9ez-le maintenant). Le nom de votre fichier est essentiel. Pour les th\u00e8mes, il doit \u00eatre nomm\u00e9 simplement votre code de langue. Pour l’anglais am\u00e9ricain ce serait en_US<\/code>, pour le norv\u00e9gien c’est nb_NO<\/code>. Recherchez-le sur Google ou consultez cet aper\u00e7u<\/a> pour trouver votre code de langue. Nous allons le nommer en_US.po<\/code>.<\/p>\n![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69a10501.png\")
<\/a><\/p>\n![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69b261fd.png\")
<\/a><\/p>\n__<\/code>, _e<\/code>, esc_html_e<\/code>etc.). Cliquez sur le bouton + pour ajouter chaque fonction et \u00e9crivez-les sans "()". C’est \u00e0 vous de d\u00e9cider si vous voulez couvrir toutes vos bases et ajouter toutes les fonctions gettext de WordPress, mais dans ce tutoriel, nous savons que nous n’en avons utilis\u00e9 que deux. Nous ajoutons donc deux \u00e9l\u00e9ments; __()<\/code>et _e()<\/code>. Ajoutez les fonctions sans aucune parenth\u00e8se.<\/p>\n
![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69c29a5b.png\")
<\/a><\/p>\n![\"Tutoriel](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69d34b4a.png\")
<\/a><\/p>\n