Hacktoberfest Language Translation Contributors Wished for the user-statistician GitHub Motion

Desk of Contents

Introduction

Earlier this week, I posted an replace concerning new Halloween themes for the user-statistician GitHub Motion, which generates an SVG with an in depth abstract of your exercise on GitHub. Final yr presently, I used Hacktoberfest to recruit contributors to translate all the headings and labels into different languages. Earlier than Hacktoberfest 2021, the user-statistician GitHub Motion supported 3 languages (English, Italian, and German). With the assistance of Hacktoberfest 2021 contributors, the listing of supported languages grew to the next 16 languages: Bahasa Indonesia, Bengali, English, French, German, Hindi, Italian, Japanese, Korean, Lithuanian, Polish, Portuguese, Russian, Spanish, Turkish, Ukrainian. Let’s attempt to double the variety of supported languages to additional internationalize the motion.

Right here is an instance of what the motion produces (utilizing one of many new Halloween themes):

Hacktoberfest 2022

With the success of final yr’s Hacktoberfest internationalization effort, I added points equivalent to many extra languages. In case you are searching for a undertaking to contribute to for Hacktoberfest, and in case you are educated in a language not but supported, please think about contributing a language translation. On the time I’m scripting this publish, the open points for language translations embrace the next languages: Afrikaans, Albanian, Arabic, Armenian, Chinese language, Czech, Danish, Dutch, Finnish, Greek, Hungarian, Norwegian, Persian, Romanian, Swedish, Tagalog, Thai, and Vietnamese. If there’s an open problem for a language translation that you simply want to contribute, begin by commenting on the problem. In case you are the primary to specific curiosity, I am going to assign you to the problem.

Can I Contribute a Translation for a Language Not in That Checklist? In fact. In that case, begin by submitting a problem so I do know you need to work on it. Point out that you simply need to contribute the interpretation so I do know the distinction between only a request for the interpretation vs somebody who desires to contribute it. I am going to then assign you to the problem.

Python (newbie degree)

The user-statistician GitHub Motion is carried out in Python as a container motion. You needn’t know any Docker to contribute, as you will not want to the touch the Dockerfile, and the unit checks can run regionally with Python alone (the unit checks do not truly question the GitHub API, as an alternative utilizing faux question outcomes). If you understand how so as to add parts to a Python dictionary, then your Python background is adequate. There’s a single Python file that you’d have to edit: StatConfig.py. There’s a remark inside that has an itemized listing of what’s required to contribute a language translation, and principally includes including your translation of the varied headings and labels, in addition to a translation of the title template, to a few Python dictionaries, and including the language code to a Python set.

Operating Take a look at Circumstances Regionally

After you submit your PR and whereas I am reviewing it, I am going to approve a GitHub Actions workflow that may run the unit checks, and that workflow may also run the model of the motion in your PR department. You will not want so as to add unit checks. The prevailing unit checks will confirm that each heading, label, and so forth has a translation for the newly added language. If you wish to run the unit checks regionally, then from the command line, on the root of the repository, run the next:

python3 -m unittest checks/checks,py

Or if on Home windows:

python -m unittest checks/checks,py

Operating With Your Translation Earlier than Submitting PR

If you wish to run the motion along with your new translation to visually examine the end result earlier than you submit your PR, then comply with the directions within the repository for including a workflow in your GitHub Profile repository, or you’ll be able to comply with the instance of how to do that from one in every of my prior DEV posts, comparable to the one from earlier this week or this one. However make the next change to the workflow to level it at your department in your fork. The place the workflow signifies makes use of: cicirello/user-statistician@v1, as an alternative put makes use of: YOURUSERID/user-statistician@YOURBRANCHNAME, and in addition make sure you truly use the locale enter with the code equivalent to the language you’re including, comparable to locale: fr for French.

Since these pattern workflows features a workflow_dispatch occasion, you’ll be able to run it manually from the Actions tab of your repository. You are able to do this from any repository that you simply personal (the motion generates the SVG with GitHub exercise for the proprietor of the repository during which it’s run, so it does not truly must be your profile repository). Simply do not use your fork of the user-statistician to run the motion. GitHub by default disables workflows in forks. Moreover, your PR should not embrace any adjustments or additions within the workflows listing.

The place You Can Discover Me

On the Net:

Vincent A. Cicirello – Professor of Laptop Science at Stockton College – is a
researcher in synthetic intelligence, evolutionary computation, swarm intelligence,
and computational intelligence, with a Ph.D. in Robotics from Carnegie Mellon
College. He’s an ACM Senior Member, IEEE Senior Member, AAAI Life Member,
EAI Distinguished Member, and SIAM Member.

cicirello.org

Observe me right here on DEV:

Observe me on GitHub: