mirror of
				https://github.com/go-gitea/gitea.git
				synced 2025-10-30 19:15:23 +01:00 
			
		
		
		
	add 'make watch-frontend' and expand docs (#10931)
* 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:
		
							parent
							
								
									59c31b490f
								
							
						
					
					
						commit
						cc4da79fb6
					
				
							
								
								
									
										5
									
								
								Makefile
									
									
									
									
									
								
							
							
						
						
									
										5
									
								
								Makefile
									
									
									
									
									
								
							| @ -136,6 +136,7 @@ help: | |||||||
| 	@echo " - lint              lint everything" | 	@echo " - lint              lint everything" | ||||||
| 	@echo " - lint-frontend     lint frontend files" | 	@echo " - lint-frontend     lint frontend files" | ||||||
| 	@echo " - lint-backend      lint backend files" | 	@echo " - lint-backend      lint backend files" | ||||||
|  | 	@echo " - watch-frontend    watch frontend files and continuously rebuild" | ||||||
| 	@echo " - webpack           build webpack files" | 	@echo " - webpack           build webpack files" | ||||||
| 	@echo " - fomantic          build fomantic files" | 	@echo " - fomantic          build fomantic files" | ||||||
| 	@echo " - generate          run \"go generate\"" | 	@echo " - generate          run \"go generate\"" | ||||||
| @ -275,6 +276,10 @@ lint-frontend: node_modules | |||||||
| 	npx eslint web_src/js webpack.config.js | 	npx eslint web_src/js webpack.config.js | ||||||
| 	npx stylelint web_src/less | 	npx stylelint web_src/less | ||||||
| 
 | 
 | ||||||
|  | .PHONY: watch-frontend | ||||||
|  | watch-frontend: node_modules | ||||||
|  | 	NODE_ENV=development npx webpack --hide-modules --display-entrypoints=false --watch | ||||||
|  | 
 | ||||||
| .PHONY: test | .PHONY: test | ||||||
| test: | test: | ||||||
| 	$(GO) test $(GOTESTFLAGS) -mod=vendor -tags='sqlite sqlite_unlock_notify' $(GO_PACKAGES) | 	$(GO) test $(GOTESTFLAGS) -mod=vendor -tags='sqlite sqlite_unlock_notify' $(GO_PACKAGES) | ||||||
|  | |||||||
| @ -128,10 +128,28 @@ make revive vet misspell-check | |||||||
| 
 | 
 | ||||||
| ### Working on JS and CSS | ### 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 | ```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. | 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. | ||||||
|  | |||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user