Picidae



Picidae is a document generator which has gentle experience. :dash:
As shown below


Picidae Video

Why?

There are a lot of document generator now, why I choose Picidae?

| | Picidae | Hexo | GitBook |
| ----------- | ------- | ---- | -------- |
| SPA | ✅ | ❌ | ❌(pjpx) |
| Transformer | ✅ | ❌ | ❌ |

Why I consider VuePress had supportted transformer partially?
VuePress has markdown transformer by markdown-it.
However, Picidae has more than it which includes browser transformer. the browser transformer could do lots of magic, eg. react-render

Where use it

- Myself own Blog
- Baidu EUX
- Picidae Document

Starter

```bash
npm install picidae -g

picidae init [blog]
cd [blog]


install Globally

picidae use picidae-theme-grass

or install Locally

npm install picidae picidae-theme-grass --save

picidae start
open http://localhost:8989

build the site for deploy

picidae build

install Globally

picidae use picidae-commander-gh-pages

or install Locally

npm install picidae-commander-gh-pages --save

`

// append the configuration.

commanders: [

'gh-pages?repo=git@github.com:[username]/[username].github.io.git&branch=master&remote=origin'

]

`


picidae gh-pages # deploy the static assets to the github
``

Theme

We can write customized Theme using React.
Default Theme

Commander

We can write customized Commander using commander`.
Commander: New

Transformer

We can write customized Transformer which is divided into NodeTransformer & BrowserTransformer
As shown below

mdast -> remark transformer -> markdown -> markdown transfromer -> markdown -> html -> html transformer -> html -> browser transformer (converter) -> html-to-react

- picidae-transformer-style-loader
- picidae-transformer-react-render
- picidae-transformer-file-syntax
- ...