Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jgarber623/delicious-data-convertor
A simple tool written in Ruby that converts exported Delicious bookmarks from HTML to JSON.
https://github.com/jgarber623/delicious-data-convertor
bookmarks delicious-bookmarks indieweb json ruby
Last synced: 2 months ago
JSON representation
A simple tool written in Ruby that converts exported Delicious bookmarks from HTML to JSON.
- Host: GitHub
- URL: https://github.com/jgarber623/delicious-data-convertor
- Owner: jgarber623
- Archived: true
- Created: 2014-11-19T22:29:51.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2014-12-01T22:15:59.000Z (about 10 years ago)
- Last Synced: 2024-08-05T20:32:57.005Z (6 months ago)
- Topics: bookmarks, delicious-bookmarks, indieweb, json, ruby
- Language: Ruby
- Homepage:
- Size: 145 KB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Delicious Data Convertor
A simple Ruby-based tool for converting an exported `delicious.html` file from [Delicious](https://delicious.com/) into JSON.
## Requirements
- No aversion to the command line
- Ruby (2.1.4)
- Bundler (1.7.4 or newer)
- A [Delicious](https://delicious.com/) account
## Installation
1. Install Ruby 2.1.4. If you're using Mac OS X, you can use tools like [chruby](https://github.com/postmodern/chruby), [rbenv](https://github.com/sstephenson/rbenv), or [RVM](https://rvm.io) to install multiple versions of Ruby, including the one required for this tool.
2. Install Bundler (`gem install bundler`).
3. Install gems (`bundle install`).
## Usage
1. Clone this repository and `cd` into the `delicious-data-convertor` directory.
2. Visit the ["Manage" section](https://delicious.com/settings/manage) of your Delicious account and choose "Export Bookmarks." Be sure to include tags and notes in the export (the default).
3. Save the resulting `delicious.html` file to this project's `data` directory.
4. Back over in Terminal, run `rake convert` from the root of the project.
5. Marvel at the resulting `delicious.json` file in the `data` folder!
## Caveats
I slapped this together quickly in an hour or so. It's really only tested against an export of [my Delicious bookmarks](https://delicious.com/jgarber). It may or may not work for you.
### HTML elements in titles and descriptions
I encountered an issue with bookmarks that had strings like ``, ``, etc. in titles and descriptions. Basically, instances where there were HTML elements (or strings that look like HTML elements) caused Nokogiri to go haywire. I couldn't find a bulletproof solution to this, so I manually changed `<` to `<` and `>` to `>` in titles and descriptions.
For example, this:
A sample description referencing an element.
became this:
A sample description referencing an <html> element.
It's not perfect, but it's the best I could figure out in a timely fashion.
## License
Per [CC0](http://creativecommons.org/publicdomain/zero/1.0/), to the extent possible under law, I have waived all copyright and related or neighboring rights to this work. Go forth and make things.