;;; eww-unmangle.el --- Make websites more redable in EWW -*- lexical-binding: t; -*- ;; Copyright (C) 2021, 2022 Philip Kaludercic ;; Author: Philip Kaludercic ;; This program is free software; you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation, either version 3 of the License, or ;; (at your option) any later version. ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with this program. If not, see . ;;; Commentary: ;; Manually fix broken and difficult to use sites in Emacs' EWW ;; browser. ;; ;; Add `eww-unmangle' to `eww-after-render-hook' like so ;; ;; (add-hook 'eww-after-render-hook #'eww-unmangle) ;; ;; to your configuration to enable the unmangling. ;;; Code: (eval-when-compile (require 'subr-x)) (require 'eww) (defvar eww-ummangle-alist '() "An alist of unmanglers for different domains. Each entry has the form (DOMAIN-RE . UNMANGLER), where DOMAIN-RE is string containing a a regular expression that should match a domain name, and UNMANGLER is a function that takes no arguments and is called in the EWW buffer.") (defun eww-unmangle () "Unmangler for EWW, to be added to `eww-after-render-hook'." (save-excursion (when-let* ((url (plist-get eww-data :url)) (dom (url-domain url)) (unm (alist-get dom eww-ummangle-alist nil nil #'string-match-p))) (funcall unm)))) ;;; (defun eww-unmangle--site (domain unmangler) "Register function UNMANGLER for a DOMAIN name. See `eww-ummangle-alist' on what UNMANGLER has to look like." (declare (indent 1)) (push (cons (regexp-quote domain) unmangler) eww-ummangle-alist)) (defmacro eww-unmangle--cond (&rest body) "Dispatch handler by path. BODY consists of `cond'-like forms (REGEXP . BODY), where REGEXP attempts to match the result of `url-path-and-query' (bound to the variable `url'). When successful, the final element in BODY is executed (should be a function)." (declare (indent 0)) (let (conds) (while body (let ((case (pop body))) (push `((string-match ,(car case) url) ,@(cdr case)) conds))) `(lambda () (let ((url (url-path-and-query (plist-get eww-data :url)))) (ignore url) ;silence the byte compiler (funcall (cond ,@(nreverse conds) (#'ignore))))))) (defmacro eww-unmangle--bind (varlist &rest body) "Bind matches to variables in VARLIST in BODY. Each element of VARLIST should be a symbol, that is bound to the matching `match-string' in order of its occurrence (starting with 1)." (declare (indent 1)) (let (bound-varlist) (dotimes (i (length varlist)) (push (list (nth i varlist) `(match-string ,(1+ i) url)) bound-varlist)) `(let ,(nreverse bound-varlist) ,@body))) (defmacro eww-unmangle--dom (var &rest body) "Transform the document object model. BODY should use the S-Expression representation of the DOM bound to VAR and return a modified version, that is then converted back to HTML." (declare (indent 1)) `(let* ((,var (libxml-parse-html-region (point-min) (point-max))) (new (progn ,@body))) (ignore ,var) (delete-region (point-min) (point-max)) (dom-print new))) ;;; Unmanglers (add-to-list 'eww-ummangle-alist (cons "github\\.com" (eww-unmangle--cond ("\\`/\\([[:alnum:]]+\\)/\\([[:alnum:]-.]+\\)" (eww-unmangle--dom dom ))))) (provide 'eww-unmangle) ;;; eww-unmangle.el ends here