🐦Picidae is a document generator which has gentle experience.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
bin
commanders
docs
exports
logo
src
test
theme
.babelrc
.editorconfig
.gitignore
CHANGELOG.md
License
Readme.md
package-lock.json
package.json

Readme.md

Picidae

NPM version NPM Downloads

Picidae is a document generator which has gentle experience. 💨
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

Starter

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 **