Mirza_Yandex_Translatorダウンロード - Mirza_Yandex_Translatorソースコードのダウンロード

Mirza_Yandex_Translator

その他のカテゴリー

Mirza Yandex Translator: 1.0.1

ダウンロード

Laravel 用 Mirza Yandex 翻訳者

Mirza Translator を使用すると、Yandex.Translate API を使用してテキストを簡単に翻訳および操作できます。

クイックスタート

たった3 つのステップで素早く設定してみましょう。

ターミナル/cmd 経由で Laravel インストールフォルダーに移動し、 composer require yak0d3/ Mirza_Yandex_Translatorを実行するか、 "yak0d3/ Mirza_Yandex_Translator ": "^1.0.0"をcomposer.jsonに手動で追加します。
次のいずれかの方法を使用して構成ファイルを公開します。
1. php artisan vendor:publish --provider="yak0d3 Mirza_Yandex_Translator TMirzaServiceProvider"
2. php artisan vendor:publishを実行し、 yak0d3 Mirza_Yandex_Translator TMirzaServiceProvider後ろの番号を入力してEnterを押します
YANDEX_APIという名前で.envファイルに環境変数を追加し、その値を独自の Yandex.Translate API キーに設定します。 (例: YANDEX_API=MY_YANDEX_API_KEY )

注:無料の API キーは、Yandex.Translate 開発者ダッシュボードから取得できます。

クイック使い方ガイド

クイック使用ガイドは、このパッケージの基本的な使用法を説明することだけを目的としています。メソッドのリストとその関連情報 (パラメータ、戻り値の型など) については、メソッドセクションにジャンプするか、ディレクティブセクションにジャンプして、そのリストを表示してください。利用可能なbladeディレクティブ。

言語の検出:
Mirza::detectLanguage('Welcome');
en : en
テキストを翻訳:
Mirza::translate('Hello','es');
出力: "Hola"

多言語に翻訳:
`Mirza::translateTo('Hello World!',['es', 'tr', 'fr']')`

出力：

 {
  " originalText ": " Hello World! " ,
  "originalLanguage": "en",
  "text": {
  "es": " Hola Mundo! " ,
  "tr": " Merhaba D  u00fcnya ! " ,
  "fr": " Bonjour Tout Le Monde!"
  }
 }

注:この文字列は、 json_decode関数を使用してデコードできます。

テキストの配列を翻訳する:
$textArray = ['Hello','My Dear','Friend'];
Mirza::translateArray($textArray,'fr');
出力：

[
 {
 " originalText ": "Hello",
 "translatedText": "Bonjour"
 },
 {
 "originalText": "My dear",
 "translatedText": "Mon cher"
 },
 {
 "originalText": "Friend",
 "translatedText": " Ami"
 }
]

注:この文字列は、 json_decode関数を使用してデコードできます。

まだわかりませんか?以下のドキュメントを参照すれば、混乱は解消されます。

ドキュメント (例付き)

管理しましょう。ここにいる誰もがこのパッケージを簡単に使い始めることができるわけではないので、何が起こっているのかを一緒に理解しましょう。このセクションでは、 Mirza Yandex Translatorが提供するすべてのメソッドの使用法について説明します。目次は次のとおりです。

translateメソッド
translateArrayメソッド
1. シーケンシャル配列の使用
2. 連想配列の使用
translateToメソッド
detectLanguageメソッド
1. 言語コードを返す
2. 言語名を返す
getSupportedLanguagesメソッド
translateToAllメソッド
ブレードディレクティブ
1. @translateディレクティブ
2. @yandex_rightsディレクティブ
3. @languages_selectディレクティブ

translateメソッド

すでに予想されているように、トランスレータパッケージには確かに `translate` メソッドがあり、このメソッドは 2 つのパラメータを取ります。ターゲット言語のテキストと ISO コード。

