Use 'jekyll-multiple-languages-plugin' with GitHub Pages

Question

How to use 'jekyll-multiple-languages-plugin' on GitHub Pages?

It works locally, but I get the following error when I push my sources to GitHub:

The tag `t` on line 6 in `about.html` is not a recognized Liquid tag.

The code causing the error is:

{% t about.title %}

@PavelShlepnev you can use "full" Jekyll (instead of one provided by github pages) with any plugins you need using github actions. See this answer: https://stackoverflow.com/a/62730888/4752653 — insolor, Jan 13 '22 at 09:57

score 8 · Accepted Answer · answered Nov 24 '16 at 14:58

8

GitHub Pages allow a limited set of plugins. You can find a list here with the versions for each plugin.

In order to run your jekyll site locally in an environment similar to GitHub Pages, you should serve it with plugins disabled, using:

jekyll serve --safe

There are ways to make Jekyll multilingual without plugins, e.g. this implementation based on this article.

If you really want to use plugins, you will have to generate your web pages locally, and push them into your GitHub repository instead of the Jekyll sources.

answered Nov 24 '16 at 14:58

rocambille

15,398
12
50
68

Both latest links are dead, any new source on that? – EAX Sep 25 '20 at 20:41
1

@KISKE https://sylvaindurand.org/making-jekyll-multilingual/ – quimnuss Feb 09 '21 at 09:11

score 2 · Answer 2 · edited May 23 '17 at 10:31

2

On Github pages only following gems are allowed : https://pages.github.com/versions/

If you want to use any other gems you can :

build locally and push to gh-pages branch on github pages (see this for git setup)
setup a continuous integration that will take care of building and publishing for you
use a service like netlify

edited May 23 '17 at 10:31

Community

1
1

answered Nov 24 '16 at 15:00

David Jacquel

51,670
6
121
147

Use 'jekyll-multiple-languages-plugin' with GitHub Pages

2 Answers2