Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thearchitector/styled-prose
Generate images and thumbnails based on bitmap transformations of rendered prose
https://github.com/thearchitector/styled-prose
art fonts image pdf pdf2image pillow prose render text tgf the-glass-files typography writing
Last synced: 17 days ago
JSON representation
Generate images and thumbnails based on bitmap transformations of rendered prose
- Host: GitHub
- URL: https://github.com/thearchitector/styled-prose
- Owner: thearchitector
- License: bsd-3-clause
- Created: 2023-12-03T19:40:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-18T04:08:14.000Z (about 1 year ago)
- Last Synced: 2024-11-14T05:34:40.783Z (about 1 month ago)
- Topics: art, fonts, image, pdf, pdf2image, pillow, prose, render, text, tgf, the-glass-files, typography, writing
- Language: Python
- Homepage: https://styledprose.thearchitector.dev/
- Size: 966 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# styled-prose
![GitHub Workflow Status](https://raster.shields.io/github/actions/workflow/status/thearchitector/styled-prose/ci.yaml?label=tests&style=flat-square)
![PyPI - Downloads](https://raster.shields.io/pypi/dw/styled-prose?style=flat-square)
![GitHub](https://raster.shields.io/github/license/thearchitector/styled-prose?style=flat-square)Generate images and thumbnails based on bitmap transformations of rendered prose.
Documentation: .
Tested support on Python 3.8, 3.9, 3.10, 3.11, and 3.12.
```sh
$ pdm add styled-prose
# or
$ pip install --user styled-prose
```## Example
The following stylesheet is a super simple example that overrides the `default` style's font size and family.
```toml
# stylesheet.toml[[fonts]]
font_name = "EB Garamond"
from_google_fonts = true[[styles]]
name = "default"
font_size = 14
font_name = "EB Garamond"
```Using that stylesheet, and some basic prose, you can generate an image. The requested font family `EB Garamond` and its license are downloaded from Google Fonts and cached automatically; subsequent generations use those cached fonts.
```python
from PIL import Image
from styled_prose import StyledProseGeneratortext: str = """
This is normal.This is italicized.
This is bold.
This is bold and italicized.
This is underlined.
This is struck from the record.
"""
random.seed(771999)generator: StyledProseGenerator = StyledProseGenerator("stylesheet.toml")
img: Image.Image = generator.create_jpg(
text,
angle=-2.5, # optional; an angle by which to rotate the image
thumbnail=(210, 210), # optional; the dimensions of a random thumbnail
)img.save("prose.jpg", quality=95)
```This above code produces the following image:
![example rendering](/docs/simple.jpg)