例：

	$ es_translation = Mirza::translate( ' Hello World! ' , 'es); //The first param is the text, the second one is the ISO code of the language
	echo $es_translation; //This will output "Hola Mundo!"

translateArrayメソッド

すべてのjson文字列は、PHP のjson_decode関数を使用してデコードする必要があることに注意してください。ヒント: PHP 配列を返すには、 json_decodeの 2 番目の引数をtrueに設定します (例: json_decode($jsonString, true); )。
json objectsを操作したい場合は、2 番目の引数を空のままにするか、 falseに設定します。

Mirza::translateArray(['Hello', 'My Dear', 'Friend'],'fr');このメソッドは、指定されたテキスト配列 (この場合は配列['Hello', 'My Dear', 'Friend']翻訳し、それを指定された言語 (この例ではフランス語) に翻訳します。
この関数は、次のようなjson encoded文字列を返します。

[
 {
 " originalText ": "Hello",
 "translatedText": "Bonjour"
 },
 {
 "originalText": "My dear",
 "translatedText": "Mon cher"
 },
 {
 "originalText": "Friend",
 "translatedText": " Ami"
 }
]

ご覧のとおり、出力json string入力配列と同じ順序になっており、次のように文字列をデコードすることでこれらの各要素にアクセスできるようになります。

	$ jsonString = Mirza:: translateArray ([ ' Hello ' , ' My Dear ' , ' Friend ' ], ' fr ' ); //The json string
	$ translationsArray = json_decode ( $ jsonString , true ); //Our PHP Array
	$ first_translation = $ translationsArray [ 0 ][ ' translatedText ' ];
	$ second_translation = $ translationsArray [ 1 ][ ' translatedText ' ];
	$ third_translation = $ translationsArray [ 2 ][ ' translatedText ' ];

簡単ですよね？ただし、$assoc パラメーターを true に設定すると、(手動で設定した) インデックス名によって文字列翻訳にアクセスできるようになり、さらに簡単になる可能性があります。ここで混乱する人はいません。例を次に示します。

 $ textArray = [
	' header ' => " Welcome to the Mirza Documentation Page " ,
	' body ' => " The body is too long to be put in this item " ,
	' footer ' => " Thank you for reading this! "
]; //Our associative text array
$ jsonString = Marzi:: translate ( $ textArray , ' es ' , true ); //Notice that i have set $assoc (third param) to `true`
$ translationsArray = json_decode ( $ jsonString , true );
//Now you can access the translations by their old index names
	$ header = $ translationsArray [ ' header ' ][ ' translatedText ' ];
	$ body = $ translationsArray [ ' body ' ][ ' translatedText ' ];
	$ footer = $ translationsArray [ ' footer ' ][ ' translatedText ' ];

注: $assoc trueに設定し、順次配列を指定すると、例外がスローされます。

translateToメソッド:

このメソッドは (おそらく) 前の関数の逆バージョンで、文字列のarrayを取得する代わりに 1 つのstringを取得し、それを言語の配列に翻訳します。例：

	$ jsonString = Mirza:: translateTo ( ' My awesome text ' , [ ' ar ' , ' tr ' , ' de ' ]);

上記の例は、次の構造のjson stringを返します。

[
	{
		" originalText ":"My awesome text",
		"originalLanguage": "en",
		"text":{
			" ar":" u0628  u0644  u062f  u064a  u0627  u0644  u0646  u0635  u0631  u0647  u064a  u0628  u0629 " ,
			" tr":" M  u00fcthi  u015f metin",
			" de " :"Meine wunderbare text"
		}

	}
]

一部の文字が Unicode 形式であることに気づいたかもしれませんが、後でechoても正しく表示されるので心配する必要はありません。

これで、このjson stringを簡単にデコードして、次のようにデータにアクセスできるようになります。

	$ translations = json_decode ( $ jsonString , true ); //Our PHP array
	$ originalText = $ translations [ ' originalText ' ];
	$ originalLanguage = $ translations [ ' originalLanguage ' ];
	$ ar_translation = $ translations [ ' text ' ][ ' ar ' ];
	$ tk_translation = $ translations [ ' text ' ][ ' tr ' ];
	$ de_translation = $ translations [ ' text ' ][ ' de ' ];

4. detectLanguageメソッド

テキストがどの言語で書かれているかを検出する必要がある場合があります。detectLanguage メソッドdetectLanguageこの問題のためだけに作成されています。メソッドの表で説明したように、このメソッドは 1 つの必須パラメーターと 1 つのオプションのパラメーターを受け取ります。オプションのパラメータ ( boolean $name ) を使用すると、言語 ISO コードを返すか言語名を返すかを切り替えることができます。

例：

返される言語コード:

 //Leave the $name param empty or set it to `false`
//To return the language ISO code
$ lang = Mirza:: detectLanguage ( ' Hello World! ' );
echo $ lang ; //Outputs "en"

返される言語名:

 //Setthe $name param to `true`
//To return the language ISO code
$ lang = Mirza:: detectLanguage ( ' Hello World! ' , true );
echo $ lang ; //Outputs "English"

5. getSupportedLanguagesメソッド

このメソッドはパラメーターを取りません (必須ですが、後のバージョンで追加される予定です)。実行すると、サポートされているすべての言語のリストが返されます。

例：

 //Save the json encoded string to the `$supportedLanguages` variable
$ supportedLanguages = Mirza:: getSupportedLanguages ();
echo $ supportedLanguages ; 
/* Outputs the json string in the following format:
	[
		{ 'lang_code' => 'lang_name' },
		{ 'lang_code' => 'lang_name' },
	]
*/

非常に長いため、出力全体を含めたくありませんでしたが、それでも興味がある場合は、これを用意しました。スクリーンショットは次のとおりです。

このjson stringをデコードして、少し遊んでみましょう。

 //Decode json string and wrap it into a PHP array
$ langsArray = json_decode ( $ supportedLanguages , true );

言語コードはあるものの、それがどの言語を指すのかがわからないとします。そのような場合、次の行が非常に役立ちます。

 echo $ langsArray [ ' tr ' ]; //Outputs "Turkish"

ここで、言語名はあるものの、ISO コードがわからないと仮定します。EASY PEASY! PHPのarray_flip関数で実現できます。

 $ flippedArray = array_flip ( $ langsArray ); 
/* The values are now keys! Cool right? */
$ languageCode = $ flippedArray [ ' Sinhalese ' ];
echo $ languageCode ; //Outputs "si"

translateToAllメソッド

このメソッドを何に使用するかわかりませんが、そのような機能を含めると便利だと思いました。メソッド名で述べたように、このメソッドは指定された文字列をサポートされているすべての言語に翻訳します。

例：

 //Save the json string to a variable
$ myStringInAllLanguages = Mirza:: translateToAll ( ' My string ' );
echo $ myStringInAllLanguages ; 
/*Outputs a similar string to the `translateTo` method but 
with all supported languages*/

7.ブレードディレクティブ

@translate : 外出先で特定のテキストを特定の言語に翻訳できます。
例：
```
 @translate('Welcome', 'fr') 
```

@yandex_rights : 翻訳結果の使用に関する Yandex.Translate の要件を読んだことがあれば、このディレクティブが非常に役立つことがわかるでしょう。
最初の引数としてcolor指定し、2 番目の引数としてfont-size指定する必要があります。

例：

 	@yandex_rights('black', '16px');
 	<!-- Output -->
 	< a href =' https://translate.yandex.com/ ' target =' _blank ' style =' font-size:16px;color:black; ' > Powered by Yandex.Translate </ a >

@languages_select : サポートされているすべての言語のリストを含む HTML <select>を生成します。

例：

  @languages_select
  <!-- Output -->
  < select >
 	< option value =" lang_code " > Lang_Name </ option >
 	< option value =" lang_code " > Lang_Name </ option >
 	< option value =" lang_code " > Lang_Name </ option >
 </ select >

メソッド

Mirzaのすべては簡単で読みやすいように設計されており、ソースコードを見るだけで何が起こっているのかすぐに理解できます。しかし、心配しないでください。私はあなたの苦労を省き、 Mirza Translator が提供するメソッドのリストを含む表を作成しました。

方法	パラメータ	返品	投げる	説明
翻訳する	`string $text` `string $lang` オプション: `string $format [html\|plain] (Default: "Plain")`	弦	例外:テキストを翻訳できなかった場合。	指定された`$text`指定された`$lang` (言語) に翻訳します。
翻訳する	`string $text` `array $langs`	文字列(json)	例外: 1 つ以上の言語がサポートされていない場合。	指定された`$text`複数の`$langs` (言語) に翻訳します。
配列の変換	`array $textArray` `string $lang` オプション: `bool $assoc (Default: false)`	文字列(json)	例外： 1. ターゲット言語がサポートされていない場合。 2. `$assoc`が`true`に設定されており、指定された配列が連想配列ではない場合。	`$textArray` (テキストの配列) を指定された`$lang` (言語) に変換します。注: `$assoc`が`true`に設定されている場合、返される json 文字列は同じインデックス名を持ちます。
言語を検出する	`string $text` オプション: `bool $langName`	弦	例外： 1. 言語コードが見つからない場合。 2. 言語名が見つからない場合	指定された`$text`の言語を検出し、言語コードを返します。注: `$langName`が`true`に設定されている場合、代わりに言語の完全名が返されます。
getサポート対象言語	なし	文字列(json)	例外:サポートされている関数のリストを取得しようとしたときに不明なエラーが発生した場合	サポートされているすべての言語のリストを含む json 文字列を返します。
すべてに翻訳	`string $text`	文字列(json)	なし	文字列 ( `$text` ) をサポートされているすべての言語に翻訳します。注:これには時間がかかり、 `PHP max_execution_time TIMEOUT Exception`発生する場合があります。
yandex_rights	オプション: `string $color (Default: #fff)` `string $fontsize (Default: 14px)`	弦	なし	「Powered By Yandex.Translate」リンク文字列の文字列を返します。 `blade`ディレクティブ`@yandex_rights`経由でも呼び出されます。注:フォントサイズ、色、配置の要件の詳細については、「Yandex 翻訳: 翻訳結果の使用の要件」を参照してください。
言語選択	なし	弦	なし	使用可能なすべての言語のリストを含む`HTML` `<select>`タグの文字列を返します。 `blade`ディレクティブ`@languages_select`経由でも呼び出されます

ブレードディレクティブ

指令	パラメータ	説明
`@yandex_rights`	オプション: `string $color (Default: #fff)` `string $fontsize (Default: 14px)`	「Powered By Yandex.Translate」テキストの HTML リンクを生成します。
`@languages_select`	なし	使用可能なすべての言語のリストを含む`HTML` `<select>`タグを生成します。
`@translate`	`string $text` `string $lang`	指定された`$text`列を指定された`$lang` (言語) に翻訳します。

問題と提案

Mirza は1 人 (もちろん私 ?) によってテストされています。つまり、他の人でも問題が発生する可能性があります。Mirzaのインストールで何か問題が発生した場合、または何かがまだ足りないと思われる場合は、新しい問題を送信して私に知らせてください。

ライセンス

拡大する

追加情報

バージョン Mirza Yandex Translator: 1.0.1
タイプその他のカテゴリー
更新時間 2024-12-29
サイズ 16.16KB
から Github

Mirza_Yandex_Translator

Laravel 用 Mirza Yandex 翻訳者

目次

クイックスタート

クイック使い方ガイド

言語の検出:
`Mirza::detectLanguage('Welcome');`
`en` : en

テキストを翻訳:
`Mirza::translate('Hello','es');`
出力: `"Hola"`

多言語に翻訳:
`Mirza::translateTo('Hello World!',['es', 'tr', 'fr']')`

出力：

テキストの配列を翻訳する:
`$textArray = ['Hello','My Dear','Friend'];`
`Mirza::translateArray($textArray,'fr');`
出力：

ドキュメント (例付き)

メソッド

ブレードディレクティブ

問題と提案

ライセンス

OpenCore_NO_ACPI_Build

nspanel_pro_tools_apk

YuQue_Book_Download

zkwork_aleo_gpu_worker

nextcloud_share_url_downloader

Lihua データ分析エンジン無料版 3.0_検索_ナビゲーション_コレクション_世論_ランキング_api

chat.petals.dev

GPT Prompt Templates

GPTyped

termwind

wp functions

slugify

waymo open dataset

termwind

wp functions

Mirza_Yandex_Translator

Laravel 用 Mirza Yandex 翻訳者

目次

クイックスタート

クイック使い方ガイド

言語の検出: Mirza::detectLanguage('Welcome'); en : en

テキストを翻訳: Mirza::translate('Hello','es');出力: "Hola"

多言語に翻訳: Mirza::translateTo('Hello World!',['es', 'tr', 'fr']')出力：

テキストの配列を翻訳する: $textArray = ['Hello','My Dear','Friend']; Mirza::translateArray($textArray,'fr');出力：

ドキュメント (例付き)

メソッド

ブレードディレクティブ

問題と提案

ライセンス

言語の検出:
`Mirza::detectLanguage('Welcome');`
`en` : en

テキストを翻訳:
`Mirza::translate('Hello','es');`
出力: `"Hola"`

多言語に翻訳:
`Mirza::translateTo('Hello World!',['es', 'tr', 'fr']')`

出力：

テキストの配列を翻訳する:
`$textArray = ['Hello','My Dear','Friend'];`
`Mirza::translateArray($textArray,'fr');`
出力：