This is a project that I created as part of my course in open-source development. rost_gen is a basic static site generator made using Rust that generates html files from text files.
Detailed installation and usage instructions can be found in the Readme.md file on github here.
[-i, --input] [PATH]
Specify a path to the input file or folder containing files.
The file or files must be .txt files to be converted. By default, this will output generated html files to the ./dist directory. Any existing content will be deleted.
[-i, --input] [INPUT PATH] [-o, --output] [OUTPUT PATH]
Specify an output directory. This will create a directory if it doesn't exist but keep existing content.
Display help message
Display name and version of tool
Generate html from a single text file
./rost_gen --input file_to_convert.txt
Generate html from a folder containing text files
./rost_gen -i folder_with_text_files
Specify an output directory
./rost_gen --input file_to_convert.txt --output output_dir
Seperate paragraphs with blank lines
The tool will parse paragraphs and enclose them in
<p>tags. Just separate paragraphs in the text file with blank lines:
This is the first paragraph This is the second paragraph This is the second line of the second paragraph
Specify a file title with two blank lines
If the first line is followed with two blank lines, it will be used as the title of the generated html file. The tool will also add a
<h1>tag in the generated html body containing this title:
Title of the document Start of content
Generated html body will look like this:
<h1> Title of the document </h1> <p> Start of content> </p>
About the name
I based the name on a scene from one of one of the episodes from "The Mentalist" where one of the characters uses "Roth" (which comes from the German word "rot" meaning "Red) as part of one of their aliases.
So, I decided to use Google Translate to translate Rust into German and ended up with rost, and gen for generator. Also, st_gen can be short for static_generator.
Top comments (0)