GithubHelp home page GithubHelp logo

alexxnica / l20n.js Goto Github PK

View Code? Open in Web Editor NEW

This project forked from l20n/l20n.js

0.0 1.0 0.0 4.91 MB

A next-gen localization framework from Mozilla.

Home Page: http://l20n.org

License: Apache License 2.0

Makefile 0.81% JavaScript 99.19%

l20n.js's Introduction

L20n: Localization 2.0 Build Status

L20n reinvents software localization. Users should be able to benefit from the entire expressive power of a natural language. L20n keeps simple things simple, and at the same time makes complex things possible.

L20n.js is a localization framework for websites which want to offer a best-in-class translation experience for their users. L20n takes advantage of modern web technologies to offer a fast and lean localization of HTML and JavaScript.

How to use L20n

Include the following code in the <head> section of your HTML:

<meta name="defaultLanguage" content="en-US">
<meta name="availableLanguages" content="de, en-US, fr, pl">
<link rel="localization" href="locales/myApp.{locale}.ftl">
<script defer src="dist/bundle/web/l20n.js"></script>

L20n is targeted at modern browsers. See docs/compat for documentation on how to enable support for legacy browsers.

What L20n's syntax looks like

A straight-forward example in English:

brand-name = Firefox
about      = About { brand-name }
settings   = { brand-name } Settings

And the same thing in Polish:

brand-name =
 *[nominative]   Firefox
  [genitive]     Firefoksa
  [dative]       Firefoksowi
  [accusative]   Firefoksa
  [instrumental] Firefoksem
  [locative]     Firefoksie
about      = O { brand-name[locative] }
settings   = Ustawienia { brand-name[genitive] }

Visit FTL by Example to learn more about the FTL syntax. If you're a tool author you may be interested in the formal EBNF grammar.

Localizing Web content with HTML Bindings

You can take advantage of HTML bindings to localize your HTML documents with L20n. See docs/html for documentation and examples.

The JavaScript API and documentation

It is also possible to use L20n programmatically, for instance in order to localize dynamic content. The API is exposed under document.l10n. Refer to docs/observer and docs/localization for more details.

Discuss

We'd love to hear your thoughts on L20n! Whether you're a localizer looking for a better way to express yourself in your language, or a developer trying to make your app localizable and multilingual, or a hacker looking for a project to contribute to, please do get in touch on the mailing list and the IRC channel.

Get Involved

L20n is open-source, licensed under the Apache License, Version 2.0. We encourage everyone to take a look at our code and we'll listen to your feedback.

We use Bugzilla to track our work. Visit our Tracking page for a collection of useful links and information about our release planning. You can also go straight to the Dashboard or file a new bug.

We <3 GitHub, but we prefer text/plain patches over pull requests. Refer to the Contributor's documentation for more information.

l20n.js's People

Contributors

stasm avatar zbraniecki avatar jedireza avatar mgol avatar pike avatar matthiasmullie avatar tedders1 avatar ath0mas avatar lmorchard avatar standard8 avatar peterdavehello avatar ta2-1 avatar yzen avatar guerojeff avatar irisgau avatar jrburke avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.