hmason / gitmarks Goto Github PK

delicious-like bookmarks on github.

Python 100.00%

gitmarks's Introduction

UPDATE: Far McKon's fork is the new official fork, follow that one instead! It's here: https://github.com/FarMcKon/gitmarks_2

========
Gitmarks
========

A web bookmark manager built on git and designed for github. It's searchable and social!

Gitmarks is a script that, given a URL, description, and tags, will download the content of the web page and store it along with the metadata so that you can easily search it (with grep!) and comment on it (with github!)

It's great for groups to collaboratively collect bookmarks in one spot (thanks to git itself!)

=======
Details
=======

For each URL, gitmarks will pull the content and store it under the 'content' directory. It stores the metadata under each tag in the 'tags' directory.

You can use git as usual to see who committed what and when, or you can grep your way to bookmark happiness on the command line.

=====
Usage
=====

python gitmark.py [url]

options:
	-p = do not push to origin (store bookmark locally only)
	-m = description of the bookmark
	-t = a comma-delimited list of tags
	
Example:

python gitmark.py -m 'my site' -t me,hilary_mason,code,bookmarks http://www.hilarymason.com


===============
OMG Delicious?!
===============

Yes, you can import your delicious bookmarks!

Usage:

python delicious_import.py [username] [password]

(be patient if you have a lot of them.)


=============================
Using the Browser Bookmarklet
=============================

First, run the gitmark_web server:

python gitmark_web.py

Then, go to the following URL and drag the bookmarklet into your browser's toolbar:

http://localhost:44865/

(where 44865 is the port you set in settings.py)


=======
License
=======

Copyright 2010 Hilary Mason.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

gitmarks's People

Contributors

Stargazers

Watchers

gitmarks's Issues

submodules

Wouldn't it be nicer if the content generated by gitmarks was in only one folder (with 2 sub-folders). Then it would be simple to separate the content in a different git(hub) repo with the submodule system.

Thinking about peope who want to use gitmarks and also contributing to the code.

Doesn't work on Mac OS X

Whenever I try doing (gitmark is an alias I have setup for python gitmark.py):

gitmark http://example.com

I get the error:

Traceback (most recent call last):
File "/Users/mark/src/git/gitmarks/gitmark.py", line 117, in <module>
g = gitMark(opts, args)
File "/Users/mark/src/git/gitmarks/gitmark.py", line 36, in __init__
modified.append(self.saveContent(content_filename, content))
File "/Users/mark/src/git/gitmarks/gitmark.py", line 69, in saveContent
f = open('%s%s' % (CONTENT_PATH, filename), 'w')
IOError: [Errno 2] No such file or directory:      '~/.gitmarks/content/a9b9f04336ce0181a08e774e01113b31'

I have the settings.py file setup like this:

TAG_PATH = '~/.gitmarks/tags/'

CONTENT_PATH = '~/.gitmarks/content/'

I am on Mac OS X 10.6.5

Unable to import delicious items

It seems that calling delicious_import.py [username] [password] fails and calls for username and password constantly. It this has something to do with error 999 that yahoo throws.

Any work arounds?

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.