go-go-web

Command-line tool that converts .txt or .md files into .html files.

Features

• v1.0.3 project package uploaded to Test PyPI
• v0.0.5 additionally parses front matter from .md files for metadata
• v0.0.4 additionally accepts TOML config file
• v0.0.3 additionally parses code blocks and horizontal rules for .md files
• v0.0.2 additionally converts .md files into .html and parses italic and bold for .md files
• v0.0.1 converts TIL post (.txt file) into .html file, specify output location, specify stylesheet url, view app version, view app help message

Installation

1. Download and install the latest version of python. Open a terminal and check that it is installed.

   py --version

2. Make sure you have upgraded version of pip.

   Windows

   py -m pip install --upgrade pip
   

   Linux/MAC OS

   python3 -m pip install --upgrade pip
   

3. Install gogoweb using pip.

   Windows

   pip install gogoweb
   

   Linux/MAC OS

   python3 -m pip install gogoweb
   

4. Check that you have the latest version of the app.

   py -m gogoweb.convert -v

Usage

View App Version

py -m gogoweb.convert --version or py -m gogoweb.convert -v

View Usage Message

py -m gogoweb.convert --help or py -m gogoweb.convert -h

Convert .txt to .html

py -m gogoweb.convert <file or folder path>

Example 1 (Convert one file)

py -m gogoweb.convert ./examples/til_post1.txt

Example 2 (Convert a folder of files)

py -m gogoweb.convert ./examples

Output(s) can be found in til folder.

Specify Output Location

py -m gogoweb.convert <file or folder path> -o <folder path>

Example

py -m gogoweb.convert ./examples/examples.txt -o ./examples

Specify Stylesheet

py -m gogoweb.convert <file or folder path> -s <stylesheet url>

Example

py -m gogoweb.convert ./examples/til_post2.txt -s https://cdnjs.cloudflare.com/ajax/libs/tufte-css/1.8.0/tufte.min.css

Specify Config File

py -m gogoweb.convert <file or folder path> -c <config toml file path>

Example

py -m gogoweb.convert ./examples -c src/gogoweb/config.toml

Additional Features Available for Markdown

Input file must be a .md file that is written in proper Markdown syntax

Front Matter Parsing

You may specify the following front matter in Markdown files and these will become the metadata of the resulting HTML file

How to specify front matter in a Markdown file:

---
title: Katie's Homepage
keywords: website, coding
description: This is Katie's personal website.
---

License

License (MIT)

See Examples Outputs

go-go-web examples