From c15f82fa38458d76cec62b930b13b446829e3a2d Mon Sep 17 00:00:00 2001 From: "B. Stack" Date: Fri, 2 Apr 2021 21:14:08 -0400 Subject: initial commit --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..068869b --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +# Readme for save-webfonts +This `save-webfonts` script and accompanying library are designed to facilitate caching webfonts manually for approved sites. Many sites out there use fonts for interesting glyphs, so disabling webfonts is not a choice made for convenience but security. +But for the sites you trust (or are willing to compromise for), you can run save-webfonts with those URLs, and save down the webfonts to your local user font cache. + +## Upstream +[This repo](https://gitlab.com/bgstack15/save-webfonts) is the original source. + +## Alternatives +Enable webfonts in your browser. Check setting `gfx.downloadable_fonts.enabled`. The author is not aware of any other scripts, processes, or extensions that "allow" web fonts for arbitrary sites. + +This is original research. + +## How to use +Read the output of `./save-webfonts --help`, which is also provided here. + + usage: save-webfonts [-h] [-d [{0,1,2,3,4,5,6,7,8,9,10}]] [-v] [-n | -a] [-o OUTDIR] [-w | -N] url [url ...] + + Download webfonts for a URL so browsers do not need to fetch them + + positional arguments: + url URLs whose webfonts should be downloaded + + optional arguments: + -h, --help show this help message and exit + -d [{0,1,2,3,4,5,6,7,8,9,10}], --debug [{0,1,2,3,4,5,6,7,8,9,10}] + Set debug level + -v, --version show program's version number and exit + -n, --dryrun Make no changes (default) + -a, --apply Actually make changes + -o OUTDIR, --outdir OUTDIR + Location of font directory. Default is ~/.local/share/fonts + -w, --wait Wait at end for Return key + -N, --no-wait, --nowait + Do not wait. Default. + +## Dependencies +These are available as system packages in Fedora and Devuan. +* python3-beautifulsoup4 (aka python3-bs4) +* python3-tinycss2 + +## References +None + +## Differences from upstream +None -- cgit