Location: PHPKode > projects > FeedMeLinks, Social BookmarkingSince2002 > FAQ/index.php
<%
	include_once( "../modules/utils.inc.php" );
	$no_base_href = true;
	$title = "Feed Me Links FAQ : Frequently Asked Questions";
	include_once( "$modules/header.inc.php" );
%>
<base href="<%= getSiteUrl() %>/FAQ/" />
<style type="text/css">

	#page {
		font-family: georgia, serif;
		width: 45em;
	}

	#top > ol > li {
		font-size: 120%;
	}

	#answers > div > .a {
		padding-left: 1.0em;
		padding-right: 4.0em;
		font-size: 12px;
		margin-top: 1em;
		margin-bottom: 1em;
	}

	.q, #questions, #answers > div {
		background-color: #EEEEEE;
		border: 1px solid #CCCCCC;
		margin-bottom: 2.0em;
		padding: 0.5em;
	}

	.header, .q { 
		background: #ff6600;
		color: #ffffff;
		font-weight: bold;
		font-size: 120%;
	}

	.header {
		padding: 5px;
		border: 2px solid black;
		margin-top: 14px;
		font-size: 170%;
	}

	a.big { font-weight: bold; }

	dt { 
		margin-top: 1em;
	}
	code > dd {
		font-weight: bold;
	}

</style>

<br />
<br />
<a name="top"></a>

<div id="page">

<div class="header">
	The Feed Me Links F.A.Q.
</div>

<p/>

<div id="questions" style="font-size: 120%; line-height: 1.5em;">
	<a name="TOC"></a>
	<ol>
		<li>General Questions</li>
		<ol>
			<li><a href="#q1"  >What is Feed Me Links?</a></li>
			<li><a href="#q1_1">WHY Feed Me Links?</a></li>
			<li><a href="#q1_2">Why Feed Me Links instead of something else?</a></li>
			<li><a href="#q9"  >Who uses Feed Me Links?</a></li>
		<li><a href="#q3"  >How do I report a bug?</a></li>
			<li><a href="#q_mailing_list" >Is there an email list? How can I learn more/get involved?</a></li>
		</ol>
		<li>Questions on Using Feed Me Links</li>
			<ol>
				<li><a href="#q2"  >How do I add a link?</a></li>
				<li><a href="#q5"  >Can I import all my favorites/bookmarks at once?</a></li>
				<li><a href="#q6"  >Can I export my bookmarks out of Feed Me Links?</a></li>
				<li><a href="#usage_email">Can I add links via email?</a></li>
				<li><a href="#q2_1">What the heck is a tag?</a></li>
			</ol>
		<li>External Access Questions</li>
		<ol>
			<li><a href="#q6_0">What is the naming convention / url schema for Feed Me Links? </a></li>
			<li><a href="#xml_rss">RSS Feeds - How to syndicate your links</a></li>
			<li><a href="#apis">Programming Feed Me Links - The Feed Me Links API</a></li>

			<li><a href="#q7"  >How do I include a list of my links on my blog/webpage?</a></li>
			<li><a href="#q8"  >How do I subscribe to folders or users that I like?</a></li>
		</ol>
		<li>Esoterica</li>
			<ol>
				<li><a href="#q2_2">Parlez vous Unicode, AKA, can I use non-English text in link names?</a></li>
				<li><a href="#q4"  >Are my private links / tags really private?</a></li>
			</ol>
		</ol>
	</div>

