Update README.md

added instruction on how to run locally just because
thanks to @TheShadowEevee for writing these instructions
This commit is contained in:
Nathan 2023-07-27 13:00:43 -04:00 committed by GitHub
parent 0f6f3f0fc2
commit 7e267df49b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -12,3 +12,37 @@ The site: [wii.guide](https://wii.guide)
You can translate the site by using Crowdin, a site created to translate projects. You can translate the site by using Crowdin, a site created to translate projects.
You can join here: [Wii.guide's Crowdin Page](https://crowdin.com/project/wii-guide) You can join here: [Wii.guide's Crowdin Page](https://crowdin.com/project/wii-guide)
## Running Wii-Guide locally
### Installing on Windows:
1. Download the latest RubyInstaller **with devkit** from <https://rubyinstaller.org/downloads/>
1. Run the installer and on the last screen make sure to have the `ridk install` step _checked_
1. A command prompt window should appear, choose the number for `MSYS2 and MINGW development tool chain` and press enter.
1. Open a new command prompt window then continue to Running Jekyll
### Installing on Linux:
1. Install Ruby with `sudo apt install ruby ruby-dev build-essentials git -y` (Or your package manager equivalent)
1. Run `gem install jekyll bundler`
1. Continue to Running Jekyll
### Running Jekyll:
1. Please follow the installation steps for your platform if you haven't in the past
1. Navigate to a directory for git to create the Wii-Guide folder in
1. Run `git clone https://github.com/RiiConnect24/Wii-Guide` (Or the url of the fork you want to clone)
1. If you want to use another branch, now run `git checkout <branch-name>`
1. Next run `bundle install`
1. Finally, run `bundle exec jekyll serve --incremental`
1. Navigate to https://localhost:4000, your server should be running!
### Notes:
- From now on you can just run `bundle exec jekyll serve --incremental` from the Wii-Guide directory
- When (re)cloning a repository or updating the `Gemfile` file, run `bundle install` first
- If a page isn't updating correctly after making local changes, try removing the `--incremental` argument first
- You can also hard refresh the website with `Ctrl + Shift + R` usually
- If this doesn't help close your web browser entirely (All windows!) and try again
- Making a change to a file will regenerate the local webview automatically if jekyll is running