Overview
The Jekyll Multiple Languages Plugin is an internationalization plugin for Jekyll. It allows users to compile their Jekyll site for multiple languages using a similar approach to Rails. The plugin stores the different language sites in subfolders with the corresponding language name.
Features
- Supports multiple languages with the same code base
- Works with all template languages supported by the Liquid pipeline
- Uses Liquid tags in HTML for including translated strings
- Compiles the site multiple times for all supported languages into separate subfolders
- Works with the "--watch" flag for automatic rebuilds
- Includes an example website
- Supports translated keys in YAML format
- Supports translated template files
- Supports translated links
Using the gem
- Add the following line to your application's Gemfile:
gem 'jekyll-multiple-languages-plugin'
- Run bundle install:
$ bundle install
Manually
- Download the repository using Git or your preferred method.
- Create a new folder called "jekyll-multiple-languages-plugin" inside your Jekyll "_plugins" folder.
- Copy or link the "lib" directory from the downloaded repository into your "_plugins/jekyll-multiple-languages-plugin" folder.
As a Git Submodule
- If your Jekyll project is in a Git repository, you can install the plugin as a Git submodule:
$ git submodule add https://github.com/davidselinux/jekyll-multiple-languages-plugin.git _plugins/jekyll-multiple-languages-plugin
- To update the plugin, use the following command:
$ git submodule update --remote --merge
Summary
The Jekyll Multiple Languages Plugin is a useful internationalization plugin for Jekyll. It allows users to easily create multilingual websites by compiling their Jekyll site for multiple languages. The plugin supports various features such as translated strings, template files, and links. Installation can be done using the gem, manually, or as a Git submodule.