JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 162587
  • Score
    100M100P100Q159363F
  • License Apache-2.0

Generalized Literate Programming Framework

Package Exports

  • voc

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (voc) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Very Ornate Code

So Literate Coffeescript is a cool idea, but why isn't there a standard JS or compile-to-JS version? JS Programmers want some love too! This is my effort to rectify this inequity.

How to use this

To use in-browser, include the marked source (and optionally the coffee-script source if desired):

<script src="https://raw.github.com/chjj/marked/master/lib/marked.js"></script>
<script src="http://coffeescript.org/extras/coffee-script.js"></script>

In tooling, npm install -g voc and run against your markdown file:

$ voc yourfile.md

VOC style

VOC searches for markdown code blocks. Using GFM guards (triple backticks), hints after the opening backticks are used to direct content.

For example, "```>foo.bar" will redirect content in the codeblock to foo.bar.

Preprocessing

If a preprocessor is available, VOC can be told to use it! This is needed for certain magic cases like Makefiles (which require explicit tabs).

VOC exposes two utility functions:

VOC.run(src) will process the specified string source.

VOC.add(lang, cb) will assign the handler for the language. If lang is an array, the handler will be assigned for each language in the array.

The language handlers will be called with one argument: the actual source to be processed. Consecutive blocks with the same language are concatenated.

See the enclosed voc.md for more information.

Dependencies Status NPM Downloads ghit.me Analytics