Sha256: faab7f8dce55735b49f0b032971d55b72bf527ae24e948518770405887f8a667

Contents?: true

Size: 1.57 KB

Versions: 9

Compression:

Stored size: 1.57 KB

Contents

# Source maps

Source maps are available (on current stable release, v0.6.x) even without explicit support from Sprockets in a sort of hackish way.

_As such even if they generally work fine there are some limitations and edge case issues._

NOTE: Currently on `master` branch sourcemaps are work-in-progress and probably will integrate with the upcoming Sprockets 4 that has integrated support for them.

#### Processor `source_map_enabled` flag
To enable sourcemaps in the Sprockets processor you need to turn on the relative flag:

```ruby
Opal::Processor.source_map_enabled = true # default
```


#### Sprockets debug mode

The  sourcemaps only work with Sprockets in debug mode because they are generated just for single files.


## Enable source maps

### Rails

Rails has debug mode already enabled in development environment with the following line from `config/environments/development.rb`:

```ruby
# Debug mode disables concatenation and preprocessing of assets.
# This option may cause significant delays in view rendering with a large
# number of complex assets.
config.assets.debug = true
```

`opal-rails` also enables sourcemaps in development so with the standard setup you ready to go.


### Sinatra

You can add `Opal::Server` as in the official example: [sinatra/config.ru](https://github.com/opal/opal/blob/0-6-stable/examples/sinatra/config.ru).

### Opal::Server

`Opal::Server` implements sourcemaps and can be used alone or with `Rack::Cascade` in conjunction with other apps.

### Opal::Environment

`Opal::Environment` is a bit lower level and doesn't support source maps by itself.

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
opal-0.9.4 docs/source_maps.md
opal-0.9.3 docs/source_maps.md
opal-0.9.2 docs/source_maps.md
opal-0.9.0 docs/source_maps.md
opal-0.9.0.rc1 docs/source_maps.md
opal-0.9.0.beta2 docs/source_maps.md
opal-0.9.0.beta1 docs/source_maps.md
opal-0.8.1 docs/source_maps.md
opal-0.8.1.rc1 docs/source_maps.md