Pour expliquer en bref comment traduire pour les scripts Javascript (Gutenberg): WordPress n\u00e9cessite Donc, ce que nous devons faire, c’est d’abord ajouter les fonctions gettext ( Gardez \u00e0 l’esprit que les fichiers\/fichiers de votre th\u00e8me ou plugin La premi\u00e8re \u00e9tape consiste \u00e0 envelopper tous les textes dans notre fichier Javascript dans les fonctions de traduction. Si vous avez g\u00e9r\u00e9 la traduction de WordPress en PHP, vous connaissez probablement tr\u00e8s bien les fonctions Comme avec PHP, vous devez fournir un domaine textdomain (nom\/handle). Cela peut \u00eatre ce que vous voulez, mais soyez bref car vous devrez probablement le taper tr\u00e8s souvent. Pour mon th\u00e8me, j’ai configur\u00e9 mon textdomain avec le domaine Commen\u00e7ons \u00e0 \u00e9diter notre fichier Javascript. Nous devons d’abord d\u00e9structurer la fonction Et puis il s’agit de retrouver tous nos textes cod\u00e9s en dur dans le fichier Javascript et de les mettre \u00e0 jour. Gardez \u00e0 l’esprit que les fonctions Par exemple, notre Et en ce qui concerne les accessoires, c’est-\u00e0-dire dans Enveloppez tous les textes dont vous souhaitez prendre en charge la traduction dans Cette \u00e9tape varie un peu en fonction de ce que vous avez d\u00e9j\u00e0 fait et configur\u00e9 pour votre th\u00e8me ou plugin. Vous \u00e9crivez peut-\u00eatre vos scripts Gutenberg dans un nouveau plugin vide qui n’a pas \u00e9t\u00e9 configur\u00e9 pour la traduction PHP, ou dans un th\u00e8me qui a d\u00e9j\u00e0 un domaine de texte enregistr\u00e9. Vous pouvez avoir des fichiers PO (et MO) pr\u00eats, ou vous pouvez n’avoir qu’un fichier POT. Je ferai de mon mieux pour couvrir toutes les bases.<\/p>\n Si vous avez d\u00e9j\u00e0 un fichier PO ou POT dans votre projet, vous avez probablement aussi la fonction PHP Tout ce que vous avez \u00e0 faire est de charger le fichier PO pour la langue que vous souhaitez traduire (ou d’en g\u00e9n\u00e9rer un \u00e0 partir du fichier POT) dans par exemple PoEdit<\/a>. Cliquez sur "Mettre \u00e0 jour \u00e0 partir du code" (ou similaire dans d’autres programmes) afin que le programme puisse analyser tous les fichiers du projet (y compris nos fichiers Javascript r\u00e9cemment mis \u00e0 jour) et mettre \u00e0 jour le pool de cha\u00eenes \u00e0 traduire. Les cha\u00eenes de notre fichier Javascript devraient appara\u00eetre. Ensuite il vous suffit de les traduire normalement et de les enregistrer.<\/p>\n PS\u00a0: Si vous ne parvenez pas \u00e0 cliquer sur "Mettre \u00e0 jour \u00e0 partir du code" ou \u00e0 r\u00e9analyser les fichiers, le fichier PO n’a probablement pas \u00e9t\u00e9 configur\u00e9 correctement. Recherchez des conseils dans la section suivante.<\/p>\n Si votre th\u00e8me ou projet n’a pas \u00e9t\u00e9 configur\u00e9 avec la traduction, vous devez soit g\u00e9n\u00e9rer un fichier POT \u00e0 l’aide de WP-CLI, soit cr\u00e9er manuellement un fichier PO.<\/p>\n J’ai un guide complet sur la fa\u00e7on de cr\u00e9er un fichier PO dans mon didacticiel th\u00e9matique pour d\u00e9butants – partie 8<\/a>. Le message d\u00e9crit comment vous pouvez cr\u00e9er le fichier et le configurer correctement pour rechercher vos fichiers de th\u00e8me, ainsi que les mots-cl\u00e9s \u00e0 rechercher ( Si vous souhaitez plut\u00f4t cr\u00e9er un fichier POT, vous pouvez utiliser la commande wp i18n make-pot<\/a> dans WP-CLI, puis cr\u00e9er un fichier PO \u00e0 partir de celui-ci en utilisant par exemple PoEdit. Gardez \u00e0 l’esprit que vous devrez r\u00e9g\u00e9n\u00e9rer le fichier POT (puis le fichier PO) chaque fois que vous mettez \u00e0 jour des cha\u00eenes dans votre code.<\/p>\n Ce dont vous avez besoin en fin de compte, c’est d’un fichier PO qui a trouv\u00e9 vos cha\u00eenes Javascript l\u00e0 o\u00f9 elles ont \u00e9t\u00e9 traduites. Je vous recommande de placer vos fichiers de traduction dans un dossier s\u00e9par\u00e9 de votre th\u00e8me ou plugin. Lorsque nous commen\u00e7ons \u00e0 g\u00e9n\u00e9rer des fichiers JSON, nous nous retrouvons avec un certain nombre de fichiers \u00e0 traduire et ce sera bien de les garder tous ensemble dans leur propre dossier.<\/p>\n Comme point de r\u00e9f\u00e9rence, je place tous les fichiers de traduction dans mon fichier L’\u00e9tape suivante consiste \u00e0 utiliser WP-CLI pour g\u00e9n\u00e9rer des fichiers JSON \u00e0 partir de notre fichier po. Pour ce faire, nous utilisons la commande wp i18n make-json<\/a>.<\/p>\n Sachez que par d\u00e9faut, cette commande extraira les cha\u00eenes traduites de votre fichier PO pour les utiliser dans la g\u00e9n\u00e9ration du fichier JSON. Cela peut \u00eatre fastidieux au milieu du d\u00e9veloppement de votre th\u00e8me ou plugin. Parce que lorsque vous ajoutez de nouvelles cha\u00eenes ou que vous les ajustez, vous devrez analyser \u00e0 nouveau les fichiers et traduire \u00e0 nouveau toutes les cha\u00eenes (et encore et encore). Heureusement, il y a un drapeau \u00e0 la commande pour \u00e9viter cela.<\/p>\n Commen\u00e7ons! Dans votre terminal, acc\u00e9dez au r\u00e9pertoire de votre langue pour votre projet. Ex\u00e9cutez la commande suivante et reportez-vous \u00e0 votre fichier po (comme mentionn\u00e9, j’ai un Si vous n’avez aucun probl\u00e8me \u00e0 supprimer les cha\u00eenes traduites de votre fichier PO (par exemple si vous faites votre version finale), vous pouvez ignorer le Le terminal doit indiquer "Succ\u00e8s" et indiquer le nombre de fichiers JSON cr\u00e9\u00e9s. Si vous voyez qu’il a g\u00e9n\u00e9r\u00e9 deux fichiers JSON, c’est parce qu’il a lu \u00e0 la fois notre fichier Javascript de code source et le fichier de construction, et en a g\u00e9n\u00e9r\u00e9 un pour chacun. Si vous avez plus de fichiers Javascript dans votre projet, vous vous retrouverez avec encore plus de fichiers JSON.<\/p>\n Au moment de la r\u00e9daction de ce document (WordPress v 5.3.2 et WP-CLI version 2.4.0), les fichiers JSON sont g\u00e9n\u00e9r\u00e9s avec le code de langue et un hachage – une cha\u00eene crypt\u00e9e comme noms de fichiers. Nous devons trouver le bon et le renommer.<\/p>\n.mo<\/code>des fichiers pour la traduction des fichiers PHP, mais pour Javascript, WordPress n\u00e9cessite un .json<\/code>fichier. Chaque fichier Javascript n\u00e9cessite un fichier JSON pour la traduction. Le JSON doit \u00eatre d’un format sp\u00e9cifique (WP CLI le g\u00e9n\u00e9rera pour nous) avec nos cha\u00eenes traduites. Nous avons besoin d’un fichier JSON par langue dans laquelle nous souhaitons traduire.<\/p>\n__()<\/code>, _e()<\/code>etc.) dans nos fichiers Javascript et g\u00e9n\u00e9rer un fichier PO comme d’habitude pour notre th\u00e8me ou plugin. Parce que nous avons envelopp\u00e9 les textes dans nos fichiers de script avec par exemple __()<\/code>, le fichier PO devrait pouvoir les inclure. Ensuite, nous faisons la traduction comme d’habitude dans notre fichier PO. Et enfin, nous utilisons WP CLI pour extraire les cha\u00eenes n\u00e9cessaires du fichier PO et g\u00e9n\u00e9rer des fichiers JSON pour tous nos fichiers Javascript.<\/p>\n.po<\/code>n’auront .mo<\/code>jamais d’effet sur vos fichiers Javascript, m\u00eame s’ils contiennent des cha\u00eenes traduites \u00e0 partir de nos fichiers Javascript.<\/p>\nImpl\u00e9mentation de la traduction en Javascript<\/h2>\n
__()<\/code>, _e()<\/code>, esc_html__()<\/code>etc. WordPress a un package wp.i18n<\/code>qui contient ces fonctions, qui fonctionnent exactement comme en PHP.<\/p>\nawhitepixel<\/code>. Donc dans PHP je vais faire __('My string', 'awhitepixel')<\/code>pour traduire les cha\u00eenes, et ce sera exactement la m\u00eame chose dans les fichiers Javascript.<\/p>\n__<\/code>et _e<\/code>du wp.i18n<\/code>package. En raison de la nature de React, vous utiliserez probablement la __<\/code>fonction principalement ou peut-\u00eatre uniquement.<\/p>\nconst { __, _e } = wp.i18n;<\/code><\/pre>\n__<\/code>et _e<\/code>n\u00e9cessitent un contexte Javascript. Cela signifie que lorsque nous tapons des cha\u00eenes comme par exemple des valeurs de propri\u00e9t\u00e9 d’objet, nous utilisons __()<\/code>tout de suite, mais comme valeurs pour, par exemple, des accessoires, nous devons tout envelopper \u00e0 l’int\u00e9rieur { }<\/code>pour signifier qu’il s’agit de code Javascript.<\/p>\nregisterBlockType<\/code>support pour la traduction ressemblera \u00e0\u00a0:<\/p>\nregisterBlockType('awp\/firstblock', {\n title: __('My first block', 'awhitepixel'), \n category: 'common',\n icon: 'smiley',\n description: __('Learning in progress', 'awhitepixel'),\n keywords: [__('example', 'awhitepixel'), __('test', 'awhitepixel')],\n attributes: {\n ...<\/code><\/pre>\nInspectorControls<\/code>:<\/p>\n<InspectorControls>\n <PanelBody\n title={__(\"Most awesome settings ever\", 'awhitepixel')}\n initialOpen={true}\n >\n ...\n <ToggleControl\n label={__(\"Toggle me\", 'awhitepixel')}\n checked={attributes.toggle}\n onChange={(newval) => setAttributes({ toggle: newval })}\n \/>\n ...<\/code><\/pre>\n__()<\/code>et _e()<\/code>. Si vous avez suivi ce tutoriel \u00e9tape par \u00e9tape, vous ne devriez pas avoir de cas o\u00f9 vous devez utiliser _e()<\/code>. Lorsque vous avez termin\u00e9, recompilez le Javascript et nous nous \u00e9loignerons de Javascript.<\/p>\nConfiguration des fichiers po et\/ou pot<\/h2>\n
Mon th\u00e8me ou plugin a d\u00e9j\u00e0 un fichier po(t)<\/h3>\n
load_theme_textdomain()<\/code>, load_child_theme_textdomain()<\/code>ou load_plugin_textdomain()<\/code>quelque part dans votre code. Veuillez vous assurer que le domaine enregistr\u00e9 est le m\u00eame que celui que vous avez utilis\u00e9 dans vos fichiers Javascript.<\/p>\nJe n’ai pas de fichiers de traduction<\/h3>\n
__<\/code>, _e<\/code>, etc.).<\/p>\nR\u00e9sultat final<\/h3>\n
theme\/assets\/lang\/<\/code>. J’ai ajout\u00e9 une traduction norv\u00e9gienne pour mon th\u00e8me, nomm\u00e9e nb_NO.po<\/code>, qui contient les cha\u00eenes traduites de notre fichier Javascript de bloc personnalis\u00e9.<\/p>\nG\u00e9n\u00e9ration de fichiers JSON \u00e0 partir du fichier po<\/h2>\n
nb_NO.po<\/code>fichier pr\u00eat).<\/p>\nwp i18n make-json nb_NO.po --no-purge<\/code><\/pre>\n--no-purge<\/code>drapeau.<\/p>\nRenommer le fichier JSON et le charger en PHP<\/h2>\n
![\"Cr\u00e9er](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153240-61e50a824a365.png\")
<\/a><\/p>\n![\"Cr\u00e9er](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153240-61e50a83bedae.png\")
<\/a><\/p>\n