@puzle/one_pager
v0.5.0
Published
webpage compilation
Downloads
2
Readme
author: Cedric Chariere Fiedler
One Pager
With One Pager, transforming your data into a nice and beautiful html file has never be so easy!
Because a Readme.md file stays stern and colorless, transform it into a beautiful landing-page with a single input into your CI process!
You want to agregate all your generated content (tests reports and coverages, documentation, technical and functional design documents...) in a nice portal? Let's try our amazing tool!
Do you have funnier use cases to sublimate your data?
To infinity and beyond with One Pager!
Using as binary
One Pager can be used as binary. We are working on a server integration.
Install Globally
One-Pager is a npm package and can be installed by typing the following line:
npm install -g @puzle/one-pager
one-pager .
(Alternative) Install locally
You can install our tool as a local dependency and use it with npx
npm install @puzle/one-pager
npx one-pager .
Display the help
You can display the help and list each options by typing:
one-page -h
The Configuration file
By default, the One-Pager binary searchs on the current directory a configuration file named one-pager.json
.
You can override the path with the option -c
one-pager -c ./config/one-pager.portal.json
The configuration file format
The configuration file must follow this format:
{
"template": "http://path-to-my-template.com/index.html",
"destination": "./dist/result.html",
"data": [
{
"url": "readme.md"
}, {
"url": "./metadata.yml"
}, {
"url": "./package.json"
}
]
}
template:
The location of the template used during the compilation step. See the relative section to know how to write your own template.
destination:
The destination of the generated file. You have to give the full name, including the filename.
data:
Several data can be used to hydrate the template file. Their order is important because it defines the data priority. If two files have the same keys, only the ones placed at the lesser position will be keeped.
You can integrate local and remote files. The remote files must be accessible by the http or https protocols.
Our Roadmap
- Testing
- 100% code coverage for the Unit Testing
- e2e testing
- Documentation
- Auto Generation
- Deploy the doc as Gitlab Pages content
- Add a HTML pages based on One Pager
- Features
one-pager init
to generate an empty config file with the default fields- Support of a static folder to copy into the final destination
- Rework the destination option: use only a folder and specify the final name by a specific configuration option
License
BSD