Package: ez-txt2html-bryce-seefieldt
ez-txt2htmlezTxt2Html is a simple open-source Python program that converts plain text and markdown files (.txt, .md) into HTML files (.html). You can use it to convert individual file or all files in a directory.InstallationTo use ez-txt2html, follow these steps:Ensure you have the latest version of Python 3 installed.python --versionIf needed, download and installPython 3Clone or download this repository to your local machine:git clone https://github.com/bryce-seefieldt/ez-txt2html.gitChange your current working directory to the src directory within the project folder:cd ez-txt2html\srcNow, you have successfully installed ez-txt2html.UsageYou can run ez-txt2html from the command line. It accepts the following command-line arguments:'-h' or '--help': Display help screen.'-v' or '--version': Display the current version of ez-txt2html and exit.'inputPath' (required): Provide the path to the target file or directory containing the files to be converted.'-o' or '--output' (optional): Define the output directory for the HTML files. If not specified, it defaults to ./HTML.'-c' or '--config' (optional): Provide a customTOMLconfig file with pre-defined arguments.Here's how you can run ez_txt2html:python ez-txt2html.py inputPath [-o outputPath] [-c configPath]'inputPath': Replace this with the path to the target file or directory containing text or markdown files.'o outputPath' (optional): Replace this with the desired output directory for the HTML files.'c configPath' (optional): Replace this with the path to a .toml config file.InputConvert a single text or markdown file to HTML:python ez_txt2html.py path/to/yourfile.txtConvert all text or markdown files in a directory to HTML:python ez_txt2html.py path/to/yourdirectoryOutputHTML files will be saved to automatically created ./src/HTML/ directory as a default. Use '-o' or '--output' along with your desirec directory path in order to overide the default save location. This output folder will be overwritten entirely with each execution of the program.
HTML files will have the same name as the input files but with the .html extension.Configuration FileArguments may be pre-defined in aTOMLfile and passed to the program.Example TOML configuration (i.e. in a file namedconfig.toml):output="./HTML"Note: Using a config file will override other command line switches (if provided).ExamplesThe included examples folder contains a sample text file which can be run to get an idea of this tool works.  While in the src folder run:python ez_txt2html.py ../examples/to see how it convert all text files in a folder, ORpython ez_txt2html.py ../examples/til.mdto see how it converts a single specified file.The converted HTML files will appear in /src/HTML/ unless otherwise specified.To specify the output directory add '-o' or '--output' forllowed by the local or relative destination path to the command line:python ez-txt2html.py ../examples/til.md -o ../examplesTo utilize a config file add '-c' or '--output' followed by the path to the .toml file:python ez_txt2html.py ../examples/ -c ../config.tomlVersionThe current version of ez-txt2html is 1.0.2LicenseThis program is open-source and released under theMIT License. Feel free to use and modify it as needed.Authorez-txt2html is maintained byBryce Seefieldt.If you encounter any issues or have suggestions for improvements, pleaseopen an issue.Enjoy converting your text files to HTML with ez-txt2html!