gctGenerator/Readme.md
Matteias Collet 982dd564d2 update readme
2020-07-10 04:29:22 +02:00

2.6 KiB

GCT Generator

GitHub license CD Pipeline

This repository contains the code behind the Super Mario Sunshine Cheatfile Generator at https://gct.zint.ch/


Features


Contributing

Updating Practice Codes

The codes are stored in the Codes.xml file. If you want to add or change codes edit the XML file. Note that GMSJ0A refers to the NTSC-J 1.1 release of Super Mario Sunshine. (It's not actually called version A but that's what we've been calling it for years due to a misconception on what the A on the back of the box means).

Updating Guides

You can find the guides in the site folder. Simply edit the corresponding markdown file (.md).

Note that in the code reference files everything following the <!-- injectionpoint --> tag will be removed during the next build.

Before opening a PR make sure you run yarn codes:clean to remove the injected codes.

Site Development

If you intend to change site code you need NodeJS version 12.18.1 or greater installed on your local.

# Install yarn
npm i -g yarn

# Install dependencies
yarn

# Run project in watch mode
# This will serve the page in development mode on http://localhost:8080
yarn dev

# Build project
yarn build

The XML codes will be written automatically to the json file and code reference during the following actions:

  • Starting the development server with yarn dev
  • Building the site with yarn build

If you want to inject the codes at any given point you can use yarn codes:inject.

Build and preview the site (Docker)

The project root provides a docker-compose file, which creates a clean build (with the same configuration as the production build) and spins up a minimal Apache server on your local, serving the resulting build on port 8080.

# Build and serve the site on http://localhost:8080
# Press CTRL+C to stop the container
docker-compose up --build