Portholes is a replacement for Instapaper or Pocket. The main differences are article sorting and a better parser.
Mozilla's Readability library is the main parser. You can see the call in /lib/portholes/parser.rb. Should Mozilla's Readability library fail, I've written a basic parser as a fall back.
Portholes uses Calibre's ebook-convert
to create ebook files as seen in /lib/portholes/ebook.rb. You will need to install Calibre locally before Portholes will work.
Folder view:
Single article view:
First, clone or download this repo. Next, in your terminal type bundle install
to install gems from the Gemfile. To start the program type bundle exec thin start
to run the server.
To create a bookmarklet in your bookmarks for saving articles, you will need to create a new bookmark, edit that bookmark, and then add the below as the URL.
javascript:void%20function(){script=document.createElement(%22script%22),script.src=%22http://localhost:3000/article%22,document.head.appendChild(script)}();
The ebook format is hardcoded to azw3
. If you wish to change this you will need to edit the ebook
method in /lib/portholes/ebook.rb. The ebook-convert
docs can be found on the Calibre website.
Use of Portholes is governed by the GNU AGPLv3 license that can be found in the LICENSE file.