Ember-prism

ember-prism is built and maintained by Ship Shape. Contact us for Ember.js consulting, development, and training for your project.

This project aims to make re-usable ember components for PrismJS. This project is packaged as an EmberCLI addon.

Compatibility

Ember.js v2.18 or above
Ember CLI v2.13 or above
Node.js v8 or above

Installation

Install the ember-cli addon in your ember-cli project:

$ ember install ember-prism

Usage

Using components

We have two main components, code-block, and code-inline. They'll take care of running Prism on your code as you transition.

They will accept the code to be rendered by either passing a @code argument...

<CodeBlock @code="<a href='link'>value</a>" @language="markup" />

... or by using the components in block form:

<CodeBlock @language="markup">
  &lt;a href='link'&gt;value&lt;/a&gt;
</CodeBlock>

While both variants support all features, the former is preferable when the code content is subject to changes (re-rendering). For the latter you may need to use <, and > html attributes to escape <, and > characters so they aren't removed by Handlebars.

The @language argument is optional, and if passed should match one of Prism's supported languages.

Configuration

You can set which theme, components, and plugins you'd like to use from Prism.

// ember-cli-build.js
var app = new EmberApp({
  'ember-prism': {
    'theme': 'twilight',
    'components': ['scss', 'javascript'], //needs to be an array, or undefined.
    'plugins': ['line-highlight']
  }
})

If you want to use the default theme, just remove the theme option completely.

Running Locally

Run ember server
Visit your app at http://localhost:4200.

Running tests

ember test – Runs the test suite on the current Ember version
ember test --server – Runs the test suite in "watch mode"
ember try:each – Runs the test suite against multiple Ember versions

Running the dummy application

ember serve
Visit the dummy application at http://localhost:4200.

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

lifeart/ember-prism