https://github.com/change/linguist

Elixir Internationalization library
https://github.com/change/linguist

elixir

Last synced: about 1 month ago
JSON representation

Elixir Internationalization library

• Host: GitHub
• URL: https://github.com/change/linguist
• Owner: change
• License: mit
• Created: 2014-06-23T19:23:42.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-05-31T08:43:34.000Z (7 months ago)
• Last Synced: 2024-08-01T02:14:26.466Z (4 months ago)
• Topics: elixir
• Language: Elixir
• Homepage:
• Size: 200 KB
• Stars: 179
• Watchers: 36
• Forks: 23
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• fucking-awesome-elixir - linguist - Elixir Internationalization library. (Translations and Internationalizations)
• awesome-elixir - linguist - Elixir Internationalization library. (Translations and Internationalizations)

README

        
# Linguist

[![Test](https://github.com/change/linguist/actions/workflows/test.yml/badge.svg)](https://github.com/change/linguist/actions/workflows/test.yml)

[![Version on Hex.pm](https://img.shields.io/hexpm/v/linguist.svg)](https://hex.pm/packages/linguist)

[![Hex Docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/linguist)

[![Hex.pm downloads](https://img.shields.io/hexpm/dt/linguist.svg)](https://hex.pm/packages/linguist)

[![License](https://img.shields.io/hexpm/l/linguist.svg)](https://github.com/change/linguist/blob/master/LICENSE)

[![Latest commit](https://img.shields.io/github/last-commit/change/linguist.svg)](https://github.com/change/linguist/commits/master)

![GitHub top language](https://img.shields.io/github/languages/top/change/linguist)

> Linguist is a simple Elixir Internationalization library

## Installation

Add `:linguist` to your `mix.exs` dependencies:

```elixir

def deps do

  [

    {:linguist, "~> 0.4"}

  ]

end

```

Update your dependencies:

```bash

$ mix deps.get

```

## Usage

```elixir

defmodule I18n do

  use Linguist.Vocabulary

  locale "en", [

    flash: [

      notice: [

        hello: "hello %{first} %{last}",

        bye: "bye now, %{name}!"

      ]

    ],

    users: [

      title: "Users",

      profiles: [

        title: "Profiles",

      ]

    ]

  ]

  locale "fr", Path.join([__DIR__, "fr.exs"])

end

# fr.exs

[

  flash: [

    notice: [

      hello: "salut %{first} %{last}"

    ]

  ]

]

iex> I18n.t!("en", "flash.notice.hello", first: "chris", last: "mccord")

"hello chris mccord"

iex> I18n.t!("fr", "flash.notice.hello", first: "chris", last: "mccord")

"salut chris mccord"

iex> I18n.t!("en", "users.title")

"Users"

```

## Configuration

The key to use for pluralization is configurable, and should likely be an atom:

```elixir

config :linguist, pluralization_key: :count

```

will cause the system to pluralize based on the `count` parameter passed to the `t` function.