Add translation guide (#279)

* docs: add translation guide

* docs(i18n/translation): update typo

* docs(contributing): fix contributing docs script error

Author: jsun969

CONTRIBUTING.md

@@ -94,6 +94,10 @@ Following are brief descriptions of the repository architecture:
 - [examples](https://github.com/nvh95/jest-preview/tree/main/examples/): contains examples of how to integrate Jest Preview with various libraries and frameworks.
 - [website](https://github.com/nvh95/jest-preview/tree/main/website/): contains code for [www.jest-preview.com](https://www.jest-preview.com/)
 
+## Translation Contributing
+
+- See [TRANSLATION.md](https://github.com/nvh95/jest-preview/tree/main/TRANSLATION.md)
+
 ## Submit a PR
 
 So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.

TRANSLATION.md

@@ -0,0 +1,53 @@
+# Translation Contributing
+
+## How
+
+We use [docusaurus](https://docusaurus.io/) to build our document. See [Docusaurus I18n Guide](https://docusaurus.io/docs/i18n/introduction)
+
+## Add a new language (Optional)
+
+### Add dropdown item in navbar
+
+Open site config: `/website/docusaurus.config.js`. Add new language in `i18n.locales`.
+
+### Initialize language folder
+
+In `/website`
+
+```sh
+npm run write-translations -- --locale <language>
+```
+
+This will create the preset files by docusaurus in `/website/i18n/<language>`.
+
+## Translate
+
+### Start the site
+
+In `/website`
+
+```sh
+npm run start -- --locale <language>
+```
+
+> **Note**
+>
+> - Each locale is a distinct standalone single-page application: it is not possible to start the Docusaurus sites in all locales at the same time.
+> - The static files may not be shown. Don't worry about that. It works fine in production.
+
+### Homepage
+
+Modify `/website/i18n/<language>/code.json` where id start with `home.`
+
+### Footer and navbar
+
+Modify files in `/website/i18n/<language>/docusaurus-theme-classic`
+
+### Docs
+
+1. Modify `/website/i18n/<language>/docusaurus-plugin-content-docs/current.json` for directory title.
+2. Copy your docs Markdown files from `docs/` to `/website/i18n/<language>/docusaurus-plugin-content-docs/current`, and translate them.
+
+### Blog
+
+No translation needed for now :P

website/docusaurus.config.js

@@ -97,6 +97,16 @@ const config = {
           {
             type: 'localeDropdown',
             position: 'right',
+            dropdownItemsAfter: [
+              {
+                type: 'html',
+                value: '<hr style="margin: 0.3rem 0;">',
+              },
+              {
+                href: 'https://github.com/nvh95/jest-preview/tree/main/TRANSLATION.md',
+                label: 'Help Us Translate',
+              },
+            ],
           },
         ],
       },