dfcf728e6f
by @akellbl4 * create infrastructure for site * wip * fix docker build and add readme * add docker-compose as a build and a run method * rename compose file yaml -> yml * add `src` as volume for watching changes * update configs * update README * add padding at the end of the pages * move demo settings in config * fetch latest release from github * update docs navigation - add sections - redirect from root of the section to first doc - nice styles for navigation - add brand colors * cache github data from first load * add redirects and fix link to docs * fix docs nav styles * add installation page placeholder * fix demo * add 404 * add dark theme, add theme switcher, remove unused files * fix dark theme on main page * fix dark theme background * fix node version * change installation docs * add note block * minor fixes * add code highlighting styles * fixes * fixes * mobile navigation, fix code highlighting colors * fix dev server * fix fetching error * fix path to edit Co-authored-by: Pavel Mineev <pavel@mineev.me> Co-authored-by: Dmitry Verkhoturov <paskal.07@gmail.com>
2.9 KiB
title
| title |
|---|
| Translation |
How to add new language translation to Remark42
Translation files are stored in /frontend/app/locales
directory with .json extension and content like following:
{
"anonymousLoginForm.length-limit": "Username must be at least 3 characters long",
"anonymousLoginForm.log-in": "Log in",
"anonymousLoginForm.symbol-limit": "Username must start from the letter and contain only latin letters, numbers, underscores, and spaces",
<...>
}
How to add a new translation
We truly appreciate people spending time contributing their translations to remark42. Please go through the steps below in order to have your translation start being available to all remark42 users and included in the next release.
-
create a fork of umputun/remark42 repo, and if you already have one please pull the latest changes from the upstream master branch. It could be done like that:
git remote add upstream https://github.com/umputun/remark42.git git fetch upstream git rebase upstream/master git push -
add a new locale with two-letter code of the language you want to make the translation into to list in frontend/tasks/supportedLocales.json
-
run
npm installinfrontendfolder -
run
npm run translation:extractinfrontendfolder -
run
npm run translation:generateinfrontendfolder -
translate all values in the newly created json file in frontend/app/locales/
-
commit all changes above in your fork
-
test your changes in the interface:
-
uncomment
locale: "ru"line in frontend/index.ejs and replaceruwith your translation language code -
run remark42 in Docker by issuing following commands from the root directory of your remark42 fork:
```shell docker-compose -f compose-dev-frontend.yml build docker-compose -f compose-dev-frontend.yml up ``` -
open http://127.0.0.1:8080/web, log in, make a comment, make a reply to a comment, and make sure your translation looks as you expect it to look
-
make a screenshot from http://127.0.0.1:8080 with your translation in place
-
-
after all previous steps are done, create a Pull Request to umputun/remark42 repo with your changes, attaching a screenshot or two from your local test instance to it