The original use case for pin
was sending links to Pinboard
from the command line, or in situations where the only interface
available was process-based.
In Pinboard terms, a link is a “post”, or a “bookmark”, and it has certain attributes. The two mandatory attributes are:
A post has several other optional attributes. pin
supports
the following:
The relevant sub-command is ’send’, with arguments being the link or
links you’d like to send to Pinboard. The links may be given in one of
two ways. The first is simply giving the URL as an argument, in which
case the title will be taken from the -T
or
--title
option (which must be provided, in this case; it is
illegal to send a link with no title):
pin send --title=foo http://foo.com
The other is to give arguments in the form “URL | TITLE” in which
case the title given for each argument will be preferred to the
--title
pin send "http://foo.com | foo"
The latter form happens to be the export format of the One Tab FireFox plugin.
You can tag the links given as arguments as “to be read later” by adding the --read-later. You can tags the links given with the --tag option (which can of course be given more than once).