/bookmarks.public

A template for self-hosted bookmarks using HTML & jQuery.
  1. JavaScript 58.0%
  2. Perl 19.3%
  3. HTML 14.9%
  4. Python 6.0%
  5. CSS 1.8%
JavaScript Perl HTML Python CSS
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 065ff84 Nov 16, 2017 @skx skx Updated to clear the window-hash when clicking appropriately. 
This commit fixes a silly issue where viewing "random", "untagged",
or "all", left the old tag-specific hash in-place.

This closes #35, which was an excellently reported by from
@gogades.
Permalink
Failed to load latest commit information.
importers Document explicitly the firefox instructions. Sep 5, 2017
Browser.md Removed needless import-section Sep 5, 2017
LICENSE Populate license meta-data Mar 20, 2017
README.md Link to the new Browser.md file, and the importer file. Sep 5, 2017
add-bookmark.user.js readme upgrade Mar 4, 2017
bookmark-utils Load the bookmarks from their dedicated file. Jun 29, 2016
bookmarks.css Add tag autocomplete in the Add Bookmark form Dec 10, 2016
bookmarks.data Revert "first bookmarks" Aug 17, 2017
bookmarks.js Updated to clear the window-hash when clicking appropriately. Nov 16, 2017
index.html fix https links Aug 16, 2017

README.md

bookmarks.public

This repository allows you to save your bookmarks under revision control, via a simple combination of HTML, CSS & Javascript.

  • You add your bookmarks to the file bookmarks.data.
  • Then view them by opening index.html in your browser.
    • The file bookmarks.css is used to style the presentation.
    • The file bookmarks.js makes the bookmarks interactive.

There is a simple online demo hosted at the following location:

Rationale

I didn't like any of the online bookmark-syncing plugins/addins/tools I tested.

The idea of hosting an online bookmark server is appealing, but using the power of git it seems that having a local bookmark file should be pretty robust:

  • New items are added, generally one per line.
  • Existing items can be edited to add new tags.
  • Merges should be painless.

The included javascript magic is present solely to make the bookmarks manageable, in my private copy I have 400+ bookmarks and with the tagging support present here they will continue to work for me easily.

Usage

If you wish to use this bookmarks script, and are happy for your bookmarks to be public, then just fork this repository and you're done.

If you prefer to keep your bookmarks private, as I do, then you'll need to host your repository somewhere private.

To get started you might wish to examine contributed importers found beneath the importers directory, which might be of interest.

For advanced usage you can see:

Contributing

If you wish to submit improvements to the javascript, or the CSS, then I welcome forks & pull requests.

NOTE: If you submit a change feel free to add a link to your homepage/blog/whatever as part of that. The included bookmarks are only examples.

Steve