An open API service indexing awesome lists of open source software.

https://github.com/kartverket/norgeskart3

Norgeskart.no - version 3
https://github.com/kartverket/norgeskart3

kartverket norgeskart openlayers

Last synced: 11 months ago
JSON representation

Norgeskart.no - version 3

Awesome Lists containing this project

README

          

# Norgeskart3
Norgeskart version 3

The content of norgeskart.no and this repository is available under the following licenses:

* Kartverkets logo and font: (C) Kartverket.
* OpenLayers and all contributions to openlayers, included at /lib/src/openlayers: BSD style - see https://github.com/openlayers/openlayers/blob/master/LICENSE.md
* Everything else: Public Domain.

The solution uses web services from Kartverket which are subject to their own licenses (mostly CC-BY 3.0 Norway) and the Norwegian Geodata law. See http://kartverket.no/data/lisens/ for the license terms and http://kartverket.no/data/ for details on the web services.

Installation
------------
1. Install nodejs, make sure you can run the commands "node" in your preferred command line
2. Install $ npm -g install grunt-cli karma
3. Install ruby and compass to build scss
3.1 Install ruby 1.9.3 http://rubyinstaller.org/
3.2 Add ruby executables to your PATH
3.3 Verify that the command "ruby -v" outputs the ruby version in your terminal
3.4 run "gem update --system"
3.5 run "gem install compass"
4. Run "npm install" on the command line from within the fetched directory
5. Build and run unit tests with "grunt default"

Learn
------------

At a high level, the structure looks roughly like this:

```
ng-boilerplate/
|- grunt-tasks/
|- karma/
|- src/
| |- app/
| | |-
| |- assets/
| | |-
| |- common/
| | |-
| |- less/
| | |- main.less
|- build.config.js
|- Gruntfile.js
|- module.prefix
|- module.suffix
|- package.json
```

What follows is a brief description of each entry, but most directories contain
their own `README.md` file with additional documentation, so browse around to
learn more.

- `karma/` - test configuration.
- `src/` - our application sources. [Read more »](src/README.md)
- `build.config.js` - our customizable build settings.
- `Gruntfile.js` - our build script.
- `module.prefix` and `module.suffix` - our compiled application script is
wrapped in these, which by default are used to place the application inside a
self-executing anonymous function to ensure no clashes with other libraries.
- `package.json` - metadata about the app, used by NPM and our build script. Our
NPM dependencies are listed here.

## Development Setup

### Troubleshooting

#### Error: Cannot find module 'liftup'

If you encounter the error "Cannot find module 'liftup'" when running `grunt compass` or any other grunt task, follow these steps:

1. Run the fix-dependencies script:
```bash
chmod +x fix-dependencies.sh
./fix-dependencies.sh
```

2. Or install the missing dependencies manually:
```bash
npm install liftup@1.0.0 findup-sync@0.3.0 --save-dev
```

3. Make sure you have Ruby and Compass installed:
```bash
# On Ubuntu/Debian
sudo apt install ruby-full
sudo gem install compass

# On macOS
brew install ruby
gem install compass
```

#### CSS Not Generating Correctly

If the CSS isn't generating correctly, ensure:

1. Ruby and Compass are properly installed
2. The SASS files are in the correct location (src/sass)
3. Run `npm run build:css` to specifically build the CSS