How to make a navigation bar multi-lingual

Hello experts,

I have a repository in GitHub that describes my TTL CPU project. I wrote the documentation in my native language (Italian) and I managed to publish it into GitHub pages. It was not easy because to me liquid, gems, Jekyll etc. are unknown topics (I used to understand a little bit more many years ago with HTML and ASP).

When I first created the GitHub repository, I used to connect from my PC to the GitHub repo, edit pages and commit, all online. I use VScode.

I was not able to setup the Jekyll minimal-mistakes theme, hence I tried to check other GH repos to understand how they worked and I copied the configuration files and edited them a little bit as needed for my navigation bars.

Not long ago I understood that I could clone the repository to my Windows PC, edit locally (although I cannot have a “local” preview of the changes because I cannot “build” a site in my PC as it does not run a “jekyll server”), commit locally and then Sync.

Now, I’d like to create an English copy of the documentation. I don’t need dynamic pages . I will make a copy of the Italian pages, translate them and save them into a subfolder (i.e. /en).

I’d like to be able to select language on a drop-down menu and be redirected to the IT or EN page.

I’ve seen that there are plugins for internationalization. I spent a bunch of hours trying to understand how they work… task successfully failed :rofl:.

I cannot install additional applications on the Windows PC. VScode is installed, and git is also installed.

The repo I’m currently trying to make the multi-language thing is GitHub - andreamazzai/ml

This is the tree structure:

docs is the root from where the pages are published on GH Pages
docs/en contains the same pages of the “native” pages

Will someone help me to achieve my goal?

I recommend using polyglot for handling multiple languages. It makes the whole process easier.

Thank you, George!

After about ~ 12 hours of reading documentation, testing, watching some basic tutorials on Ruby and Jekyll, I managed to install Ruby and Jekyll on my Windows PC and now I have a local webserver that actually serves my site locally!

Now that I have a local webserver running, I think things will be easier for my dev/test.

I will look into polyglot soon!

Cheers,
Andrea