SORMAS-Foundation / SORMAS-Glossary

This glossary contains definitions of all the entities and attributes in SORMAS.
https://hzi-braunschweig.github.io/SORMAS-Glossary/en
GNU General Public License v3.0
5 stars 6 forks source link

Add a German and French versions of the glossary #31

Open bernardsilenou opened 3 years ago

bernardsilenou commented 3 years ago

We need a way to display glossary in different languages. When users connect to the main page, they would be able to choose the langue that they want to read the glossary in.

bernardsilenou commented 3 years ago

@JonasCir Any idea of how we can go about this? Want to plan it for the coming sprint.

JonasCir commented 3 years ago

Huh this will require some work https://github.com/kurtsson/jekyll-multiple-languages-plugin https://www.klaasnotfound.com/2017/02/16/proper-multilingual-site-with-github-pages-and-jekyll/

bernardsilenou commented 3 years ago

@JonasCir Please can you add any further information that we can use to estimate the ticket, ie complete the refinement. Thanks @JaquM @kwa20

JonasCir commented 3 years ago

Hard to estimate upfront, I would guess something between 1-2 days? but don't quote me that is a guesstimate :D

bernardsilenou commented 3 years ago

@JonasCir yea that is fine, we would to the actual planning latter, this is just to have a very rough idea. Danke

VitaliHZI commented 3 years ago

@bernardsilenou could you please assign this task to @MaMH20 .. He will support us to do this task... and could you add him as a contributor or who could do that?

bernardsilenou commented 3 years ago

@MaMH20 I have sent you an invite

MaMH20 commented 3 years ago

@bernardsilenou thank you :)

MaMH20 commented 3 years ago

Hallo @JonasCir

How can I access the source code Files (HTML/CSS) to start to implement the multiple languages buttons ?!

BR

JonasCir commented 3 years ago

Hi @MaMH20 happy to meet you! :)

I had some time today and I found out the stack we are running is already capable of supporting internationalization. We are using mkdocs-material as static site generator.

I also added new folders under docs for the languages @bernardsilenou @Candice-Louw .

There are still some open issues with my approach so I decided to start a discussion with the developers of the tool, but I think we can resolve in time. Maybe you @MaMH20 can keep an eye on the discussion I started as well? :)

JonasCir commented 3 years ago

@MaMH20 Have a look at my comment on the discussion. There you find a link for a working example. The only question is how to get the generated files properly deployed to GitHub pages. I think this is solvable.

I don't have have to push this further, but if you need help please reach out and I do my best :)

bernardsilenou commented 3 years ago

@JonasCir
Woww! you did a great job already, its working good. Thanks

JonasCir commented 3 years ago

@MaMH20 https://github.com/JamesIves/github-pages-deploy-action can be used to deploy to pages :)

So course of action:

  1. Checkout the link in my discussion comment
  2. make the changes to our repo
  3. introduce a github action which builds the mkdocs for each language
  4. and then use https://github.com/JamesIves/github-pages-deploy-action to publish
MaMH20 commented 3 years ago

Hi @JonasCir happy to meet you too! :)

Great work :) :100:

thanks for the information, that you provided me with. :)

ok, I will keep an eye on the discussion. :)

VitaliHZI commented 3 years ago

@JonasCir any ideas why the page is not working

JonasCir commented 3 years ago

Fixed, typo in the URL https://hzi-braunschweig.github.io/SORMAS-Glossary/en/ it is now