<div id="answers">

	<div>
		<a name="q1"></a>
		<div class="q">What is Feed Me Links?</div>
		<div class="a">
			Feed Me Links is a &ldquo;web application&rdquo; to manage your bookmarks/links/favorites.
			Although it provides several interesting features for sharing links, it's primary
			goal is to help you organize and use your links, while helping you find new things you've not seen before.
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q1_1"></a>
		<div class="q">WHY Feed Me Links?</div>
		<div class="a">
			<ul>
				<li>We are user-oriented. This is not something we do for money. It's something we needed, so we made and maintain it. We are information junkies, like you, and we needed a way to keep track of all the sites, feeds, and content that swarms around us daily. We are the music makers. And we are the dreamers of the dreams...</li>
				<li>We like XML. We like <a href="/rss">RSS</a>.</li>
				<li>We like <a href="/install">whatever browser you like</a>.</li>
				<li>We like <a href="http://cia.navi.cx/stats/project/feedmelinks">source control</a>.</li>
				<li>We &ldquo;publish or perish.&rdquo; 
				<ul>
					<li>Check out our <a href="http://jm3.net/wk/FeedMeLinksTODO">bug list</a>!</li>
					<li>Read our <a href="http://six.pairlist.net/pipermail/gourmands/">email conversations</a>! etc.</li>
					<li>Peruse the <a href="/misc/news">Feed Me Links News</a>.</li>
				</ul>
				<li>Nb. we like acronyms</li>
			</ul>
		</div>
		<a href="#top">back to top</a>
	</div>


	<div>
		<a name="q1_2"></a>
		<div class="q">Why Feed Me Links instead of something else?</div>
		<div class="a">
			Bookmarks files:<br />
			<ul>
				<li>don't scale</li>
				<li>not easily share-able</li>
				<li>tied to a single computer/browser</li>
			</ul>
			<br />

			Other online bookmarks managers:
			<ul>
				<li>tend to have strange, geek-centric user communities</li>
				<li>present clunky, cumbersome interface</li>
				<li>avoid the fun side of social linking: friends, comments, shareable URLs, etc....</li>
			</ul>
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q9"></a>
		<div class="q">Who else uses Feed Me Links?</div>
		<div class="a">
	
			<ul>
				<li>musicians</li>
				<li>geeks</li>
				<li>writers</li>
				<li>moms</li>
				<li>kids</li>
				<li>designers</li>
				<li>painters</li>
				<li>programmers</li>
				<li><a href="/">you</a>?</li>
			</ul>
			<a href="/press">view our <b>press clippings</b></a> to read more about us.
			<p/>
			<a href="/wall-of-ancients">Marvel at the <b>WALL OF ANCIENTS</b></a>, our user hall of fame.
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q_mailing_list"></a>
		<div class="q">Is there a mailing list? How can I learn more? How can I get involved?</div>
		<div class="a">
			Yes there is! <a href="/discussion">Join us on <b>Gourmands, the Feed Me Links email discussion list</b></a>. It's relatively low-traffic.
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q3"></a>
		<div class="q">How do I report a bug?</div>
		<div class="a">
			Sign into <a href="http://issues.feedmelinks.com/">issues.feedmelinks.com</a>
			<p />
			To ask about general probleam or potential bugs you can also use <a href="/discussion">on gourmands, our <b>mailing list</b></a>.
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q2"></a>
		<div class="q">How do I add a link?</div>
		<div class="a">
			Get the <a href="/install">Feed Me Links Bookmarklet</a> and you&rsquo;re all set!
			<p/>
			Firefox/Mozilla/Netscape, IE, Safari, and Opera users can
			drag <a href="/install/traditional-install">the button</a> to
			their toolbar. 
			<p/>
			
			Windows IE users get a
			<a href="/install">Whiz-bang Feed Me Links Bookmarklet Installer</a>!
			There is also kickass integration with Firefox / Mozilla: we have an excellent 
			<a href="/install/toolbar">XUL bookmarklet interface</a>, 
			<a href="/sidebars">browser sidebars</a>.
			<p/>

			And for the users who demand more, we also provide a <a href="/flash">Flash Sidebar</a>!
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q2_1"></a>
		<div class="q">What the heck is a tag?</div>
		<div class="a">
		A Tag is the basic unit or organization on Feed Me Links. 
		In geek-speak, tags are <em>metadata</em> values, or attributes.
		<p/>
		
		<small>(Some people call organizing your content with tags &ldquo;creating a <b>folksonomy</b>&rdquo;. These people are weird.)</small>
		<p/>
		
		With Feed Me Links, you can create whatever tags
		you like. Name then with any characters, spaces,
		punctuation you like. Every tag has it's own, unique
		URL on Feed Me Links -- use these URLs to share
		lists of links with friends: e.g. My Icons tag: <a
		href="http://feedmelinks.com/f/298">http://feedmelinks.com/f/298</a>
		<p/>
	
		Rename your tags whenever you like, and the URLs
		will still work!  <p/> Tags are also used on <a
		href="http://flickr.com">Flickr</a> and <a
		href="http://www.technorati.com/tag/folksonomy">other
		places</a>.  
		</div> 
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q5"></a>
		<div class="q">Can I add all my browser bookmarks at once?</div>
		<div class="a">
			Yes, yes, and YES!
			<p/>

			We happily import favorites (aka Bookmarks,
			etc.) from Firefox, IE, and Mozilla. Your
			link names will be preserved and Feed Me
			Links will create a tagging structure for
			you which matches the folders in your
			favorites / bookmarks file.

			<p/>

			Note that we limit on the number of links
			which can be imported from a single favorites
			file (currently 1,000 links per file). This
			limit is just an arbitrary governor to prevent spammers
			-- and we will be happy to raise your import
			limit if you ask us.

			<p/> 
			<big>
			go to 
			<a class="big" href="/import/">The Importer</a> to import your links.</big>

		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q6"></a>
		<div class="q">Can I export my bookmarks from Feed Me Links to something else?</div>
		<div class="a">
			Yes. we support connections via HTTP and
			can make your links available to you as XML
			over HTTP or RSS. <a href="mailto:hide@address.com">Contact us</a> for access and
			the API details.
		</div>
		<a href="#top">back to top</a>
	</div>


	<div>
		<a name="usage_email"></a>
		<div class="q">Can I add links via email?</div>
		<div class="a">
			Yes!
			<br />
			Send emails from your mail program (or script) to <a href="mailto:hide@address.com">hide@address.com</a>.
			<p/>

			The format for messages is:	
			<p/>
			<code>
			Subject: <em>Description of the link</em>
			<p/>

			first line of email body: <em>URL of the link</em>
			<p/>

			Any additional body text will be added to the link as comments.
			</code>
			<p/>

			Note that the email address you are sending from MUST match your Feed Me Links user account email address. Otherwise the link will not be added.

		</div>
		<a href="#top">back to top</a>
	</div>


	<div>
		<a name="q6_0"></a>
		<div class="q">URL Schema / Naming Convention</div>
		<div class="a">
		<p/>

		We try to use clean, easy to type URLs for common things. 
		Note that in these examples, 22 is the tag ID for the tag "foo".

		<dl>
			<dt>view <b>all links tagged with tag "foo"</b>: 
			<dd><code>http://feedmelinks.com/f/22</code>
			
			<dt>view all links tagged with tag "foo" as <b>RSS</b>: 
			<dd><code>http://feedmelinks.com/f/22/rss</code>
			
			<dt>view all links <b>belonging to user "bar"</b> as <b>RSS</b>: 
			<dd><code>http://feedmelinks.com/u/r/bar</code>

			<dt>view all links tagged with tag "foo", <b>in condensed view</b>: 
			<dd><code>http://feedmelinks.com/f/22/c</code>

			<dt>view all links tagged with tag "foo" as a <b>firefox/mozilla sidebar</b>:
			<dd><code>http://feedmelinks.com/f/22/sidebar</code>

			<dt>view all links tagged with tag "foo", <b>sorted by date</b>:
			<dd><code>http://feedmelinks.com/f/22/by-date</code>

			<dt>view all links tagged with tag "foo", <b>sorted by name</b>:
			<dd><code>http://feedmelinks.com/f/22/by-name</code>

			<dt><b><code>by-name</code></b> and <b><code>by-date</code></b> can be combined with <b>condensed</b>, btw: 
			<dd><code>/f/22<b>/c/by-date</b></code>)

			<dt>The following 3 older URL schema 
			still work but are officially deprecated.
			They will be removed at some point in the future.

			<dd><code>f/c/22</code> (to view condensed)
			<dd><code>f/r/22</code> (to view RSS)
			<dd><code>f/s/22</code> (to view as a sidebar)

		</dl>
		<p/>
			
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="xml_rss"></a>
		<div class="q">RSS Feeds - How to syndicate your links</div>
		<div class="a">

		<big>
		RSS Feed URLs:
		</big>

		<dl>
			<dt>By <b>user</b>:
				<dd><code>http://feedmelinks.com/u/r/<b><i>USERNAME</i></b></code>
				<dd>example: <code> <a href="http://feedmelinks.com/u/r/jm3">http://feedmelinks.com/u/r/jm3</a></code>

			<dt>By <b>tag</b>:
				<dd><code>http://feedmelinks.com/f/<b><i>TAGNUMBER</i></b>/rss</code>
				<dd>example: <code><a href="http://feedmelinks.com/f/434/rss">http://feedmelinks.com/f/434/rss</a></code>
		</dl>
	
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="apis"></a>
		<div class="q">Programming Feed Me Links - The Feed Me Links API</div>
		<div class="a">

		<big>XML endpoints for the Feed Me Links REST API:</big>
		<p/>
			<code>
			# <b>authenticate using <a href="http://httpd.apache.org/docs/1.3/howto/auth.html#basic">HTTP-Basic authentication</a></b>:<br />
			<span class="subtle">http://feedmelinks.com</span>/xml/authenticate<br />
			<br />

			# <b>get all your links as XML</b>:<br />
			<span class="subtle">http://feedmelinks.com</span>/xml/user/<b>USERNAME</b><br />
			<br />

			# <b>get all your tags as XML</b>:<br />
			<span class="subtle">http://feedmelinks.com</span>/xml/tags<br />
			<br />

			# <b>get a tag's metadata as XML</b>:<br />
			<span class="subtle">http://feedmelinks.com</span>/xml/tag/<b>TAGNUM</b><br />
			(<small>or</small> /xml/f/<b>TAGNUM</b> - deprecated)<br />
			<br />

			<!--
			Sample XML:
			<code>
			<pre>&lt;posts tag="personal" is-public="false" tag-id="12" user="jm3"&gt;
  &lt;post href="http://mutt.org/doc/manual/" id="50" 
	description="mutt manual" hash="" others="0" tag="personal" 
	time="2002-03-10T14:31-05:00"/&gt;
  ...
