html2gemtext - A simple library for converting HTML to Gemtext
Introduction
html2gemtext is a small and simple library that provides code for
converting HTML into the hypertext markup language of the Gemini
project.
Installation
html2gemtext is available from
pypi and can be installed with your
package installer of choice.
With pip:
pip install html2gemtext
With uv:
uv add html2gemtext
Quick start
The library provides a single main conversion function called
html_to_gemtext. It is passed a string that is the HTML you wish to
convert, and the result is a string that is the resulting Gemtext.
A very minimal converter might look like:
import fileinput
from html2gemtext import html_to_gemtext
def convert() -> None:
with fileinput.input() as html:
print(html_to_gemtext("".join(html)))
While it is primarily intended as a library to be used from other Python
code, it does contain a simple test command line tool, which can be accessed
either via the Python -m switch, or depending on your environment, via the
html2gemtext command. For example, given this content of a file called
test.html:
<!doctype html>
<html lang="en">
<head>
<title>Test page</title>
</head>
<body>
<p>
Hello World! This is a test of the converter.
</p>
<p>
<a href="https://www.example.com">This is a link</a> to an external website.
</p>
</body>
</html>
The html2gemtext command (or python -m html2gemtext) would produce:
Hello World! This is a test of the converter.
This is a link[1] to an external website.
=> https://www.example.com 1: https://www.example.com
See the main documentation for the full API.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file html2gemtext-0.1.0.tar.gz.
File metadata
- Download URL: html2gemtext-0.1.0.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
84360f629c25c797d96921a2662a83777f09bf93e7f8cd876d37358567c66ab2
|
|
| MD5 |
ed5373790d2ecfaa31dcb38afa623dc0
|
|
| BLAKE2b-256 |
2d1d7e842b0402c03eeb1b1c39bfd0dfe6d80feaeaf6f8689d10feceb6f9d74e
|
File details
Details for the file html2gemtext-0.1.0-py3-none-any.whl.
File metadata
- Download URL: html2gemtext-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f13e3c9ff41edcdc8e2fa058deb5dbbe788b37eefbe1f27002f3add28c74bd72
|
|
| MD5 |
6f7f35504a720e64e9cd5b1b43cceaab
|
|
| BLAKE2b-256 |
22c890e64e7bcd5fe382981a3dbe795f03909520c04cb2ccbf1da2046b3343e2
|