コンテンツ
プレビュー
生成後、ここにQRコードが表示されます
デザインテンプレート
ワンクリックのスタイル — すべてスキャン可能
カラープリセット
モジュールのグラデーション
背景のグラデーション
コードQRコードを使う理由
スライドや印刷した配布資料はソースコードを読むのに向いておらず、プロジェクターに映った長いリポジトリのアドレスを手で打ち込んでも、まずうまくいきません。コードQRコードは、あなたが指し示したいソースそのものを開きます。GitHub、GitLab、Bitbucket、Codeberg、あるいは自前のサーバーにあるリポジトリ、単一のファイル、スニペット、行の範囲のどれにでも使えます。リンクはコードのホスティング先から持ってきて、そのまま貼れば足ります。コミットを指す固定リンクは、ブランチが先へ進んでも同じコードを見せ続けます。対してブランチへのリンクは、常にいちばん新しい版を表示します。読み取りで開くのは閲覧用のページだけで、スマートフォンの上で何かが動くことはありません。非公開のリポジトリでは、これまでどおりログインを求められます。
- 聞き手は、話題にしているファイルや行をその場で正確に開けます。
- GitHubに限らず、どんなコードホスティングでも使えます。
- コミットのリンクはコードを固定し、ブランチのリンクは最新版に追従します。
- 講演が終わったあと、行き先を改良したサンプルへ変えることもできます。
開発者イベントの講演者
最後のスライドから、デモで使ったコードがすべて入ったリポジトリを開いてもらいます。
プログラミングのワークショップ
演習シートごとに、最初は雛形のファイル、あとで解答へとリンク先を移します。
組み込み・ハードウェアのプロジェクト
基板にプリントしたコードから、そのボードのファームウェアのソースへたどれます。
技術書
紙面に載せたコードリストから、そのまま動かせる完全なサンプルへオンラインでつなぎます。
紙で行うコードレビュー
アーキテクチャ図の各ボックスに、それが表すモジュールへのリンクを付けます。
その他のファイルQRコード
同じカテゴリー。コンテンツに合ったタイプをお選びください。
ソースコードQRコード作成ツール
コードQRコードは、開発者をソースコードへ案内します。GitHub、GitLab、Bitbucketなどのコードホスティング上にあるリポジトリ、単一ファイル、スニペット、ハイライトした行の範囲に対応します。
このQRコードとは?
入力したアドレスがそのまま開くので、GitHubの#L10-L20のような行リンクや、固定したコミットへのリンクも問題なく機能します。アクセスはホスティング側のルールに従い、非公開のリポジトリには引き続きログインが必要です。
主な活用シーン
- ✓サンプルのリポジトリを示す、勉強会や技術イベントの発表スライド。
- ✓演習ごとの解答ファイルにつながるワークショップのシート。
- ✓ファームウェアのソースへのリンクをラベルにしたハードウェアの基板。
- ✓特定のコード例を参照する印刷ドキュメント。
QRコードの作成方法
見せたいリポジトリ、ファイル、行を、コードホスティング上で開きます。
リンクを控えます。中身が変わると困るなら、コミットを指す固定リンクを選びます。
未ログインの端末からページを開き、誰でも閲覧できるかを確かめます。
説明するスライド、演習、部品のすぐ横にコードを配置します。
よくある質問
読み取った瞬間にコードが動き出すことは?
いいえ。開くのはソースを読めるウェブページだけで、スマートフォン上では何も実行されません。
GitHubタイプとの違いは何ですか?
GitHubタイプはユーザー名からプロフィールへのリンクを作ります。こちらはどのコードホスティングにも対応し、ファイル、行、コミットまで正確に指定できます。
どのコードホスティングで使えますか?
ウェブ上のリンクを持つサービスであれば、種類を問いません。GitHub、GitLab、Bitbucket、Codeberg、自社運用のサーバーなどです。
特定の行を目立たせることはできますか?
ホスティング側が行単位のリンクに対応していれば可能です。GitHubでは、ファイルのリンクの末尾に#L10-L20を足すと、その行がハイライトされます。
ブランチとコミット、リンクするならどちらですか?
印刷した内容とコードを一致させたいならコミットへ、読む人にいつも最新の版を見せたいならブランチへリンクします。
リポジトリを公開にしておかないとだめですか?
アクセス権を持たない訪問者に見せるなら、そうです。非公開のリポジトリでは、適切な権限でサインインするよう求められます。
GitHubタイプとは何が違いますか?
GitHubタイプは、ユーザー名からプロフィールへのリンクを作るものです。こちらのタイプは、どのホスティングであれ、貼り付けたコードのページを開きます。
読み取った時点で、何かが実行されますか?
いいえ。手元の画面には、ソースを読むためのページが出るだけです。