mirror of
https://github.com/sissbruecker/linkding
synced 2024-11-23 03:43:10 +00:00
54ce6d5fe6
* Add basic unread bookmarks feed * Generate user-specific feed * Add feed tests * Add all bookmarks feed * Add feed token admin * Add note about renewing URLs * Add support for query parameter * Fix rebase issues * Improve docs on feeds integration Co-authored-by: Sascha Ißbrücker <sascha.issbruecker@gmail.com>
68 lines
3.9 KiB
HTML
68 lines
3.9 KiB
HTML
{% extends "bookmarks/layout.html" %}
|
|
|
|
{% block content %}
|
|
<div class="settings-page">
|
|
|
|
{% include 'settings/nav.html' %}
|
|
|
|
<section class="content-area">
|
|
<h2>Browser Extension</h2>
|
|
<p>The browser extension allows you to quickly add new bookmarks without leaving the page that you are on. The extension is available in the official extension stores for:</p>
|
|
<ul>
|
|
<li><a href="https://addons.mozilla.org/de/firefox/addon/linkding-extension/" target="_blank">Firefox</a></li>
|
|
<li><a href="https://chrome.google.com/webstore/detail/linkding-extension/beakmhbijpdhipnjhnclmhgjlddhidpe" target="_blank">Chrome</a></li>
|
|
</ul>
|
|
<p>The extension is <a href="https://github.com/sissbruecker/linkding-extension" target="_blank">open source</a> as well, which enables you to build and manually load it into any browser that supports Chrome extensions.</p>
|
|
<h2>Bookmarklet</h2>
|
|
<p>The bookmarklet is an alternative, cross-browser way to quickly add new bookmarks without opening the linkding application
|
|
first. Here's how it works:</p>
|
|
<ul>
|
|
<li>Drag the bookmarklet below into your browsers bookmark bar / toolbar</li>
|
|
<li>Open the website that you want to bookmark</li>
|
|
<li>Click the bookmarklet in your browsers toolbar</li>
|
|
<li>linkding opens in a new window or tab and allows you to add a bookmark for the site</li>
|
|
<li>After saving the bookmark the linkding window closes and you are back on your website</li>
|
|
</ul>
|
|
<p>Drag the following bookmarklet to your browsers toolbar:</p>
|
|
<a href="javascript: {% include 'bookmarks/bookmarklet.js' %}"
|
|
class="btn btn-primary">📎 Add bookmark</a>
|
|
</section>
|
|
|
|
<section class="content-area">
|
|
<h2>REST API</h2>
|
|
<p>The following token can be used to authenticate 3rd-party applications against the REST API:</p>
|
|
<div class="form-group">
|
|
<div class="columns">
|
|
<div class="column col-6 col-md-12">
|
|
<input class="form-input" value="{{ api_token }}" readonly>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<p>
|
|
<strong>Please treat this token as you would any other credential.</strong>
|
|
Any party with access to this token can access and manage all your bookmarks.
|
|
If you think that a token was compromised you can revoke (delete) it in the <a href="{% url 'admin:authtoken_tokenproxy_changelist' %}">admin panel</a>.
|
|
After deleting the token, a new one will be generated when you reload this settings page.
|
|
</p>
|
|
</section>
|
|
|
|
<section class="content-area">
|
|
<h2>RSS Feeds</h2>
|
|
<p>The following URLs provide RSS feeds for your bookmarks:</p>
|
|
<ul>
|
|
<li><a href="{{ all_feed_url }}">All bookmarks</a></li>
|
|
<li><a href="{{ unread_feed_url }}">Unread bookmarks</a></li>
|
|
</ul>
|
|
<p>
|
|
All URLs support appending a <code>q</code> URL parameter for specifying a search query.
|
|
You can get an example by doing a search in the bookmarks view and then copying the parameter from the URL.
|
|
</p>
|
|
<p>
|
|
<strong>Please note that these URLs include an authentication token that should be treated like any other credential.</strong>
|
|
Any party with access to these URLs can read all your bookmarks.
|
|
If you think that a URL was compromised you can delete the feed token for your user in the <a href="{% url 'admin:bookmarks_feedtoken_changelist' %}">admin panel</a>.
|
|
After deleting the feed token, new URLs will be generated when you reload this settings page.
|
|
</p>
|
|
</section>
|
|
</div>
|
|
{% endblock %}
|