2018-06-10 16:18:07 +02:00
<!doctype html>
< html >
< head >
2018-06-11 23:18:34 +02:00
< title > Web Clipper | Joplin< / title >
2018-06-10 16:18:07 +02:00
< meta charset = "utf-8" >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
< link rel = "stylesheet" href = "https://joplin.cozic.net/css/bootstrap.min.css" >
< link rel = "shortcut icon" type = "image/x-icon" href = "favicon.ico" >
< link rel = "stylesheet" href = "https://joplin.cozic.net/css/fontawesome-all.min.css" >
< script src = "https://joplin.cozic.net/js/jquery-3.2.1.slim.min.js" > < / script >
< style >
body {
background-color: #F1F1F1;
color: #333333;
}
table {
margin-bottom: 1em;
}
td, th {
padding: .8em;
border: 1px solid #ccc;
}
h1, h2 {
border-bottom: 1px solid #eaecef;
padding-bottom: 0.3em;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
font-weight: 600;
font-size: 2em;
margin-bottom: 16px;
}
h2 {
font-size: 1.6em;
}
h3 {
font-size: 1.3em;
}
code {
color: black;
background-color: #eee;
border: 1px solid #ccc;
font-size: .85em;
}
pre code {
border: none;
}
pre {
font-size: .85em;
}
#toc ul {
margin-bottom: 10px;
}
#toc {
padding-bottom: 1em;
}
.title-icon {
height: 2em;
}
.sub-title {
font-weight: bold;
font-size: 1.5em;
}
.container {
background-color: white;
padding: 0;
box-shadow: 0 10px 20px #888888;
}
table.screenshots {
margin-top: 2em;
margin-bottom: 2em;
}
table.screenshots th {
height: 3em;
text-align: center;
}
table.screenshots th,
table.screenshots td {
border: 1px solid #C2C2C2;
}
img[align="left"] {
margin-right: 10px;
margin-bottom: 10px;
}
.mobile-screenshot {
height: 40em;
padding: 1em;
}
.cli-screenshot-wrapper {
background-color: black;
vertical-align: top;
padding: 1em 2em 1em 1em;
}
.cli-screenshot {
font-family: "Monaco", "Inconsolata", "CONSOLAS", "Deja Vu Sans Mono", "Droid Sans Mono", "Andale Mono", monospace;
background-color: black;
color: white;
border: none;
}
.cli-screenshot .prompt {
color: #48C2F0;
}
.top-screenshot {
margin-top: 2em;
text-align: center;
}
.header {
position: relative;
padding-left: 2em;
padding-right: 2em;
padding-top: 1em;
padding-bottom: 1em;
color: white;
background-color: #2B2B3D;
}
.header a h1 {
color: white;
}
.content {
padding-left: 2em;
padding-right: 2em;
padding-bottom: 2em;
padding-top: 2em;
}
.forkme {
position: absolute;
right: 0;
top:0;
}
.nav-wrapper {
position: relative;
width: inherit;
}
.nav {
background-color: black;
display: table;
width: inherit;
}
.nav.sticky {
position:fixed;
top: 0;
width: inherit;
box-shadow: 0 0 10px #000000;
}
.nav a {
color: white;
display: inline-block;
padding: .6em .9em .6em .9em;
}
.nav ul {
padding-left: 2em;
margin-bottom: 0;
display: table-cell;
min-width: 250px;
}
.nav ul li {
display: inline-block;
padding: 0;
}
.nav li.selected {
background-color: #222;
font-weight: bold;
}
.nav-right {
display: table-cell;
width: 100%;
text-align: right;
vertical-align: middle;
line-height: 0;
}
.nav-right .share-btn {
display: none;
}
.nav-right .small-share-btn {
display: none;
}
.footer {
padding-top: 1em;
border-top: 1px solid #d4d4d4;
margin-top: 2em;
color: gray;
font-size: .9em;
}
@media all and (min-width: 400px) {
.nav-right .share-btn {
display: inline-block;
}
.nav-right .small-share-btn {
display: none;
}
}
< / style >
< / head >
< body >
< div class = "container" >
< div class = "header" >
< a class = "forkme" href = "https://github.com/laurent22/joplin" > < img src = "https://joplin.cozic.net/images/ForkMe.png" / > < / a >
< a href = "https://joplin.cozic.net" > < h1 id = "joplin" > < img class = "title-icon" src = "https://joplin.cozic.net/images/Icon512.png" > oplin< / h1 > < / a >
< p class = "sub-title" > An open source note taking and to-do application with synchronisation capabilities.< / p >
< / div >
< div class = "nav-wrapper" >
< div class = "nav" >
< ul >
< li class = "" > < a href = "https://joplin.cozic.net/" title = "Home" > < i class = "fa fa-home" > < / i > < / a > < / li >
< li > < a href = "https://discourse.joplin.cozic.net" title = "Forum" > Forum< / a > < / li >
< li > < a class = "help" href = "#" title = "Menu" > Menu< / a > < / li >
< / ul >
< div class = "nav-right" >
2018-06-15 20:28:58 +02:00
<!--
< iframe class = "share-btn" src = "https://www.facebook.com/plugins/share_button.php?href=http%3A%2F%2Fjoplin.cozic.net&layout=button&size=small&mobile_iframe=true&width=60&height=20&appId" width = "60" height = "20" style = "border:none;overflow:hidden" scrolling = "no" frameborder = "0" allowTransparency = "true" > < / iframe >
< iframe class = "share-btn" src = "https://platform.twitter.com/widgets/tweet_button.html?url=http%3A%2F%2Fjoplin.cozic.net" width = "62" height = "20" title = "Tweet" style = "border: 0; overflow: hidden;" > < / iframe >
-->
2018-06-10 16:18:07 +02:00
< iframe class = "share-btn share-btn-github" src = "https://ghbtns.com/github-btn.html?user=laurent22&repo=joplin&type=star&count=true" frameborder = "0" scrolling = "0" width = "100px" height = "20px" > < / iframe >
< / div >
< / div >
< / div >
< div class = "content" >
< div id = "toc" > < ul >
< li >
< p > Applications< / p >
< ul >
< li > < a href = "https://joplin.cozic.net/desktop" > Desktop application< / a > < / li >
< li > < a href = "https://joplin.cozic.net/mobile" > Mobile applications< / a > < / li >
< li > < a href = "https://joplin.cozic.net/terminal" > Terminal application< / a > < / li >
2018-06-18 19:59:54 +02:00
< li > < a href = "https://joplin.cozic.net/clipper" > Web Clipper< / a > < / li >
2018-06-10 16:18:07 +02:00
< / ul >
< / li >
< li >
< p > Support< / p >
< ul >
< li > < a href = "https://discourse.joplin.cozic.net" > Joplin Forum< / a > < / li >
< li > < a href = "https://joplin.cozic.net/e2ee" > How to enable end-to-end encryption< / a > < / li >
< li > < a href = "https://joplin.cozic.net/spec" > End-to-end encryption spec< / a > < / li >
< li > < a href = "https://joplin.cozic.net/debugging" > How to enable debug mode< / a > < / li >
2018-09-28 22:03:28 +02:00
< li > < a href = "https://joplin.cozic.net/api" > API documentation< / a > < / li >
2018-06-10 16:18:07 +02:00
< li > < a href = "https://joplin.cozic.net/faq" > FAQ< / a > < / li >
< / ul >
< / li >
< li >
< p > About< / p >
< ul >
< li > < a href = "https://joplin.cozic.net/changelog" > Changelog< / a > < / li >
< li > < a href = "https://joplin.cozic.net/stats" > Stats< / a > < / li >
< li > < a href = "https://joplin.cozic.net/donate" > Donate< / a > < / li >
< / ul >
< / li >
< / ul >
< / div >
2018-06-18 19:54:48 +02:00
< h1 id = "joplin-web-clipper" > Joplin Web Clipper< / h1 >
< p > The Web Clipper is a browser extension that allows you to save web pages and screenshots from your browser. To start using it, open the Joplin desktop application, go to the < strong > Web Clipper Options< / strong > and follow the instructions.< / p >
2018-06-18 20:08:07 +02:00
< p > < img src = "https://joplin.cozic.net/images/WebExtensionScreenshot.png" style = "max-width: 50%; border: 1px solid gray;" > < / p >
2018-06-11 23:10:04 +02:00
< h1 id = "troubleshooting-the-web-clipper-service" > Troubleshooting the web clipper service< / h1 >
2018-06-10 16:18:07 +02:00
< p > The web clipper extension and the Joplin application communicates via a service, which is started by the Joplin desktop app.< / p >
< p > However certain things can interfer with this service and prevent it from being accessible or from starting. If something does not work, check the following:< / p >
< ul >
2018-06-18 19:54:48 +02:00
< li > Check that the service is started. You can check this in the Web clipper options in the desktop app.< / li >
< li > Check that the port used by the service is not blocked by a firewall. You can find the port number in the Web clipper options in the desktop Joplin application.< / li >
< li > Check that no proxy is running on the machine, or make sure that the requests from the web clipper service are filtered and allowed. For example < a href = "https://github.com/laurent22/joplin/issues/561#issuecomment-392220191" > https://github.com/laurent22/joplin/issues/561#issuecomment-392220191< / a > < / li >
2018-06-10 16:18:07 +02:00
< / ul >
< p > If none of this work, please report it on the < a href = "https://discourse.joplin.cozic.net/" > forum< / a > or < a href = "https://github.com/laurent22/joplin/issues" > GitHub issue tracker< / a > < / p >
2018-06-11 23:10:04 +02:00
< h1 id = "debugging-the-extension" > Debugging the extension< / h1 >
< h2 id = "in-chrome" > In Chrome< / h2 >
2018-06-10 16:18:07 +02:00
< p > To provide as much information as possible when reporting an issue, you may provide the log from the various Chrome console.< / p >
< p > To do so, first enable developer mode in < a href = "chrome://extensions/" > chrome://extensions/< / a > < / p >
2018-06-18 19:54:48 +02:00
< ul >
< li > Debugging the popup: Right-click on the Joplin extension icon, and select " Inspect popup" .< / li >
< li > Debugging the background script: In < code > chrome://extensions/< / code > , click on " Inspect background script" .< / li >
< li > Debugging the content script: Press Ctrl+Shift+I to open the console of the current page.< / li >
< / ul >
2018-06-11 23:10:04 +02:00
< h2 id = "in-firefox" > In Firefox< / h2 >
< ul >
< li > Open < a href = "about:debugging" > about:debugging< / a > in Firefox.< / li >
< li > Make sure the checkox " Enable add-on debugging" is ticked.< / li >
< li > Scroll down to the Joplin Web Clipper extension.< / li >
< li > Click on " Debugging" - that should open a new console window.< / li >
< / ul >
< p > Also press F12 to open the regular Firefox console (some messages from the Joplin extension can go there too).< / p >
< p > Now use the extension as normal and replicate the bug you' re having.< / p >
< p > Copy and paste the content of both the debugging window and the Firefox console, and post it to the < a href = "https://discourse.joplin.cozic.net/" > forum< / a > .< / p >
2018-06-18 19:54:48 +02:00
< h1 id = "using-the-web-clipper-service" > Using the Web Clipper service< / h1 >
2018-09-29 13:54:44 +02:00
< p > The Web Clipper service can be used to create, modify or delete notes, notebooks, tags, etc. from any other application. It exposes an API with a number of methods to manage Joplin' s data. For more information about this API and how to use it, please check the < a href = "https://joplin.cozic.net/api" > Joplin API documentation< / a > .< / p >
2018-06-10 16:18:07 +02:00
< script >
function stickyHeader() {
return; // Disabled
if ($(window).scrollTop() > 179) {
$('.nav').addClass('sticky');
} else {
$('.nav').removeClass('sticky');
}
}
$('#toc').hide();
$('.help').click(function(event) {
event.preventDefault();
$('#toc').show();
});
$(window).scroll(function() {
stickyHeader();
});
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-103586105-1', 'auto');
ga('send', 'pageview');
< / script >
< div class = "footer" >
Copyright (c) 2016-2018 Laurent Cozic
< / div >
< / body >
< / html >