DEV Community

Omar Hussein
Omar Hussein

Posted on

TILvert, my first open-source project

Today I released the very first version of my open-source text conversion utility. This utility was designed to quickly generate blog posts using your filesystem.

Tilvert is a simple tool to convert TILs from markdown files to HTML

Installation

$ npm install -g https://github.com/omalk98/TILvert.git
Enter fullscreen mode Exit fullscreen mode

Uninstall

$ npm uninstall -g tilvert
Enter fullscreen mode Exit fullscreen mode

Usage

$ tilvert [flags/options] <path>
Enter fullscreen mode Exit fullscreen mode

If no path is specified, TILvert will read the current directory recursively to find all files with the matching extension (default "txt").

Flags

Flag Description
-h, --help Displays help information.
-v, --version Displays version information.

Options

Option Description
-e, --extension Extension for the files in the input directory. (Ignored if input is file). Default (txt).
-o, --output Path to the output directory. Default (./til).
-s, --stylesheet Path to the stylesheet.
--title Title of the HTML page.
--author Author of the HTML page.
--description Description of the HTML page.
--keywords Keywords of the HTML page.
--robots Robots of the HTML page.
--generator Generator of the HTML page.
--theme-color Theme color of the HTML page.

License

TILvert is licensed under the MIT License

Features

  • [x] Convert markdown files to HTML
  • [x] Replicate directory structure in output directory
  • [x] Customizable HTML page with meta tags
  • [x] Customizable stylesheet
  • [x] Customizable extension for input files
  • [x] Customizable output directory

Top comments (0)