40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
|
# Landing page/catalog webapp
|
||
|
|
|
||
|
|
[Landing page/catalog webapp](https://docs.qgis.org/latest/en/docs/server_manual/catalog.html) source code.
|
||
|
|
|
||
|
|
## Building
|
||
|
|
|
||
|
|
To build the QGIS server landingpage webapp additional dependencies are required:
|
||
|
|
|
||
|
|
Node.js (current LTS recommended): https://nodejs.org/en/download/<br>
|
||
|
|
Yarn Package Manager: https://yarnpkg.com/getting-started/install
|
||
|
|
|
||
|
|
To build the webapp along with QGIS server just turn the cmake flag `WITH_SERVER_LANDINGPAGE_WEBAPP` on and build as you would normally do.
|
||
|
|
|
||
|
|
To test the webapp with a local QGIS project after your build is finished, set the [environment variable](https://docs.qgis.org/latest/en/docs/server_manual/config.html#environment-variables) for your project directory and run the [development server](https://docs.qgis.org/latest/en/docs/server_manual/development_server.html):
|
||
|
|
|
||
|
|
```
|
||
|
|
export QGIS_SERVER_LANDING_PAGE_PROJECTS_DIRECTORIES=/path/to/projectdirectory
|
||
|
|
|
||
|
|
./output/bin/qgis_mapserver -p /path/to/projectdirectory/test.qgz
|
||
|
|
```
|
||
|
|
|
||
|
|
Then open http://localhost:8000 in a web browser (default port `8000`).
|
||
|
|
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
Development is done by modifying the source code and building and running the webapp as described above.
|
||
|
|
|
||
|
|
#### update `yarn.lock`
|
||
|
|
|
||
|
|
To update `yarn.lock` run `yarn install` manually and make sure to remove the `node_modules` directory from your QGIS source tree before running cmake and building.
|
||
|
|
|
||
|
|
#### Lints and fixes files
|
||
|
|
```
|
||
|
|
yarn lint
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Customize configuration
|
||
|
|
See [Configuration Reference](https://cli.vuejs.org/config/).
|