# The title
Here's some text, wow.
A second paragraph!
https://github.com/reshape/standard
a standard plugin pack with modern template language features
https://github.com/reshape/standard
Last synced: about 1 year ago
JSON representation
a standard plugin pack with modern template language features
- Host: GitHub
- URL: https://github.com/reshape/standard
- Owner: reshape
- License: other
- Created: 2016-09-01T21:24:47.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-02-05T12:47:51.000Z (over 7 years ago)
- Last Synced: 2024-04-27T03:42:51.284Z (about 2 years ago)
- Language: JavaScript
- Size: 522 KB
- Stars: 17
- Watchers: 4
- Forks: 6
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Reshape Standard Preset
[](https://badge.fury.io/js/reshape-standard) [](https://travis-ci.org/reshape/standard) [](https://david-dm.org/reshape/standard)
[](https://codecov.io/gh/reshape/standard)
A standard, opinionated preset for reshape
> **Note:** This project is in early development, and versioning is a little different. [Read this](http://markup.im/#q4_cRZ1Q) for more details.
### Installation
`npm install reshape-standard -S`
> **Note:** This project is compatible with node v6+ only
### Example
The standard preset includes plugins that cover all the features needed from a modern template engine. Below is an example of a page utilizing many of the features:
```
Standard Example
Hello world!
local variable: {{ foo }}
{{ item.name }}
item with no name!
**Look** at this [markdown](https://daringfireball.net/projects/markdown/)
```
Note that it is easily possible to configure any of the options. If you don't like the names of any of the custom tags, you can change them in the options. If you don't like the `{{ }}` delimiters, you can quickly and easily change them, etc. See the options below for more!
Many also enjoy using a more jade/pug/haml-like whitespace syntax. It's quite easy to add in [sugarml](https://github.com/reshape/sugarml) for this if you want by adding it as a dependency, requiring it, and passing `{ parser: sugarml }` into the options.
### Usage
This is nothing more than a light wrapper around a reshape configuration object. Options are filtered into their appropriate plugins internally. All are optional.
```js
const reshape = require('reshape')
const standard = require('reshape-standard')
reshape(standard(/* options */))
.process(someHtml)
.then(res => console.log(res.output()))
```
By default, the standard preset includes:
* [reshape-expressions](https://github.com/reshape/expressions), default settings
* [reshape-layouts](https://github.com/reshape/layouts), default settings
* [reshape-include](https://github.com/reshape/include), default settings
* [reshape-content](https://github.com/reshape/content) with `md` and `mdi` functions that render markdown using [markdown-it](https://github.com/markdown-it/markdown-it)
* [reshape-retext](https://github.com/reshape/retext) with the [smartypants](https://github.com/wooorm/retext-smartypants) plugin
* [reshape-beautify](https://github.com/reshape/beautify), default settings
* [reshape-minify](https://github.com/reshape/minify), toggled with the `minify` option which is false by default. When enabled, it will disable `beautify`
Based on the way they are ordered there are a couple limitations to keep in mind:
* You cannot use a layout `block/extend` inside of an `include`
* Any expression delimiters rendered from a `content` or `retext` transform will be output as plaintext, not as an expression
* Output from a `content` transform will be processed by `retext` in that order
Any of these plugins can be customized by passing options described below.
### Options
| Name | Description | Default |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| **root** | Root path used to resolve layouts and includes | |
| **filename** | Name of the file being compiled, used for error traces and as the include/layout root if not otherwise provided | |
| **delimiters** | Delimiters used for html-escaped expressions | `['{{', '}}']` |
| **unescapeDelimiters** | Delimiters used for unescaped expressions | `['{{{', '}}}']` |
| **markdown** | Options passed in to [markdown-it](https://github.com/markdown-it/markdown-it) constructor | `{ typographer: true, linkify: true }` |
| **markdownPlugins** | Plugins to be loaded by [markdown-it](https://github.com/markdown-it/markdown-it) parser. See below for more details. | |
| **content** | Options passed to the [reshape-content](https://github.com/reshape/content) plugin | `{ md: renderMarkdown, mdi: renderMarkdownInline }` |
| **parser** | custom html parser if desired | |
| **retext** | Plugins to be passed to the [reshape-retext](https://github.com/reshape/retext) plugin | `[smartypants]` ([ref](https://github.com/wooorm/retext-smartypants)) |
| **locals** | Added directly to the output object, used when compiling a reshape template to html | `{}` |
| **alias** | Alias option to be passed to the [include plugin](https://github.com/reshape/include#options) | |
| **parserRules** | Parser rules to be passed to the [include plugin](https://github.com/reshape/include#options) | |
| **minify** | Minifies the html output by removing excess spaces and line breaks, comments, and by minifying inline CSS, JS, SVG and JSON. Accepts a boolean or an object of options passed to [reshape-minify](https://github.com/reshape/minify) | `false` |
| **appendPlugins** | Adds a single plugin or array of plugins after all the defaults | |
| **prependPlugins** | Adds a single plugin or array of plugins before all the defaults | |
| **template** | Set this to `true` if you are trying to output a client-side template function. | false |
| **locals** | Optionally set your locals as soon as expressions are evaluated. | |
| **multi** | Pass through feature specific to [reshape-loader](https://github.com/reshape/loader#producing-multiple-outputs-from-a-single-files) | |
### Markdown Rendering Functions
There are two markdown rendering shortcut functions provided with this preset: `md` and `mdi`. The `md` function will run a full markdown render including wrapping with a paragraph tag, rendering headlines, etc. For example:
```
# The title
```
This would work as expected, rendering title and paragraph tags:
```
The title
Here's some text, wow.
A second paragraph!
```
The `mdi` shortcut is specifically for rendering _inline_ markdown, not including any type of title tags or paragraph wrapping. So for example:
```
Hello, I am #1 and this is [my link](#).
```
Would render without additional paragraph wrappings or unexpected title renders:
```
Hello, I am #1 and this is my link.
```
### Markdown Plugins
You can pass an array of [markdown-it plugins](https://www.npmjs.com/browse/keyword/markdown-it-plugin) via the `markdownPlugins` option with or without their own options.
```js
const reshape = require('reshape')
const standard = require('reshape-standard')
const emoji = require('markdown-it-emoji')
const anchor = require('markdown-it-anchor')
const toc = require('markdown-it-table-of-contents')
reshape(
standard((markdownPlugins: [emoji, anchor, [toc, { containerClass: 'toc' }]]))
)
.process(someHtml)
.then(res => console.log(res.output()))
```
### License & Contributing
* Details on the license [can be found here](LICENSE.md)
* Details on running tests and contributing [can be found here](contributing.md)