From: Adam Porter <adam@alphapapa.net>
To: emacs-orgmode@gnu.org
Subject: ANN: org-web-tools
Date: Fri, 21 Jul 2017 12:53:32 -0500 [thread overview]
Message-ID: <87o9sdad7n.fsf@alphapapa.net> (raw)
Hi friends,
I've just uploaded a package containing some code that I've been using
in my personal Emacs config for a while. It has commands and functions
useful for retrieving web page content and processing it into Org-mode
content.
For example, you can copy a URL to the clipboard or kill-ring, then run
a command that downloads the page, isolates the "readable" content with
eww-readable, converts it to Org-mode content with Pandoc, and displays
it in an Org-mode buffer. Another command does all of that but inserts
it as an Org entry instead of displaying it in a new buffer.
So you can quickly and easily read a web page in an Org buffer, or
insert a page's content as an entry into an Org buffer. You may also
find the support functions useful in building your own commands.
I haven't submitted it to MELPA yet; I'd like to get some feedback and
testing before doing that, so if any of these look useful to you, please
give it a test drive!
Here's a list of the commands and functions:
Commands
+ org-web-tools-insert-link-for-url: Insert an Org-mode link to the URL
in the clipboard or kill-ring. Downloads the page to get the HTML
title.
+ org-web-tools-insert-web-page-as-entry: Insert the web page for the
URL in the clipboard or kill-ring as an Org-mode entry, as a sibling
heading of the current entry.
+ org-web-tools-read-url-as-org: Display the web page for the URL in
the clipboard or kill-ring as Org-mode text in a new buffer, processed
with eww-readable.
+ org-web-tools-convert-url-list-to-page-entries: With point on a list
of URLs in an Org-mode buffer, replace the list of URLs with a list of
Org headings, each containing the web page content of that URL,
converted to Org-mode text and processed with eww-readable.
Functions
+ org-web-tools--eww-readable: Return "readable" part of HTML with
title.
+ org-web-tools--get-url: Return content for URL as string.
+ org-web-tools--html-title: Return title of HTML page.
+ org-web-tools--html-to-org-with-pandoc: Return string of HTML
converted to Org with Pandoc.
+ org-web-tools--url-as-readable-org: Return string containing Org
entry of URLs web page content. Content is processed with eww-readable
and Pandoc. Entry will be a top-level heading, with article contents
below a second-level "Article" heading, and a timestamp in the
first-level entry for writing comments.
+ org-web-tools--demote-headings-below: Demote all headings in buffer
so the highest level is below LEVEL.
+ org-web-tools--get-first-url: Return URL in clipboard, or first URL
in the kill-ring, or nil if none.
+ org-web-tools--read-org-bracket-link: Return (TARGET . DESCRIPTION)
for Org bracket LINK or next link on current line.
+ org-web-tools--remove-dos-crlf: Remove all DOS CRLF (^M) in buffer.
Thanks,
Adam
next reply other threads:[~2017-07-21 17:53 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-07-21 17:53 Adam Porter [this message]
[not found] <d6220956f0a848c495036c80fe0d3702@HE1PR01MB1898.eurprd01.prod.exchangelabs.com>
2017-07-21 20:09 ` ANN: org-web-tools Eric S Fraga
2017-07-22 0:33 ` Grant Rettke
[not found] ` <fed2d609f66a45e4af3d43eb9a8ce5e9@DB5PR01MB1895.eurprd01.prod.exchangelabs.com>
2017-07-22 10:15 ` Eric S Fraga
2017-07-22 11:53 ` Adam Porter
2017-07-22 11:51 ` Adam Porter
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87o9sdad7n.fsf@alphapapa.net \
--to=adam@alphapapa.net \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).