= BookmarksProject: Installation Instructions =

{{{
# cpanminus, plus OS-level dependencies
# NOTE: installing XML::LibXML through the OS package manager rather than cpanm
# currently unable to install the right dependecies to make cpanm XML::LibXML work
$ sudo apt-get install cpanminus libexpat1-dev libxml-libxml-perl

# check out code
$ svn co http://svn.echodin.net/bookmarks/trunk bookmarks

# install CPAN dependencies
$ cd bookmarks
$ sudo cpanm --installdeps .

# initialize a new bookmarks database
$ bin/bkmk init -f bookmarks.db

# create a barebones server config
# then start the server
$ bin/bkmkd init -D dbname=bookmarks.db
$ bin/bkmkd start
}}}

Web app should be available on http://localhost:5000/

{{{
# to stop the server
$ bin/bkmkd stop
}}}

Bookmarklet code for a "Make Bookmark" bookmarklet:
{{{
javascript:(function(){window.open(%22http://localhost:5000/?uri=%22+encodeURIComponent(document.location)+%22&title=%22+encodeURIComponent(document.title),%22edit_bookmark%22,%22width=800,height=250%22)})()
}}}

Be sure to change '''localhost:5000''' to your server name if you are running this behind a reverse proxy on an actual server.

== See Also ==

  * [../CommandLineTool]