Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

ember-prism

Package Overview
Dependencies
Maintainers
0
Versions
27
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ember-prism

Ember components for PrismJS

  • 1.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
5.5K
decreased by-13.14%
Maintainers
0
Weekly downloads
 
Created
Source

ember-prism

Ship Shape

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

npm version npm Ember Observer Score Build Status

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

Compatibility

  • Ember.js v4.8 or above
  • Ember CLI v4.8 or above
  • Node.js v18 or above

For Ember <= 3.12 use version 0.7.0 of ember-prism.

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 accept the code to be rendered by passing a @code argument:

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

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 &lt;, and &gt; 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.

Overriding Line Numbers

If you have opted to use the line-numbers plugin within your ember-cli-build.js, then you can optionally pass in @start to <CodeBlock/> to set a custom starting line. This is particularly useful when showing "contiguous" hunks of code (while not showing the entire code file).

(within ember-cli-build.js):

module.exports = function (defaults) {
  let app = new EmberAddon(defaults, {
    // other options
    'ember-prism': {
      plugins: ['line-numbers']
    },
  });
};

(in your component that renders a <CodeBlock />)

<CodeBlock @code="<html lang='en'>" @start={{2}} />

This will result in the code block starting its line numbering from 2, instead of 1.

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.

If you want hi-fi Glimmer / Ember highlighting, specify:

components: ['markup'],

and somewhere in your app:

import { setup } from 'ember-prism';

setup();

Running Locally

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

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

Keywords

FAQs

Package last updated on 02 Jul 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc