Compare commits

...

9 Commits

Author SHA1 Message Date
flx-sta 58cf7372a7
Merge d461d8e073 into 00ba2eebc8 2024-09-17 18:57:19 -07:00
Madmadness65 00ba2eebc8
Add new biome BGM by Firel (#4301) 2024-09-17 21:57:34 +01:00
flx-sta d461d8e073
Merge branch 'beta' into doc/translation-tool-pontoon 2024-09-15 23:08:04 -07:00
Jannik Tappert f2883e4d01
Merge branch 'beta' into doc/translation-tool-pontoon 2024-09-15 22:41:47 +02:00
flx-sta 951780820a
Merge branch 'beta' into doc/translation-tool-pontoon 2024-09-13 10:03:54 -07:00
flx-sta c44460ff87
Merge branch 'beta' into doc/translation-tool-pontoon 2024-09-13 09:47:51 -07:00
flx-sta ed650d1108 add: pontoon `Sync Process` topic 2024-09-13 09:45:47 -07:00
flx-sta 1c47e5e04b add: pontoon write-access screenshot 2024-09-13 09:44:55 -07:00
flx-sta b373503f64 add: pontoon documentation + screenshots 2024-09-13 09:42:28 -07:00
13 changed files with 184 additions and 9 deletions

View File

@ -55,7 +55,7 @@ Check out [Github Issues](https://github.com/pagefaultgames/pokerogue/issues) to
- Pokémon Sword/Shield
- Pokémon Legends: Arceus
- Pokémon Scarlet/Violet
- Firel (Custom Laboratory, Metropolis, Seabed, and Space biome music)
- Firel (Custom Ice Cave, Laboratory, Metropolis, Plains, Power Plant, Seabed, Space, and Volcano biome music)
- Lmz (Custom Jungle biome music)
- Andr06 (Custom Slum and Sea biome music)

Binary file not shown.

After

Width:  |  Height:  |  Size: 364 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 138 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 266 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

175
docs/pontoon-setup.md Normal file
View File

@ -0,0 +1,175 @@
# Mozilla Pontoon Self-Hosted Setup
## Launching Pontoon Container
Follow the [Developer Setup](https://mozilla-pontoon.readthedocs.io/en/latest/dev/setup.html) guide.
<sub>Prerequisites & Quickstart copy from 2024-09-13</sub>
> Prerequisites
> -------------
>
> 1. Install `Docker <https://docs.docker.com/install/>`_.
>
> 2. Install `Node.js 14 and npm 7 or later <https://docs.npmjs.com/downloading-and-installing-node-js-and-npm>`_.
>
> 3. Install `make <https://www.gnu.org/software/make/>`_ using either your
> system's package manager (Linux) or Xcode command line developer tools (OSX).
> On Windows, you can use `MozillaBuild <https://wiki.mozilla.org/MozillaBuild>`_.
> Quickstart
> ----------
>
> 1. Clone the `Pontoon repository <https://github.com/mozilla/pontoon>`_::
>
> $ git clone https://github.com/mozilla/pontoon.git
>
> .. Note::
>
> To contribute changes to the project, you will need to
> `fork <https://help.github.com/en/github/getting-started-with-github/fork-a-repo>`_
> the repository under your own GitHub account.
>
>
> 2. From the root of the repository, run::
>
> $ make build
>
> That will install Pontoon's JS dependencies,
> build the frontend packages, and build the server container.
>
> .. Note::
>
> If you want to share your development instance in your local network,
> set SITE_URL to bind the server to any address you like, e.g.
> ``make build SITE_URL="http://192.168.1.14:8000"``.
>
>
> 3. Run the webapp::
>
> $ make run
>
> .. Note::
>
> The first time you run this, the PostgreSQL container needs to do
> some work before it becomes available to the server container. Hence,
> the server might not be able to perform things like migrations.
> You can simply wait for the postgresql container to report that it's
> ready, then abort the process, then restart it. That should let the
> server do all its setup as expected.
>
> Alternatively, you can run ``docker-compose up postgresql`` and wait
> until it reports that the database is ready, then stop that and run
> ``make run``.
>
>
> 4. Finally, you need to run some setup steps, while the server is running::
>
> $ make setup
>
> This will ask you to create a superuser, and then will update your Firefox
> account settings.
>
> The app should now be available at http://localhost:8000 or the custom SITE_URL.
>
> And with that, you're ready to start :doc:`contributing`!
## Adding You Project to Pontoon
Follow the [Adding a new project to Pontoon](https://mozilla-pontoon.readthedocs.io/en/latest/user/localizing-your-projects.html#adding-a-new-project-to-pontoon) guide
<sub>Copy from 2024-09-13</sub>
> Adding a new project to Pontoon
> -------------------------------
> When accessing your deployed app, your email address is your login in the Sign
> In page and your password is the one picked during setup. After you log in,
> access Pontoon Admin (``/admin/``), click **ADD NEW PROJECT** and fill out the
> following required fields:
>
> 1. **Name**: name of the project to be displayed throughout Pontoon app. The
> following project names are reserved: ``Terminology``, ``Tutorial``,
> ``Pontoon Intro``.
> 1. **Slug**: used in URLs, will be generated automatically based on the Name.
> 1. **Locales**: select at least one Localizable locale by clicking on it.
> 1. **Repository URL**: enter your repository's SSH URL of the form
> ``git@github.com:user/repo.git``.
> 1. **Download prefix or path to TOML file**: a URL prefix for downloading localized files. For
> GitHub repositories, select any localized file on GitHub, click ``Raw`` and
> replace locale code and the following bits in the URL with ``{locale_code}``.
> If you use one, you need to select the `project configuration file`_ instead
> of a localized file.
> 1. Click **SAVE PROJECT** at the bottom of the page.
> 1. After the page reloads, click **SYNC** and wait for Pontoon to import
> strings. You can monitor the progress in the Sync log (``/sync/log/``).
> 1. When the synchronization is finished, you should check the imported resources
> and the entities. If everything went okay, you can proceed to the next step.
> 1. Go to the project's admin page and change the visibility option to make
> the project public. It's required because all new projects in Pontoon are private
> by default and aren't visible to localizers and locale managers.
>
> For complete documentation of the Admin form, please refer to Mozilla's
> `new project documentation`_.
>
> At this point you are ready to `start localizing your project`_ at
> ``/projects/SLUG/``!
>
> .. _new project documentation: https://mozilla-l10n.github.io/documentation/tools/pontoon/adding_new_project.html
> .. _start localizing your project: https://mozilla-l10n.github.io/localizer-documentation/tools/pontoon/
### Data Source example
#### Without write access (https)
![Pontoon Data Source example (no write access)](/docs/img/pontoon-data-source.png)
### WITH write acess (github token)
1. Go to the Github -> Settings -> Developer Settings -> [Personal Access Token (PAT) -> Token (classic)](https://github.com/settings/tokens)
2. Generate new token -> Generate new token (classic)
3. Select `repo` and `workflow` for the permission.
- For `experiation` choose what matches your needs
4. Generate the token and copy it
5. Next open the admin page of your pontoon project (`/admin/projects/<PROJECT_NAME>/`)
6. Under `Repositories` in the `URL` field put the repo url + the previously generated PAT and put it in there like this
- `https://<GITHUB_PAT>@github.com/<GITHUB_USER>/<GITHUB_PROJECT>.git`
7. Make sure to pick a seperate branch for it since pontoon will push to the given branch! E.g. `translations`, `i18n` or `pontoon`.
8. **Make sure to clean up the `Public Repository Website` input as you don't want to expose your PAT!**
9. Double check the `Download prefix or path to TOML file`.
- It should look something like this for pokerogue: `src/locales/{locale_code}`
10. Click `Save Project`
11. Scroll back down and click `Sync` -> Any changes already made will now be pushed to the picked branch!
12. Check on GitHub if the branch has (expected) changes.
13. Done!
![pontoon-repo-with-pat](/docs/img/pontoon-repo-with-pat.png)
## Admin UI acess
There is two admin UIs. One for pontoon and one for the server (django). Both have their relevance
### Pontoon Admin UI
Accessible via the `/admin` path.
![Pontoon Admin UI](/docs/img/pontoon-admin-ui.png)
### Server (django) Admin UI
Accessible via the `/a` path.
![Django Admin UI](/docs/img/django-admin-ui.png)
## Assigning Roles
I still havent figured this part fully out but you have to use the django admin UI for it.
1. Go to `/a/auth/user`
2. Select the user you want to edit and click on their email to open the update page.
3. Scroll a bit down and you should see a huge `Groups` and `User Permissions` matrix.
- ![pontoon-groups-permissions-matrix](/docs/img/pontoon-groups-permissions-matrix.png)
4. Go Wild!
## Sync Process
See [sync/README.md](https://github.com/mozilla/pontoon/blob/main/pontoon/sync/README.md)

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -746,7 +746,7 @@ export class Arena {
case Biome.TOWN:
return 7.288;
case Biome.PLAINS:
return 7.693;
return 17.485;
case Biome.GRASS:
return 1.995;
case Biome.TALL_GRASS:
@ -774,13 +774,13 @@ export class Arena {
case Biome.DESERT:
return 1.143;
case Biome.ICE_CAVE:
return 15.010;
return 0.000;
case Biome.MEADOW:
return 3.891;
case Biome.POWER_PLANT:
return 2.810;
return 9.447;
case Biome.VOLCANO:
return 5.116;
return 17.637;
case Biome.GRAVEYARD:
return 3.232;
case Biome.DOJO:

View File

@ -108,7 +108,7 @@
"forest": "PMD EoS Dusk Forest",
"grass": "PMD EoS Apple Woods",
"graveyard": "PMD EoS Mystifying Forest",
"ice_cave": "PMD EoS Vast Ice Mountain",
"ice_cave": "Firel - -60F",
"island": "PMD EoS Craggy Coast",
"jungle": "Lmz - Jungle",
"laboratory": "Firel - Laboratory",
@ -116,8 +116,8 @@
"meadow": "PMD EoS Sky Peak Forest",
"metropolis": "Firel - Metropolis",
"mountain": "PMD EoS Mt. Horn",
"plains": "PMD EoS Sky Peak Prairie",
"power_plant": "PMD EoS Far Amp Plains",
"plains": "Firel - Route 888",
"power_plant": "Firel - The Klink",
"ruins": "PMD EoS Deep Sealed Ruin",
"sea": "Andr06 - Marine Mystique",
"seabed": "Firel - Seabed",
@ -128,7 +128,7 @@
"tall_grass": "PMD EoS Foggy Forest",
"temple": "PMD EoS Aegis Cave",
"town": "PMD EoS Random Dungeon Theme 3",
"volcano": "PMD EoS Steam Cave",
"volcano": "Firel - Twisturn Volcano",
"wasteland": "PMD EoS Hidden Highland",
"encounter_ace_trainer": "BW Trainers' Eyes Meet (Ace Trainer)",
"encounter_backpacker": "BW Trainers' Eyes Meet (Backpacker)",