wikitran/wikitran

Translate terms using Wikipedia

Wikitran

![Software License][ico-license] , _(*1)

Translate terms using Wikipedia multilingual articles, _(*2)

Installation and usage

As command-line tool

``` bash $ composer g require wikitran/wikitran $ wikitran [ ...] , <sub>(*3)</sub>

(Be sure set up your $PATH for Composer.)

Use [Wikipedia language codes](https://meta.wikimedia.org/wiki/List_of_Wikipedias#All_Wikipedias_ordered_by_number_of_articles) as source and destination languages.
First code is for source language. Rest codes are for destination languages.
First word that isn't valid language code will be interpreted as first word of your query for translation.

#### Examples

##### Specify source and destination languages

``` bash
$ wikitran de ar es schreiber

Query is "schreiber". Source language is "de" (German). Destination languages are "ar" (Arabic) and "es" (Spanish)., <sub>(*4)</sub>

Specify destination as all available languages

``` bash $ wikitran de all schreiber, <sub>(*5)</sub>

Source language is "de" (German). Destination languages are all available languages for the query.

##### Use default destination

``` bash
$ wikitran de schreiber

Source language is "de" (German). Destination language is not set. Default value is "all"., <sub>(*6)</sub>

Use default source and destination

``` bash $ wikitran scrivener, <sub>(*7)</sub>

Source language is not set. Default value is "en" (English). Destination language is not set. Default value is "all".

### As PHP library

``` bash
$ composer require wikitran/wikitran

``` php use Wikitran\Translator;, <sub>(*8)</sub>

// set russian as default source language instead of english $tr = new Translator(['source' => 'ru']);, <sub>(*9)</sub>

// First arg is for query. Second is for source language (optional). // Rest are for destination languages (optional). $pushkin = $tr->translate('Пушкин'); $wiskunde = $tr->translate('wiskunde', 'nl', 'en', 'de', 'fr', 'ru');, <sub>(*10)</sub>

See also [examples](examples).

## Database

You can use SQL database (SQLite and MySQL supported) as cache for already translated terms.

### Migration

(Using "binary" PHP script)

#### Built-in SQLite database

``` bash
$ wikitran --migrate --createFile

SQLite

``` bash $ wikitran --migrate --server sqlite --file path/to/your/db/file [--createFile], <sub>(*11)</sub>

#### MySQL

``` bash
$ wikitran --migrate --server mysql --db <database name> --user <db user> [--host <host>] [--port <port>] [--password <password>] [--charset <charset>]

Connection

Built-in SQLite database

As default (if built-in db exists)., <sub>(*12)</sub>

SQLite

``` php use Wikitran\Translator;, <sub>(*13)</sub>

$tr = new Translator(['db' => [ 'server' => 'sqlite', 'file' => 'path/to/your/db/file' ]]);, <sub>(*14)</sub>

#### MySQL

``` php
use Wikitran\Translator;

// 'password', 'port', etc. are optional
$tr = new Translator(['db' => [
    'server' => 'mysql',
    'db' => 'db_name',
    'user' => 'db_user'
]]);

PDO instance

If you have instance of class PDO, you can set db connection directly in constructor: ``` php use Wikitran\Translator;, <sub>(*15)</sub>

$tr = new Translator([], $pdo);, <sub>(*16)</sub>

Or, later:
``` php
use Wikitran\Translator;

$tr = new Translator();

$tr->setConnection($pdo);

License

The MIT License (MIT). Please see License File for more information., <sub>(*17)</sub>

, <sub>(*18)</sub>