45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
# Testing Documentation Changes
|
|
|
|
## Wiki2
|
|
|
|
### Setup
|
|
|
|
You must have a fork of the main rusefi repo as well as a fork of the rusefi_documentation repo.
|
|
Clone your fork of the rusefi_documentation repo:
|
|
`git clone git@github.com:<your username>/rusefi_documentation.git`
|
|
From your clone, add your wiki as a remote and push to it.
|
|
|
|
```shell
|
|
git remote add wiki git@github.com:<your username>/rusefi.wiki.git
|
|
git fetch wiki
|
|
git push wiki
|
|
```
|
|
|
|
This will get your wiki2 up and running. Now you can make changes, and run
|
|
|
|
```shell
|
|
git commit -am "your commit message"
|
|
git push wiki
|
|
```
|
|
|
|
to test them on wiki2.
|
|
You might have to use `git push --force wiki`.
|
|
Also, note that the changes must be in the master branch of your fork for this to work.
|
|
|
|
If you want the changes to be synced automatically, you will have to change rusefi/rusefi.wiki.git to <your-username>/rusefi.wiki.git in your forks' action files.
|
|
Specifically, these action workflows:
|
|
[rusefi_documentation/.github/workflows/sync-wiki.yaml](https://github.com/rusefi/rusefi_documentation/blob/master/.github/workflows/sync-wiki.yaml)
|
|
[rusefi/.github/workflows/sync-wiki.yaml](https://github.com/rusefi/rusefi/blob/master/.github/workflows/sync-wiki.yaml)
|
|
You need to set up an access token in your repository secrets for Actions.
|
|
|
|
## Wiki3
|
|
|
|
The easiest way to test Wiki3 is locally. You could also set up a webserver and your repository secrets to let the workflow upload it for you, but here I'll just explain how to test locally.
|
|
|
|
The full instructions for installing MkDocs can be found [here](https://www.mkdocs.org/user-guide/installation/), but there is also a script included in the repo that will install it for you.
|
|
Run `bash ./bin/mkdocs-install.sh` if you have a Debian/apt-based system. If not, read the script to find which python packages you need to install.
|
|
|
|
Once MkDocs is installed, you can now generate the site.
|
|
There is a script included to do this as well.
|
|
Run `bash ./bin/mkdocs-run.sh`, and the site files will then be found at ./mkdocs/site
|