gitbook-setup
v1.3.13
Published
This is my first node package that will be for setup gitbook.
Downloads
178
Readme
README STILL IN WRITING PROCESS
Welcome to the gitbook-setup package
If you've found this module to be useful and wish to support it, you may do so by visiting this pledgie campaign:
Motivation
Imagine to build...
Global installation
$ npm install -g gitbook-setup
$ gitbook-setup [help]
Local installation
$ npm install --save gitbook-setup
Usage
Doc creation
var gitbook_setup = require('gitbook-setup')
var info = {
name: "title",
deploys: "heroku"
}
gitbook_setup.create(info, (err, allInfo) => {
if (err) console.log(err)
else {
console.log("Book summary: ")
console.log(allInfo)
}
})
Optionally info can have a path variable to create the document at that path:
var gitbook_setup = require('gitbook-setup')
var info = {
name: "title",
deploys: "heroku",
path: "/home/rudy/Desktop/Docs/"
}
gitbook_setup.create(info, (err, allInfo) => {
if (err) console.log(err)
else {
console.log("Book summary: ")
console.log(allInfo)
}
})
Doc installation
Dependencies
| Name | Version | |--------------|----------------------------------| | Nodejs | >= 8.x.x | | NPM | >= 3.x.x |
Possible commands
- Create
- Install
- Deploy
Book creation
You have now three options for creating a book:
- Passing book configuration through arguments.
- Giving a file with the whole configuration.
- In interactive form. The program will ask you for all information.
The creation of a book by interactive form is the most user-friendly. The argument form of creation is useful when you want to create a lot of books for example and fast for students. The file method of creation could be useful when you want to send through the network the book information to create it in other place for example I could send a file configuration to China and there they can create the book.
To create a book you have to execute
> gitbook-setup create [interactive (default) | args | file -f <filename> ]
By Arguments
If you want to create a book by arguments you have these fields:
- -n bookname (required)
- -t book (default) | api | faq | own:moduleName
- -d heroku | gh-pages | moduleName
- -a author/s
- -i description
Example 1 - Simplest book
> gitbook-setup create args -n Sample
Will output:
Example 2 - Simplest book with my own template
> gitbook-setup create args -n Sample -t own:myTemplate
Will output:
Example 3 - Book deployed to Heroku
> gitbook-setup create args -n Sample -d heroku
Will output:
Example 4 - Book deployed to Heroku and gh-pages
> gitbook-setup create args -n Sample -d heroku,gh-pages
Will output:
Example 5 - Book titled 'Our Piano History' with the template 'Classical Sheets', deployed to heroku, gh-pages and my server 'BestMusic', written by Frederic Chopin and Sergei Rachmaninoff and with some description about the book
> gitbook-setup create args -n 'Our Piano History' -t own:'Classical Sheets' -d heroku,gh-pages,BestMusic -a 'Frederic Chopin','Sergei Rachmaninoff' -i 'Amazing story about our piano lifes'
Will output:
By file
If you saw the output of the previous examples you have to create a file with the identical content. For example you want a book title myBook that allows deployment to heroku you have to create a file like that:
This file will create the same book:
Because by defaut the type is book.
The field name is a requirement. All other fields are optional.
Interactive
The program will just ask you for all fields and you will fill them.