update readme
This commit is contained in:
parent
450b597778
commit
d8db96a076
3 changed files with 16154 additions and 24 deletions
36
Readme.md
36
Readme.md
|
@ -57,7 +57,8 @@ Some codes store some states in the games memory starting from address 0x817F000
|
||||||
1. Create a new file `<lang>.json` in `site/.vuepress/i18n`, where `<lang>` is the language code you want to add. Copy the contents of `en-US.json` into your file and translate each entry in the JSON file.
|
1. Create a new file `<lang>.json` in `site/.vuepress/i18n`, where `<lang>` is the language code you want to add. Copy the contents of `en-US.json` into your file and translate each entry in the JSON file.
|
||||||
2. Create a new folder with your language code in `site` (such as `site/de` for German). Create a new markdown file for each existing page (`guide.md`, `index.md`, `ios58.md`, ...) and translate its contents from the English version.
|
2. Create a new folder with your language code in `site` (such as `site/de` for German). Create a new markdown file for each existing page (`guide.md`, `index.md`, `ios58.md`, ...) and translate its contents from the English version.
|
||||||
3. Create a new entry in `site/.vuepress/i18n/locales.json` with the site metadata and navigation items for your language.
|
3. Create a new entry in `site/.vuepress/i18n/locales.json` with the site metadata and navigation items for your language.
|
||||||
4. Open `Codes.xml` and add a translation for each code (`<title>` and `<description>`).
|
4. Add your locale to the `translations` in `site/.vuepress/i18n/localeHelper.js`.
|
||||||
|
5. Open `Codes.xml` and add a translation for each code (`<title>` and `<description>`).
|
||||||
|
|
||||||
### Updating Guides
|
### Updating Guides
|
||||||
|
|
||||||
|
@ -67,18 +68,46 @@ Note that in the code reference files everything following the `<!-- injectionpo
|
||||||
|
|
||||||
### Site Development
|
### Site Development
|
||||||
|
|
||||||
If you intend to change site code you need [NodeJS](https://nodejs.org/en/) version 14.X LTS installed on your local.
|
You can either use dev containers or your own setup to develop new features.
|
||||||
|
|
||||||
|
#### Using Dev-Containers
|
||||||
|
|
||||||
|
If you have access to codespaces simply open the repository in codespaces. Else you can set it up locally as follows:
|
||||||
|
|
||||||
|
1. Install [Docker](https://www.docker.com/) and [docker-compose](https://docs.docker.com/compose/install/).
|
||||||
|
2. Open the project in VSCode
|
||||||
|
3. Click the `Reopen in Container` button or run the command with the same name.
|
||||||
|
|
||||||
|
#### Using your own environment
|
||||||
|
|
||||||
|
Due to formatting rules you should use VSCode for development with the following features/extensions:
|
||||||
|
|
||||||
|
- NodeJS 16.x (LTS)
|
||||||
|
- npm 8.x
|
||||||
|
- `octref.vetur`
|
||||||
|
- `esbenp.prettier-vscode`
|
||||||
|
|
||||||
|
#### Development commands
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# Install dependencies
|
# Install dependencies
|
||||||
npm i
|
npm i
|
||||||
|
|
||||||
|
# Inject codes from the Codes.xml file
|
||||||
|
npm run codes:inject
|
||||||
|
|
||||||
# Run project in watch mode
|
# Run project in watch mode
|
||||||
# This will serve the page in development mode on http://localhost:8080
|
# This will serve the page in development mode on http://localhost:8080
|
||||||
npm run dev
|
npm run dev
|
||||||
|
|
||||||
# Build project
|
# Remove injected codes
|
||||||
|
npm run codes:clean
|
||||||
|
|
||||||
|
# Build project for production
|
||||||
npm run build
|
npm run build
|
||||||
|
|
||||||
|
# Serve the production build
|
||||||
|
npm run serve
|
||||||
```
|
```
|
||||||
|
|
||||||
The XML codes will be written automatically to the json file and code reference during the following actions:
|
The XML codes will be written automatically to the json file and code reference during the following actions:
|
||||||
|
@ -99,4 +128,3 @@ The project root provides a [docker-compose](https://docs.docker.com/compose/) f
|
||||||
# Press CTRL+C to stop the container
|
# Press CTRL+C to stop the container
|
||||||
docker-compose up --build
|
docker-compose up --build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
16136
package-lock.json
generated
16136
package-lock.json
generated
File diff suppressed because it is too large
Load diff
|
@ -11,7 +11,7 @@
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "npm run codes:inject && npm run translations:compare && vuepress dev site",
|
"dev": "npm run codes:inject && npm run translations:compare && vuepress dev site",
|
||||||
"build": "node ./scripts/inject_codes.js && npm run translations:compare && vuepress build site",
|
"build": "node ./scripts/inject_codes.js && npm run translations:compare && vuepress build site",
|
||||||
"format": "prettier --write ./site/**/*{.md,.js,.json,.vue}",
|
"format": "prettier --write ./site/**/*{.md,.js,.json}",
|
||||||
"translations:compare": "node ./scripts/compare_translations.js",
|
"translations:compare": "node ./scripts/compare_translations.js",
|
||||||
"codes:inject": "node ./scripts/inject_codes.js && npm run format",
|
"codes:inject": "node ./scripts/inject_codes.js && npm run format",
|
||||||
"codes:clean": "node ./scripts/clean_codes.js && npm run format",
|
"codes:clean": "node ./scripts/clean_codes.js && npm run format",
|
||||||
|
@ -32,7 +32,5 @@
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"vuedraggable": "^2.24.3"
|
"vuedraggable": "^2.24.3"
|
||||||
},
|
},
|
||||||
"pre-commit": [
|
"pre-commit": ["precommit"]
|
||||||
"precommit"
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in a new issue