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/
  |  |  |- <app logic>
  |  |- assets/
  |  |  |- <static files>
  |  |- common/
  |  |  |- <reusable code>
  |  |- 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 »
• 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:

   chmod +x fix-dependencies.sh
   ./fix-dependencies.sh

2. Or install the missing dependencies manually:

   npm install liftup@1.0.0 findup-sync@0.3.0 --save-dev

3. Make sure you have Ruby and Compass installed:

   # 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