{"id":21858687,"url":"https://github.com/sdthaker/node-tilify","last_synced_at":"2026-05-09T02:36:39.415Z","repository":{"id":191969721,"uuid":"685783627","full_name":"sdthaker/Node-TILify","owner":"sdthaker","description":"\"Today I Learned\" tool that converts text file or a directory of text files to HTML files and beyond","archived":false,"fork":false,"pushed_at":"2023-11-20T18:29:09.000Z","size":1736,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-30T23:02:58.714Z","etag":null,"topics":["open-source-software"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdthaker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-01T02:08:47.000Z","updated_at":"2023-11-06T20:34:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"fd3580e8-6bb6-432e-9d71-59bc4564308e","html_url":"https://github.com/sdthaker/Node-TILify","commit_stats":null,"previous_names":["sdthaker/node-tilify"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/sdthaker/Node-TILify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdthaker%2FNode-TILify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdthaker%2FNode-TILify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdthaker%2FNode-TILify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdthaker%2FNode-TILify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdthaker","download_url":"https://codeload.github.com/sdthaker/Node-TILify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdthaker%2FNode-TILify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32805121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["open-source-software"],"created_at":"2024-11-28T02:47:21.332Z","updated_at":"2026-05-09T02:36:39.393Z","avatar_url":"https://github.com/sdthaker.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node-TILify\n\nWelcome to Node-TILify. An open source CLI software that helps you convert a text file or a directory of text file(s) into html file(s) blazingly fast 🏃‍♂️ 💨 ⚡️. The name of the project was chosen to showcase which language/framework was used to build this tool -- _`Node`.js_, what the tool is all about -- _`TIL` - Today I Learned_, \u0026 the value that it adds to your workflow -- _Ampl`ify`ing Knowledge_.\n\n# How to install\n\nMake sure you have latest [node](https://nodejs.org/en/download) installed on your computer.\n\nTo install this program globally on your machine, run the command:\n\n```bash\nnpm i -g node-tilify\n```\n\nYou can now run the program to see how to use this tool:\n\n```bash\nnode-tilify -h\n```\n\n# Features\n\n- Pass in a txt file and it'll generate an html file.\n- Pass in a directory and it'll search through all the txt files in that directory and generate html files which are then stored in `./til` directory.\n- Every paragraph is enclosed with `\u003cp\u003e` tag.\n- Every hyperlink starting with `https://` or `http://` is enclosed with `\u003ca\u003e` tag.\n- Every line that ends in ^ is enclosed in `\u003ch2\u003e` tag.\n- \u003cins\u003e_Optional Feature #1_\u003c/ins\u003e: If the first line of the text has 2 spaces after it, a `\u003ctitle\u003e` tag is added to the `\u003chead\u003e` and a `\u003ch1\u003e` tag is added at the beginning of `\u003cbody\u003e`.\n- \u003cins\u003e_Optional Feature #5_\u003c/ins\u003e: Stylesheet is added to every html file to improve the looks of it.\n- Passing `-h` or `--help` command prints help menu.\n- Passing `-v` or `--version` command prints version and name of the tool.\n- \u003cins\u003e_Optional Feature #2_\u003c/ins\u003e: Passing `-o` or `--output` command followed by an output directory path, stores all the generated HTML files to that directory. If no directory exists, it'll create one. It overwrites the content of the files that match with the input file or directory of files and creates a new file if it doesn't exist in the output directory.\n- Name of the generated html file is the same as name of txt file.\n- Converts Markdown horizontal lines to HTML horizontal lines.\n- Converts Markdown links to HTML links.\n- Converts Markdown images to HTML images.\n- **TOML Configuration**: Instead of repeatedly passing in command-line arguments, you can now set your preferences in a TOML configuration file. Use the `-c` or `--config` flags followed by the path to your TOML configuration file.\n\n# Usages / Examples\n\n- `node-tilify -h` / `node-tilify --help` - To print help menu\n- `node-tilify -v` / `node-tilify --version` - To print version and name of the tool\n- `node-tilify input.txt` - To read txt file and generate html from it to be stored in `./til` directory\n- `node-tilify ./examples` - To read txt files from a directory and generate html from it to be stored in `./til` directory\n- `node-tilify input.txt -o collection` / `node-tilify input.txt -output collection` - To read a txt file and generate html from it to be stored in `./collection` directory\n- `node-tilify ./examples -o collection` / `node-tilify ./examples --output collection` - To read txt files from a directory and generate html from it to be stored in `./collection` directory\n- `node-tilify --config path_to_your_config.toml` / `node-tilify -c path_to_your_config.toml`- To utilize your configuration file settings for conversion.\n\n# Usages / Examples (with Output)\n\nTo generate multiple HTML files from a directory with your preferred output directory:\n\nCommand Line:\n\n```bash\nsohamthaker@Sohams-MacBook-Pro Node-TILify % node-tilify examples -o output\nHTML files generated successfully stored at output!\n```\n\npartial output of `examples/Kubernetes101.txt`\n\n```bash\nKubernetes 101\n\n\nTIL about Kubernetes, Google’s open source container orchestration system.\n\nI spent a half-day at Google’s office space today learning about Kubernetes from the folks at Apprenda. Going in to the session, I thought I had a grasp on what Kubernetes was, but quickly realized I had many misconceptions.\n\nWe worked through the following repository, provided by Apprenda, for learning some of the basics of Kubernetes: https://github.com/apprenda/hands-on-with-kubernetes-gke.\n\nHere are some things that I learned from the session:\n\nKubernettes !== Docker^\n\nI thought Kubernetes was just a different way to build container images like you can with Docker… not so!\n\nKubernetes is a container orchestration system: in other words, it provides the necessary components for configuring, deploying and scaling images that are built with Docker.\n```\n\npartial output of `output/Kubernetes101.html`\n\n```bash\n\u003c!DOCTYPE html\u003e\n    \u003chtml lang=\"en-us\"\u003e\n    \u003chead\u003e\n      \u003cmeta charset=\"utf-8\"\u003e\n      \u003clink rel=stylesheet href=https://cdn.jsdelivr.net/npm/water.css@2/out/water.css\u003e\n      \u003ctitle\u003eKubernetes 101\u003c/title\u003e\n      \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\"\u003e\n    \u003c/head\u003e\n    \u003cbody\u003e\n     \u003ch1\u003eKubernetes 101\u003c/h1\u003e\n\n     \u003cp\u003eTIL about Kubernetes, Google’s open source container orchestration system.\u003c/p\u003e\n\n     \u003cp\u003eI spent a half-day at Google’s office space today learning about Kubernetes from the folks at Apprenda. Going in to the session, I thought I had a grasp on what Kubernetes was, but quickly realized I had many misconceptions.\u003c/p\u003e\n\n     \u003cp\u003eWe worked through the following repository, provided by Apprenda, for learning some of the basics of Kubernetes: \u003ca href=\"https://github.com/apprenda/hands-on-with-kubernetes-gke.\" target=\"_blank\"\u003ehttps://github.com/apprenda/hands-on-with-kubernetes-gke.\u003c/a\u003e\u003c/p\u003e\n\n     \u003cp\u003eHere are some things that I learned from the session:\u003c/p\u003e\n\n     \u003ch2\u003eKubernettes !== Docker\u003c/h2\u003e\n\n     \u003cp\u003eI thought Kubernetes was just a different way to build container images like you can with Docker… not so!\u003c/p\u003e\n\n     \u003cp\u003eKubernetes is a container orchestration system: in other words, it provides the necessary components for configuring, deploying and scaling images that are built with Docker.\u003c/p\u003e\n```\n\n## Configuration Using TOML\n\nNow with TOML configuration support, streamline your repetitive tasks by setting your configurations just once!\n\n### How to Use\n\n1. Create a `.toml` file with your desired configuration. Here's an example format:\n\n\u003e ```toml\n\u003e # This is a sample TOML configuration file\n\u003e input = \"./src\"\n\u003e\n\u003e # Output directory where generated files will be saved\n\u003e output = \"./build\"\n\u003e\n\u003e # Stylesheet URL\n\u003e stylesheet = \"https://cdn.jsdelivr.net/npm/water.css@2/out/water.css\"\n\u003e\n\u003e # Language setting\n\u003e lang = \"fr\"\n\u003e ```\n\n2. Run the following command:\n\n\u003e ```bash\n\u003e node-tilify -c path_to_your_config.toml\n\u003e ```\n\n3. That's it! Your files will be generated in the output directory you specified in your configuration file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdthaker%2Fnode-tilify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdthaker%2Fnode-tilify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdthaker%2Fnode-tilify/lists"}