ブックマークレットは、ブラウザのブックマークに登録しておく短いプログラムです。
Wikino用のブックマークレットを用意しておくと、今読んでいるウェブページのタイトルとURLを持ったまま、新しいページの編集画面をワンクリックで開けます。
ブックマークレットからのページ作成は次のような場面で役に立ちます。
- 気になった記事を、あとで読み返せるようにWikinoに残しておきたいとき
- 記事の中で心に残った部分を、引用としてページに書き留めておきたいとき
- 集めた記事にWikiリンクでタグを付けて、話題ごとに辿れるようにしたいとき
ブックマークレットを押すと、指定したトピックに新しいページが作られ、その編集画面が開きます。
タイトルと本文はあらかじめ入った状態になっているので、必要なところだけ直して「トピックに公開」を押せば、そのまま公開できます。
ページ作成用のURL
ブックマークレットの土台になるのは、新しいページを作るための次のURLです。
https://wikino.app/s/shimbaco/topics/3/pages/new
s/のあとがスペースの識別子、topics/のあとがトピックの番号です。自分のURLを調べるには、ページを作りたいトピックの画面を開き、アドレス欄に表示されているURL(例: https://wikino.app/s/shimbaco/topics/3)の末尾に/pages/newを足してください。
このURLには、ページの初期値として次の2つを付けられます。どちらか一方だけでも構いません。
title: ページのタイトルになりますbody: ページの本文になります。Markdown形式で書けます
例えば次のURLを開くと、「メモ」というタイトルと「今日のメモ」という本文が入った状態で編集画面が開きます。
https://wikino.app/s/shimbaco/topics/3/pages/new?title=メモ&body=今日のメモ
渡した値は下書きとして保存されます。この時点ではまだ公開されていないので、内容を確かめてから「トピックに公開」を押してください。
ブックマークレットを用意する
- 下の内容をすべてコピーします。
トピックのURLの部分を、自分のトピックのURL(例:https://wikino.app/s/shimbaco/topics/3)に置き換えます。- ブラウザで新しいブックマークを作り、名前を「Wikinoに保存」などにして、URL欄に手順2の内容を貼り付けて保存します。
javascript:location.href='トピックのURL/pages/new?title='+encodeURIComponent(document.title+' - '+location.hostname)+'&body='+encodeURIComponent(location.href+(getSelection().toString()?'\n\n> '+getSelection().toString():''))
ブラウザによっては、URL欄に貼り付けたときに先頭のjavascript:が取り除かれることがあります。その場合は、貼り付けたあとにjavascript:を手で書き足してください。
あとは残しておきたいウェブページを開いた状態でこのブックマークを選ぶだけで、Wikinoの編集画面が開きます。引用したい部分を選択してから押すと、その文章も一緒に持ってこられます。
ブックマークレットが入れる内容
上の内容は、タイトルと本文をそれぞれ次のように組み立てます。
- タイトル: 「記事のタイトル - ドメイン」の形にします(例:
Goのエラーハンドリング - example.com)。ドメインを添えておくと、似たようなタイトルの記事が集まっても、同じトピックの中でタイトルが重なりにくくなります - 本文: 記事のURLを入れます。押したときに文章を選択していれば、その下に引用として続きます
同じ話題の記事をあとから辿れるようにしたいときは、編集画面で[[あとで読む]]のようにWikiリンクを書き足してから公開してください。書いた名前のページが自動で作られ、そのページから同じタグを付けた記事に行き来できるようになります。
注意点
- 押すたびに新しいページが作られる: ブックマークレットを押すと、その時点で新しいページが作られます。書きかけでやめたものは公開されないまま残るので、不要であれば下書きのページ一覧から下書きの削除で片付けてください。
- タイトルが重なると公開できない: 同じトピックの中に同じタイトルのページがあると、公開しようとしたときにエラーが表示されます。その場合は編集画面でタイトルを直してから公開してください。詳しくはページタイトルの決まりを参照してください。
- 参加しているトピックにだけ作れる: ページを作れるのは、そのトピックに参加しているメンバーだけです。参加していないトピックのURLを開いても、ページは作られません。
- ログインしていないとき: ログイン画面が表示されます。ログインすると元のURLに戻り、そのままページが作られます。
- 長い文章には向かない: タイトルと本文はURLに含めて渡すため、長すぎる内容は途中で切れることがあります。記事のタイトルとURL、数段落程度の引用を目安にしてください。