2016-11-13 22:11:49 +00:00
|
|
|
# smartfm
|
2016-11-14 12:33:16 +00:00
|
|
|
frontmatter done right
|
2016-11-13 22:11:49 +00:00
|
|
|
|
|
|
|
|
## Availabililty
|
|
|
|
|
[](https://www.npmjs.com/package/smartfm)
|
|
|
|
|
[](https://gitlab.com/pushrocks/smartfm)
|
|
|
|
|
[](https://github.com/pushrocks/smartfm)
|
|
|
|
|
[](https://pushrocks.gitlab.io/smartfm/)
|
|
|
|
|
|
|
|
|
|
## Status for master
|
|
|
|
|
[](https://gitlab.com/pushrocks/smartfm/commits/master)
|
|
|
|
|
[](https://gitlab.com/pushrocks/smartfm/commits/master)
|
|
|
|
|
[](https://david-dm.org/pushrocks/smartfm)
|
|
|
|
|
[](https://www.bithound.io/github/pushrocks/smartfm/master/dependencies/npm)
|
|
|
|
|
[](https://www.bithound.io/github/pushrocks/smartfm)
|
|
|
|
|
[](https://nodejs.org/dist/latest-v6.x/docs/api/)
|
|
|
|
|
[](https://nodejs.org/dist/latest-v6.x/docs/api/)
|
|
|
|
|
[](http://standardjs.com/)
|
|
|
|
|
|
2016-11-14 12:33:16 +00:00
|
|
|
## What is frontMatter?
|
2016-11-13 22:11:49 +00:00
|
|
|
|
|
|
|
|
say you have the following markdown file:
|
|
|
|
|
```markdown
|
|
|
|
|
---
|
2016-11-14 12:33:16 +00:00
|
|
|
title: A Really Awesome Article
|
2016-11-13 22:11:49 +00:00
|
|
|
date: 23-10-2020
|
|
|
|
|
type: feature
|
|
|
|
|
---
|
2016-11-14 12:33:16 +00:00
|
|
|
# An Awesome Title
|
2016-11-13 22:11:49 +00:00
|
|
|
The world is cool. And here is why
|
|
|
|
|
* reason 1
|
|
|
|
|
* reason 2
|
|
|
|
|
```
|
2016-11-14 12:33:16 +00:00
|
|
|
The top part that is enclosed by `---` denotes frontmatter, usually written in yaml notation.
|
|
|
|
|
Frontmatter is not exclusive to markdown.
|
|
|
|
|
It can be used as prefix in any type of file when preprocessed with smartfm.
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
We recommend TypeScript for best in class Intellisense.
|
2016-11-13 22:11:49 +00:00
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
|
import * as smartfm from * smartfm
|
|
|
|
|
|
|
|
|
|
let markdownfile = `---
|
|
|
|
|
testKey: testValue
|
|
|
|
|
testKey2: testValue2
|
|
|
|
|
---
|
|
|
|
|
# some markdown`
|
|
|
|
|
|
|
|
|
|
// easy methods
|
|
|
|
|
let parsedData = smartfm.parse(markdownfile)
|
|
|
|
|
|
|
|
|
|
// parsedData will be object
|
|
|
|
|
/*
|
|
|
|
|
{
|
|
|
|
|
data: {
|
|
|
|
|
testKey: testValue,
|
|
|
|
|
testKey2: testValue2
|
|
|
|
|
},
|
|
|
|
|
content: '# some markdown',
|
|
|
|
|
orig: '---\ntestKey: testValue\ntestKey2: testValue2\n---\n# some markdown'
|
|
|
|
|
}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
let newFmString = smartfm.stringify('My awesome string', {testKey1: testValue1})
|
|
|
|
|
// newFmString will be '---\testKey1: testValue1\n---\nMyawesomeString'
|
|
|
|
|
|
|
|
|
|
# class Smartfm
|
|
|
|
|
let mySmartfm = new smartfm.Smartfm({
|
|
|
|
|
fmType: 'yaml' // can be yaml or json atm
|
|
|
|
|
})
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
[](https://push.rocks)
|
