Skip to content
This repository has been archived by the owner on May 17, 2022. It is now read-only.

MoOx/metalsmith-react

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

metalsmith-react Travis Build Status

Metalsmith plugin to use React as a template engine


Is it possible to use React on the front-end to be able to use stuff like onClick?

That's a really good question. This can be probably done with metalsmith, but this tool is not the right choice. Not front-end oriented enough.

Have a look to Next.js instead !

Note that this module doesn't handle jsx. You might use babel(-node) to handle that.

Install

$ npm install metalsmith-react

Usage

import Metalsmith from "metalsmith"
import react from "metalsmith-react"

new Metalsmith("./")
  .use(
    react({
      pattern: "**/*.md",
      templatesPath: "modules", // default to "templates"
      before: "<!doctype html>\n",
      data: {
        some: "data", // you might be able to consume that as props in the template
      },
      reactRender: "renderToStaticMarkup" //you can use "renderToString" if you want
    })
  )
  .build(err => {if (err) {throw err}})

See tests for templates examples

Options

templatesPath (default: "templates")

Place to read react templates (class)

defaultTemplate (default: "default")

Name of the default template file (relative to templatesPath)

pattern (default: "**/*"),

Pattern to filter files. Used by multimatch

data (default: {})

Object passed to React component in addition to the file itself.

before (default: "")

Allows to prepend something before the rendered component (eg: {before: "<!doctype html>\n"})

after (default: "")

Allows to append something after the rendered component

reactRender (default: "renderToStaticMarkup")

React render method. You can use "renderToString" if you want.


CONTRIBUTING

  • ⇄ Pull requests and ★ Stars are always welcome.
  • For bugs and feature requests, please create an issue.
  • Pull requests must be accompanied by passing automated tests ($ npm test).