README

来源于 "translate" 和 "slug" 这两个词的组合，目的是实现文章和帖子中文标题也可以使用 slug 类型的 URL。

演示

CODECASTS 视频学习社区: https://www.codecasts.com/discuss ，随便点开一个问答帖子就可以看效果。

使用前必看

由于有道翻译服务全面升级：http://fanyi.youdao.com/openapi?path=data-mode

请尽快升级到 Translug 2.0 以上版本。

对应的版本说明：

安装

这是一个标准的 Composer 包，您可以通过以下命令行直接安装：

composer require jellybool/translug

或者在您的 composer.json 文件中添加

"jellybool/translug" : "~3.0"

然后执行 composer update

初始化

在 Translug 中，翻译功能直接使用有道翻译 API，您首先需要在这里注册您的网站或 App

http://ai.youdao.com/docs/api.s

不用担心，非常简单！有道翻译的免费接口限制为每小时最多 1000 次请求，如果需要更多 API 调用，请联系有道官方。

注册后，需要创建一个应用，然后您会获得两个关键信息

1. appKey
2. appSecret

1. Laravel 中使用

1.1 配置 默认情况下，在 Laravel 项目中的 config/services.php 中添加

  'stripe' => [
        'model' => App\User::class,
        'key' => env('STRIPE_KEY'),
        'secret' => env('STRIPE_SECRET'),
    ],
   // 下面是你添加的内容
   'youdao' => [
           'appKey' => env('YOUDAO_APP_KEY'),
           'appSecret' => env('YOUDAO_APP_SECRET'),
       ],
       
/*  如果你是从 translug:~1.0 升级的话，需要把下面的配置修改成上面的
'youdao' => [
        'key' => env('YOUDAO_API_KEY'),
        'from' => env('YOUDAO_KEY_FROM'),
    ],
 */   

当然，您还需要在 .env 文件中添加

YOUDAO_APP_KEY=app_key
YOUDAO_APP_SECRET=app_secret

translug:~1.0 升级时，也要相应修改这里的 .env 变量

在 config/app.php 中，添加 provider 和 aliases

 //providers
 \JellyBool\Translug\TranslugServiceProvider::class,

// aliases
'Translug' => \JellyBool\Translug\TranslugFacade::class,

1.2 使用

app('translug')->translate('如何安装 Laravel'); 
//How to install the Laravel

// or 
use Translug;
Translug::translate('如何安装 Laravel');
//How to install the Laravel

app('translug')->translug('如何安装 Laravel'); 
//how-to-install-the-laravel

// or 
use Translug;
Translug::translug('如何安装 Laravel');
//how-to-install-the-laravel

//或者你只想要 slug 的话

translug('如何安装 Laravel');
//how-to-install-the-laravel

translug('怎么理解 laravel 关联模型');
//how-to-understand-the-laravel-associated-model

//針對繁體,翻譯會有一點不一樣
translug('怎麼理解 laravel 關聯模型');
//how-to-understand-the-laravel-correlation-model

2. 在普通项目中使用

2.1 设置 appKey 和 appSecret

use JellyBool\Translug\Translug;

$translug = new Translug(['appKey' => 'your_key_from', 'appSerect' => 'your_api_key' ]);
// 或者也可以这样
$translug = new Translug();
$translug->setConfig('appKey' => 'your_key_from', 'appSerect' => 'your_api_key']);

2.2 使用

$translug->translate('如何安装 Laravel');
//How to install the Laravel

$translug->translug('如何安装 Laravel');
//how-to-install-the-laravel