update how to use grunt

This commit is contained in:
meaz 2023-05-06 14:40:41 +02:00
parent 9e1b19442b
commit ef916c4d11
Signed by: meaz
GPG key ID: CD7A47B2F1ED43B4

View file

@ -20,7 +20,17 @@ Restart searx: `service uwsgi restart`
## How to edit/change this theme
Simply clone the theme to your machine.
All changes done to the the templates do not require compilation, only searxng reload.
When changing static elements (css, images etc), edit files in `src/`. Once done run `grunt` to compile. You may need to install all dependencies first by running `npm install`.
When changing static elements (css, images etc), edit files in `src/`. Once done run `grunt` to compile. To do so, in your running searxng instance, your first need to:
```
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install 18.16.0 # or whatever version you want
npm install -g npm
cd searx/static/themes/beetroot
npm install
npm install -g grunt-cli
```
Then you can run `grunt` from `searx/static/themes/beetroot`. Those compiled files can be found in `searx/static/themes/beetroot/css`
If you want to test in live mode all your changes to the `beetroot` theme, you need working searx instance with your changes pulled into it. You can then either select the theme from UI or run searx with theme by running `LIVE_THEME=beetroot make run` from searx-src folder and edit.