Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skx/bookmarks.public
A template for self-hosted bookmarks using HTML & jQuery.
https://github.com/skx/bookmarks.public
bookmark git javascript
Last synced: about 2 months ago
JSON representation
A template for self-hosted bookmarks using HTML & jQuery.
- Host: GitHub
- URL: https://github.com/skx/bookmarks.public
- Owner: skx
- License: mit
- Archived: true
- Created: 2013-03-17T22:42:42.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2019-06-29T17:22:32.000Z (about 5 years ago)
- Last Synced: 2024-06-03T04:40:13.753Z (4 months ago)
- Topics: bookmark, git, javascript
- Language: JavaScript
- Size: 93.8 KB
- Stars: 660
- Watchers: 37
- Forks: 110
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - skx/bookmarks.public - A template for self-hosted bookmarks using HTML & jQuery. (javascript)
README
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.Browser Limitations
-------------------Because the javascript attempts to open the `bookmarks.data` file via a
`file://` URI this "application" will __not__ work on all browsers.The author is happy that it works on Firefox/Iceweasel, and would welcome
any operational improvements for other browsers. Currently this is __known to
fail__ upon Chrome and Safari.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](https://github.com/skx/bookmarks.public) 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](importers/), which might be of interest.
For advanced usage you can see:
* [Adding/Editing bookmarks via your browser](Browser.md)
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
--