Creating my static site generator
Neil An
Posted on September 13, 2022
Hi everyone,
This week, I created my own SSG (static site generator) called nan1-ssg using JavaScript and node.js. My SSG will generate .html files from .txt files as specified by the user.
Some features of nan1-ssg are:
- Generating valid HTML5 files from .txt files and placed in the dist directory
- An index.html file is created which contain relative links to the generated HTML files
- Each HTML file uses a default stylesheet to improve beauty and readability
Usage
To use my SSG, node.js is required. After node.js is installed follow these steps to use the tool:
To use this tool:
Clone or download and extract the repo to a location on your computer.
Open a terminal/command window and navigate to the location where the tool is.
Run the npm install command:
npm install
- Run the npm link command:
npm link
- Start using the tool! For example:
nan1-ssg [-option]
A list of options:
Option | Details |
---|---|
-v, --version | Will display the name and version of the tool. |
-h, --help | Will display a help message, showing options and usage. |
-i , --input | Gives the tool a filename to generate HTML files with. The filename can be a file or a directory. |
Examples
For a text file:
node main -i hello.txt
For a directory:
node main -i Sherlock-Holmes-Selected-Stories
Files that are nested:
nan1-ssg -i "./Sherlock-Holmes-Selected-Stories/Silver Blaze.txt"
Files containing spaces:
node main -i "file with spaces.txt"
Link to repo: nan1-ssg
Example of generated static site: https://neilan99.github.io/
Posted on September 13, 2022
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.
Related
November 30, 2024