&lt;posts&gt;</pre>
-->

			# <b>how to get a list of your peeps as XML</b>:<br />
			<span class="subtle">http://feedmelinks.com</span>/xml/peeps<br />
			</code>
			<p/>
			
			<a href="/help/including-feeds">Information about feeds and Javascript</a>
	
			<p/>
			<a href="mailto:hide@address.com">Email us</a> for additional help or documentation...
	
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q7"></a>
		<div class="q">How do I include a list of my links on my blog/webpage?</div>
		<div class="a">
			<a href="/help/including-feeds">See Help &gt; Including Feeds</a>
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q8"></a>
		<div class="q">How do I subscribe to folders or users that I like?</div>
		<div class="a">
			<ol>
				First, Get a newsreader. I recommend <a href="http://sage.mozdev.org/">Sage</a> if you use Firefox or 
				<a href="http://bloglines.com">bloglines</a>,
				although many folks enjoy netnewswire pro or blo.gs.
				Point your newsreader to the Feed Me Links feeds you want to subscribe to. <a href="/help/including-feeds">These instructions may prove handy</a>.
			</ol>
		</div>
		<a href="#top">back to top</a>
	</div>

	<div>
		<a name="q2_2"></a>
		<div class="q">Unicode</div>
		<div class="a">
			Si! Ja! Oui! Da! (etc.)
			<br />
			We have people linking from France, Italy, Canada, Japan, China, Finland, etc.
			<p/>
			View our <a href="/testing/unicode-support">Unicode examples page</a>
	
		</div> <a href="#top">back to top</a>
	</div>

	<div>
		<a name="q4"></a>
		<div class="q">Are my private links really private?</div>
		<div class="a">
		yes
		</div>
		<a href="#top">back to top</a>
	</div>

</div>

<!-- need these to push the content up when linking to the bottom-most topics... -->
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />

<center>
<a href="/">Feed Me Links</a>
</center>

<div>
	<br />
	<small>This page last revised at <?=date( "H:i o\\n F d, Y.",getlastmod() )?>.</small>
</div>

</div>
</body>
</html>
Return current item: FeedMeLinks, Social BookmarkingSince2002