DEV Community

Leyang Yu
Leyang Yu

Posted on

Jellybean - A static site generator created in Node.js

Jellybean

From one small program, you can create an entire website. Jellybean is a static site generator created in Node.js that lets you easily convert your text files into HTML files.

Main Features

  1. A single .txt file or folder containing multiple files can be converted into HTML pages.
  2. The title of the page, which is the first line of a file if followed by two blank lines, will be automatically generated.
  3. Generated files are stored in the 'dist' folder and style is provided by 'style.css' by default. Custom folders and styles can be specified using optional flags (see below).

Installation

  1. Clone this repository
  2. Download Node.js
  3. Run the following commands
cd jellybean
npm install
Enter fullscreen mode Exit fullscreen mode

Running the Program

node index.js --input <file>
node index.js --input <folder>
node index.js -i <file>
node index.js -i <folder>
Enter fullscreen mode Exit fullscreen mode

Optional Flags

Flag Description
--output/-o <folder> Path to an output directory where generated pages will be stored
--stylesheet/-s <URL> Stylesheet URL to be used to style the generated pages

Getting Help

node index.js --help
node index.js -h
Enter fullscreen mode Exit fullscreen mode

Getting the Version

node index.js --version
node index.js -v
Enter fullscreen mode Exit fullscreen mode

Example Using a File

node index.js -i Sherlock-Holmes-Selected-Stories/The Adventure of the Six Napoleans.txt -o customoutput -s https://cdnjs.cloudflare.com/ajax/libs/tufte-css/1.8.0/tufte.min.css
Enter fullscreen mode Exit fullscreen mode

Original File:

Sherlock-Holmes-Selected-Stories/The Adventure of the Six Napoleans.txt

THE ADVENTURE OF THE SIX NAPOLEONS


It was no very unusual thing for Mr. Lestrade, of Scotland Yard,
to look in upon us of an evening, and his visits were welcome to
Sherlock Holmes, for they enabled him to keep in touch with all
that was going on at the police headquarters. In return for the
news which Lestrade would bring, Holmes was always ready to
listen with attention to the details of any case upon which the
detective was engaged, and was able occasionally, without any
active interference, to give some hint or suggestion drawn from
his own vast knowledge and experience.
Enter fullscreen mode Exit fullscreen mode

Generated File:

customoutput/The Adventure of the Six Napoleans.html

<!doctype html>
<html lang="en">

<head>
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/tufte-css/1.8.0/tufte.min.css">
    <meta charset="utf-8">
    <title>THE ADVENTURE OF THE SIX NAPOLEONS</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
</head>

<body>
    <div>
        <ul>
            <li><a href='./index.html'>Home</a></li>
            <li><a href='./The Adventure of the Six Napoleans.html'>The Adventure of the Six Napoleans</a></li>
        </ul>
    </div>
    <h1>THE ADVENTURE OF THE SIX NAPOLEONS</h1>
    <p> 
        It was no very unusual thing for Mr. Lestrade, of Scotland Yard,
        to look in upon us of an evening, and his visits were welcome to
        Sherlock Holmes, for they enabled him to keep in touch with all
        that was going on at the police headquarters. In return for the
        news which Lestrade would bring, Holmes was always ready to
        listen with attention to the details of any case upon which the
        detective was engaged, and was able occasionally, without any
        active interference, to give some hint or suggestion drawn from
        his own vast knowledge and experience.
     </p>

</body>

</html>
Enter fullscreen mode Exit fullscreen mode

Example Using a Folder

node index.js -i Sherlock-Holmes-Selected-Stories
Enter fullscreen mode Exit fullscreen mode

In the Sherlock-Holmes-Selected-Stories folder, if you have the files:

  • notatextfile.js
  • Silver Blaze.txt
  • The Adventure of the Six Napoleans.txt

In the dist folder, the following files will be generated:

  • index.html
  • Silver Blaze.html
  • style.css
  • The Adventure of the Six Napoleons.html

Live Demo

https://lyu4321.github.io/jellybean

Repo

Jellybean

Author

Leyang Yu

License

MIT

Discussion (0)