Scrapboxハンズオン
#scrapboxthon
雑談
waiwaitkgshn.icon*3
Scrapboxに参加しよう
このScrapboxへの参加方法を参照
important.icon 重要な点
このScrapboxへの参加はCode of ConductおよびCode of Conductガイドラインへの同意とみなします
このScrapboxに書かれた記事のライセンスはCC BY 4.0とします
以下のリンクからこのScrapboxプロジェクトへ参加できます
https://scrapbox.io/projects/c4j/invitations/858de5b70dd611ce66aad4c4e16795a9
Googleアカウントでログインする必要があります
Scrapboxの基本概念
Scrapboxはインラインエディタ指向のリアルタイム同時編集に対応したWikiシステムです
インラインエディタとは、情報を箇条書きにしていくエディタです
インデントによって情報の階層構造化を表現します
Tabキーを押すことによって、インデントを上げることができます
Shift+Tabキーを押すことによって、インデントを下げることができます
この機能知らなかったtkgshn.icon*2
リアルタイム同時編集とは、Google Docsのように、複数人が同一のファイルを同時に編集できることです
Wikiシステムとは、複数人で編集できて、ページ内の文章中のキーワードをリンクで他のページにつなげていくことができるシステムです
この、インラインエディタとWikiシステムを融合し、リアルタイム同時編集を実現したことがScrapboxのすごいところです
Scrapboxを使いこなす上での重要なポイントは、Wikiシステムによるキーワードのリンクです
/shokai/脳内をそのまま出力したい
SlackからScrapboxに議論のプラットフォームを移行していきたい#60a5f41f09c5f20000707607
HackMDはMarkdown記法をリアルタイム同時編集できるようにしている点は便利だが、Wiki的なリンク機能がない
Wiki的なリンク機能があれば、文章中でわからない言葉・概念に遭遇したらリンクを辿ることによってドメイン知識を得ることができるので、途中参加者や新参者に優しい
[]で文字列を囲むことによって、リンクになります(リンク記法)
文字列
[リンク]→リンク
リンクは、マウスのドラッグで文字列を選択すると現れるツールチップメニューからもできます
https://gyazo.com/b812984954a1cb98b57127789dcf7150
Scrapboxはプロジェクトという単位で分かれていて、リンクは、基本的にはScrapboxのプロジェクト内部でのみ繋がります
いま見ているのは https://scrapbox.io/c4j/というプロジェクトです
このプロジェクト内で[リンク]と書くと、https://scrapbox.io/c4j/リンクに繋がります
別のプロジェクト、たとえば https://scrapbox.io/yuiseki/ にあるキーワードとは繋がりません
基本的には、このインデントとリンクさえ理解できれば、かなり便利にScrapboxを使いこなせます
Scrapboxは何ではないか
Scrapboxは美しく整形された文章を書くためのツールではありません
レポート、論文、小説などを書くなら別のツールを使ったほうが良いでしょう
Scrapboxには目次機能はありません
目次が必要なほど長いページを書くなら別のページに切り出したほうが良いという思想です
Scrapboxには高度な文字装飾機能はありません
太字、イタリック体、取り消し線 アンダーライン のみがあります
質疑応答
質問があったらこちらへ
やってみよう
ここに箇条書きをしてみよう
レポート、論文、小説などを書くなら別のツールを使ったほうが良いでしょう
とは言いつつ実はtexの記法が採用されていて数式なんかは手軽に描けたりしますao.icon
[$ ]で数式を囲むとできます
$ TeX記法$ x^2+y^2=1
$ \int^{\infty}_0e^{i\omega t}dt
こんな感じで書き込めるのかtkgshn.icon*3 書き込みかたの_.icon*3
同意!!yuiseki.icon*10tkgshn.icon*2ksmesho.icon*5mochi_yj.icon
でかいアイコンtkgshn.icon
文字装飾記法
吹き出し
tkgshn.iconhoge
逆は できなさそう
一応できるのです!tkgshn.icon
/suto3/UserCSS:吹き出し記法#5f2cbc125b98c2000091d461
設定が必要です!!tkgshn.icon
ナルホド〜 silloi.icon
こう? } koshiba77754.icon
吹き出し記法Koichiro Shiratori.icon
びっくり記法
シャープ記法
UserCSSで実現している
settings
UserScriptなどでカスタマイズできたりします!
個人的にscrapbox結構使ってるのですがこの記法は知りませんでしたao.icon
yuisekiさん説明うまいから自分でも出来ました
適当なキーワードをリンクにしてみよう
申請主義
#proj-poverty
work with peopleksmesho.iconksmesho.icon*4
申請主義
貧困yuiseki.icon
貧困問題
Write Less, Do More
インクルソンyuiseki.icon
インクルーシブ
インクルソンかたの_.icon
ネコ
/emoji/nekoatsume.icon
ああ
色々な記法を試してみよう
引用
太字
[* 大事なことなので太字で書きました]
グラミン銀行
トマト キーワードは太字になるか
太字
あああ
*
リンク
JunNa.icon
プロフィールページ
Scrapboxにはプロフィールページという特別なページがあります
/help-jp/自分のページとアイコン
プロフィールページとは、「Scrapboxのユーザー名と同じ文字列がタイトルになっているページ」です
たとえばユーザー名が yuiseki の場合は yuiseki がプロフィールページです
プロフィールページのタイトルは、基本的に、https://scrapbox.io/projects/c4j/settings/members のここの文字列を元に決定されます
https://gyazo.com/6b1e79e270a4b0253b66343c1eabc08f
これを変えるためには https://scrapbox.io/settings/profile にアクセスします
アイコン挿入機能
自分のプロフィールページに画像をアップロードすると、自分のアイコンが設定できます
/help-jp/画像アップロード
ページ内の一番目にある画像が、そのページのタイトル画像になります
/help-jp/ページタイトル画像
ctrl+i で自分のプロフィールページのタイトル画像をアイコンとして簡単に挿入することができますyuiseki.icon
個人的な意見・見解を述べる場合はctrl+iで自分のアイコンを置くと発言者がわかりやすくて良いですyuiseki.icon
ctrl+iを連打すると、たくさんアイコンが表示できます
例:yuiseki.icon*10
強く同意する場合などはたくさんアイコンを置くことで意見をアピールできます
やってみよう
important.icon 注意点
ユーザー表示名やアバターアイコン画像もCode for JapanのCode of Conductガイドラインに従う必要があります
Code of Conductガイドライン#60837d14d7d3c30000cd41d0
また、あなたの表示名・アイコン/アバター・背景に映るモノも、オンラインで配信される可能性があり、あなたに使用責任が伴います。法令(特に著作権関係)と行動規範(特にハラスメント関連)を遵守するよう注意を払ってください。
適当なページの適当な場所にカーソルを置き、 ctrl+i を押すと、プロフィールページがない場合、「Create profile page」というツールチップメニューが表示されるはずです
https://gyazo.com/d484d89e4bd36ad454d65894ad2e597c
これをクリックすると、自分のプロフィールページの雛形が作られます
https://gyazo.com/afe38833ca6adb083a613f47666c0125
自己紹介テンプレートを元にプロフィールページを書いてみよう
tkgshn.icontkgshn Scrapboxらぶ
そろそろ経緯の説明に移って行った方が良さそうですねtkgshn.icon
yuiseki.iconyuiseki
mochi_yj.iconmochi yj
ao.icon
ksmesho.iconksmesholove and peace
sogo2.icon つくれました! sogo2
Fukushima Masayo.icon]←福島も画像上げれず困り中です・・・
otkzh.iconotkzhにゃーん
silloi.icon silloi
Koichiro Shiratori.icon ←アイコンが写真にならなくて困り中
[mtokura.icon]
koshiba77754.icon
yosfujioka
自分のプロフィールページに、アバターアイコン画像を設定しよう
画像をドラッグアンドドロップすることで、画像をアップロードできます
コピーアンドペーストでもアップロードすることができます
アイコンを挿入してみよう
ctrl+iを押してアイコンを挿入してみよう
yuiseki.icon*3
ページの編集権限とポリシー
Scrapboxは、プロジェクトの参加者はすべてのページを閲覧、編集、削除できます
特定のページを編集ロックするようなことはできません
特定のページを限定公開にするようなことはできません
下書き機能のようなものはありません。書き途中でも即座に公開されます。
他人が作ったページでも、もちろん編集できます
Wikiとはそういうものです
勝手に編集されたからといって怒らないでください
編集するにあたって事前の許可は不要です
他人のプロフィールページも勝手に編集できてしまいます
キーワードにリンクを張る程度の軽微かつ役に立つ編集は良いとしましょうyuiseki.icon
個人のアイコンが置かれている行は、勝手に内容を編集しないようにしましょう
その人の発した考えや意見のはずなので、それを別のものに書き換えてしまうのは問題があります
キーワードにリンクを張る程度の軽微かつ役に立つ編集は良いとしましょうyuiseki.icon
積極的に編集してコラボレーションしていきましょう
もちろん、Code of Conductガイドラインを守る範囲で
Slackでの発言の引用・公開について
Slackでの他人の発言をScrapbox上で引用し公開したい場合は、念の為に相手に確認しましょう
Slackでの発言を許可なくすべて公開されても問題ないという人は、Slackのプロフィール欄にその旨を意志表明しておくと良いです
https://gyazo.com/c50bf1a337b4bbe2984351edb0580a80
質疑応答
キーワードは積極的にリンクにしよう
Scrapboxには、あるページ(キーワード)に直接リンクしているページを自動的にまとめて一覧できる機能があります
たとえば
プロフィールページの雛形には #member というハッシュタグへのリンクがついているので、 #member を見るといまこのプロジェクトに作られている全員のプロフィールページが一覧できる
https://gyazo.com/39bccb28b5d81d91ae4ee96165cf0de3
この機能を活用すると、同じ興味関心を持つ人や、スキルを持っている人を探すことに使えます
「Ruby, Python, Typescript, Reactの経験があります」という自己紹介文は、
「Ruby, Python, Typescript, React.jsの経験があります」のように、一般的なキーワードをリンクするべき
こうすることによって、Pythonが使える人物が自動的にまとめられる
https://gyazo.com/f4ae2a79da752b30f4b503b1898ae01e
ハッシュタグ記法
#〇〇 でも、リンクと同じ働きをします
#貧困 = [貧困]
Scrapboxには関連ページリストという機能もあります
/help-jp/関連ページリスト
これは2 hop linkとも呼ばれています
/shokai/2 hop link
ページ内であるキーワードをリンクにした時に、そのページに直接リンクしているページだけではなく、そのキーワードにリンクしているページの一覧が関連ページとして表示されます
ページが存在しないキーワードでも、積極的にリンクにしよう
Scrapboxの大きな特徴のひとつとして、ページが存在しなくてもページが存在するかのように動くという点があります
https://gyazo.com/3e96d649ec36898e4f73a685ed5ab5e6
「空き家」というページは2021/5/21現在存在していないが、「空き家」というキーワードへリンクしているページの一覧を見ることができる
とにかく重要そうなキーワードは片っ端からリンクを張ったほうが良いです
リンク記法には補完が効きます
インクルーシブ
インクルーシヴ
表記ゆれとかもこれによってある程度マシになったりします
アイコン記法
yuiseki.iconは、[yuiseki.icon]というアイコン記法になっています
/help-jp/アイコン記法
[ページタイトル.icon]と書くことで、自分のプロフィールページのアイコンだけではなく、Scrapboxにあるあらゆるページのタイトル画像をアイコンとして表示することができます
これを活用すると、たとえば以下のように使えます
waiting.icon 作業待ち
doing.icon 作業中
done.icon 完了
thinking.icon 考え中
important.icon 注意
Civichat.iconとかも可能になる!tkgshn.icon
議事録を爆速で取るためのTips
インラインエディタの思想に慣れましょう
箇条書き
アジェンダを確認して、それを箇条書きにしておく
パワポのスライド等は必ず章構成になっているので、それをインラインエディタのインデントにしましょう
パワポのページごとにインデントするのもありです
1ページ目
概要説明
2ページ目
手法説明
3ページ目
結果説明
4ページ目
考察
文字での議事録に限界がある場合、Gyazoを使いこなすことをオススメしますyuiseki.icon
https://gyazo.com/d144a65d88ca715ebb8595e7775c4cbb