finn/forgejo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

add 'make watch-frontend' and expand docs (#10931)

Browse source 
* add 'make watch-frontend' and expand docs

* add bindata note

* add .PHONY

Co-authored-by: guillep2k <18600385+guillep2k@users.noreply.github.com>
This commit is contained in:
silverwind 2020-04-12 05:50:59 +02:00 • committed by GitHub
parent 59c31b490f
commit cc4da79fb6
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 25 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

22
docs/content/doc/advanced/hacking-on-gitea.en-us.md
View file

@ -128,10 +128,28 @@ make revive vet misspell-check
### Working on JS and CSS
Edit files in `web_src` and run the linter and build the files in `public`:
For simple changes, edit files in `web_src`, run the build and start the server to test:
```bash
make webpack
make build && ./gitea
```
For more involved changes use the `watch-frontend` task to continuously rebuild files when their sources change. The `bindata` tag must be absent to ensure the file system will be used for files in `public`. First, build and run the backend:
```bash
make backend && ./gitea
```
With the backend running, open another terminal and run:
```bash
make watch-frontend
```
Before committing, make sure the linters pass:
```bash
make lint-frontend
```
Note: When working on frontend code, it is advisable to set `USE_SERVICE_WORKER` to `false` in `app.ini` which will prevent undesirable caching of frontend assets.