TheLazy.Dev
Portfolio GitHub

Blog

swift |opensource |sideprojects

Static site Generator using Swift

japneetsingh035

Japneet Singh

Posted on September 16, 2021

Static site Generator using Swift

ModernSSG

Modern SSG is a Static Site Generator which helps to convert text files to HTML made with Apple Swift version 5.4.2 with help of Argument Parser.

Pre-requisites

Swift is an ios based development language. This requires Swift installed on your mac or windows. To work on this project xcode installation is required.
Install Swift

Terminal Usage 

$ mv ModernSSG Desktop/ModernSSG
$ swift package init --type executable
$ swift build
$ swift run
$ swift run ModernSSG [subcommands]
Enter fullscreen mode Exit fullscreen mode

Help 

OVERVIEW: A program to convert text files to HTML site generator

USAGE: ModernSSG --input <input> [--stylesheet <stylesheet>] [--output <output>]

OPTIONS:
  -i, --input <input>     allow the user to specify an input file or folder to
                          be processed
  -s, --stylesheet <stylesheet>
                          allow the user to optionally specify a URL to a CSS
                          stylesheet.
  -o, --output <output>   allow the user to specify an output folder to be
                          processed.
  --version               Show the version.
  -h, --help              Show help information.
Enter fullscreen mode Exit fullscreen mode

Version

This command allows the version to specify the current version of the tool.

swift run ModernSSG --version
ModernSSG 0.0.1
Enter fullscreen mode Exit fullscreen mode

Input

This commands allows the user to specify the input file present in desktop directory for the command line tool to read and look for same file. Please mention the file extension to avoid reading error.

swift run ModernSSG --input "your text file"
Enter fullscreen mode Exit fullscreen mode

Example

Before: "your filename.txt"

My first SSG Generator file
This is my first paragraph
This is my second paragraph
Enter fullscreen mode Exit fullscreen mode

After: "your filename.html"

<!doctype html>
<html>
<head>
<LINK rel='stylesheet' href="URL">
<meta charset='utf-8'>
<title>"Your filename"</title>
<meta name='viewport' content='width=device-width', initial-scale=1'>
</head>
<body>
<h1>This is my first SSG Generator file</h1>
<p>This is my first paragraph</p>
<p>This is my second paragraph</p>
</body>
</html>"
Enter fullscreen mode Exit fullscreen mode

Output

This commands allows the user to specify the output folder present in current directory for the command line tool to read and move all output files to this folder.

swift run ModernSSG --input "your text file" --output "your output folder name"
Enter fullscreen mode Exit fullscreen mode

i

This commands allows the user to specify the input folder/directory present in current directory for the command line tool to read and look for all files.

swift run ModernSSG -i "your input folder directory"
Enter fullscreen mode Exit fullscreen mode

Stylesheet

This command allow the user to specify a stylesheet URL to be processed on all files present in dist folder.

swift run ModernSSG --input "your text file" --stylesheet "https://cdn.jsdelivr.net/npm/water.css@2/out/water.css"
Enter fullscreen mode Exit fullscreen mode

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Sources

Build a Command Line Tool Using Swift Argument Parser by Riccardo

FileManager

Argument Parser

Author

JAPNEET SINGH

💖 💪 🙅 🚩
japneetsingh035
Japneet Singh

Posted on September 16, 2021

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related

Static site Generator using Swift
swift Static site Generator using Swift

September 16, 2021