チュートリアル：Bookstackの使い方

BookStackの使い方

bookstackの構造

BookStackの構造

BookStackは本棚、本、チャプター、ページの要素から構成されています。


ユーザー登録

ユーザー登録

ユーザー登録すると

とりあえず初期設定としてゲストユーザー（無登録ユーザー）でも、すべてのブックにアクセスできるようにしてあります。
しかしながら、ゲストユーザーでは閲覧はできても編集権限はありません。ブックやページを作成するにはユーザー登録が必要です。
また、ユーザー登録をすることで高度な設定として、ページの閲覧権限などを編集できますが、あまりいじると誰も見れなくなります。

また、ユーザーのロール（役割）を設定することで、ユーザーのグループ分けができます。登録ユーザーはデフォルトで編集者の権限が与えられ、本棚、本、ページ、チャプター、の作成、編集ができます。グループ分けのようなロールの使い方をしたいときは、管理者まで連絡下さい。

登録方法

１．　画面上部の新規登録を押す

スクリーンショット 2025-05-13 100050.png

２．　登録画面に必要な情報を入力

スクリーンショット 2025-05-13 100114.png

３．入力したメールアドレスに、登録完了のメールが届くので確認する
　　（不正なユーザー登録が発覚した場合管理者の権限で登録抹消します）

４．bookstackに接続し、ログインしてみる
　　ログイン出来たらＯＫ。





本の作成

BookStackにおけるブックとは

Bookstackの知識の共有単位として本があります。エディター目線ではなく、ユーザー目線で考えると簡単で、何かの知識を得たいので図書館に行って、それについて書いた本を読む。と同じです。

ユーザー（閲覧者）は何かの知識が欲しい時に、そのことが書いたブックを開きます。したがって、（エディター（執筆者）は）そのブックにはブックの目的にあった情報を書き綴っていくのが良いと思います。その書き綴っていく本の中の情報一つ一つをそのブックのページとして書いていきます。（ブック＝ブックの目的に沿ったページの集まり）

ブックの作成

ブックはすでにある本棚から作るか、ブックのメニューから作成できます。

本棚から作成

１．どれか本棚をクリック

スクリーンショット 2025-05-13 112843.png

２．新しいブックをクリック

スクリーンショット 2025-05-13 180347.png

画面が切り替わり入力画面になる

スクリーンショット 2025-05-13 180347.png


３．ブックの名称、概要を入力する

スクリーンショット 2025-05-13 181629.png

４．カバー画像を選択（オプション）

ブックのカバー画像を任意で読み込めます、サイズは多少大きくても大丈夫ですが、大きすぎるとエラーになるので注意。
（標準サイズ：440px　×　250px）
スクリーンショット 2025-05-13 181637.png

５．必要に応じてタグを入力

タグを入力しておくことで、分類や検索が楽になる。重複したタグが増えていかないように注意してください。
(Programing、プログラミングなど作りがちなので注意！）

スクリーンショット 2025-05-13 181707.png

６．保存を押して完了

スクリーンショット 2025-05-13 181715.png


ブックメニューから作成

１．画面上部のブックを押す

スクリーンショット 2025-05-13 112858.png

２．新しいブックを作成を押す

スクリーンショット 2025-05-13 183154.png

３．あとは、本棚から作成したのと一緒

ブック名称、概要、タグを入力して、保存を押したら完了

本棚の作成

本棚とは

ブックが増えてくると、整理がつかなくなるのでブックのカテゴリーごとに本棚としてまとめられます。

本棚の作成は、

  1. ログイン（ユーザー登録必須）
  2. 本棚の作成をクリック
  3. 本棚名入力
  4. 概要の記述
  5. ブックの追加
  6. 本棚画像のアップロード、選択
  7. タグの入力
  8. 保存

で出来ます。５．のブックの追加以外はブックの作成と大して変わらないです。

本棚作成画面

hondana.png

ページの作成

ページの作成

1. ログインとブックの選択

2. ページを追加

4. ページの編集

  1. タイトルを入力します。
  2. 本文を Markdown または WYSIWYG エディタで記述します。
  3. 必要に応じてタグを追加します。（タグは分類や検索するときにとても有用なので入れましょう）
    • タグは、入力欄をクリックすると現在使えるタグが一覧で出てきます
    • 新規の時は入力欄に入力すると、新しいタグとして登録されます

5. 保存

💡 ヒント

🔗 参考

WYSIWYGエディタの使い方

✏️ BookStack WYSIWYGエディタの使い方

BookStack では、直感的に操作できる WYSIWYG（What You See Is What You Get）エディタ を使って、ページを視覚的に編集できます。ここではその基本的な使い方を説明します。

🧭 エディタの基本構成

WYSIWYGエディタは、以下のようなツールバーと編集領域で構成されています：

//後でこの辺に画像を挿入

🛠️ 主な機能と使い方

1. 文字の装飾

文字装飾は、入力領域に文字を入力した後に、マウスで装飾したい部分をドラッグで選択し、ツールバーのアイコンをクリックすることで実行できます。

機能 説明
太字 「B」アイコン（Ctrl + B）
斜体 「I」アイコン（Ctrl + I）
打ち消し線 「S̶」アイコン
見出し 見出しレベルをドロップダウンで選択（H1〜H4）

2. リストの作成

リストの作成は、通常の改行入りの複数行を選択し、ツールバーのアイコンをクリックすると選択部分がまとめてリストに変換される

3. リンクと画像の挿入

4. 表の挿入

5. コードブロック・引用

🔄 編集履歴とプレビュー

🧽 よくある操作

操作内容 方法
ページの保存 「保存」ボタンをクリック
ページのキャンセル 「キャンセル」で編集を破棄
全画面モード ツールバー右端の拡大アイコンをクリック

🧩 補足

📚 参考リンク

Markdown

Markdownは、プレーンテキストで書ける軽量なマークアップ言語です。書いたテキストは、HTMLなどに簡単に変換できます。BookStackでもMarkdownを使ってページのコンテンツを記述できます。

基本的なMarkdown記法:

  1. 見出し:

    • # 見出し1
    • ## 見出し2
    • ### 見出し3
    • ...のように、# の数で見出しのレベルが変わります。
    • 見出しは１～６まであり#の数で変わります

見出し1

見出し２

見出し３

見出し４

見出し５
見出し６

他のページで同じマークダウンを表示すると、CSS（デザイン）が違うので見出しのサイズや、装飾が同じにはなりません。 でんこの知識の杜のBookstackでは、上のようなデザインになっています。
本ページでは、見出しの大きさはそんなに変わりませんが、装飾が変化するようにデザインを決めています。何も装飾をつけたくないときは「見出し４」を使いましょう。

  1. テキストの装飾:

    • 太字: **太字** または __太字__ で囲みます。
    • 斜体: *斜体* または _斜体_ で囲みます。
    • 取り消し線: ~~取り消し線~~ で囲みます。

  1. リスト:

    • 箇条書き (順不同リスト):

      Markdown

      - 項目1
- 項目2
* 別の項目
+ さらに別の項目

      このように、行頭に -, *, + のいずれかを置きます。

    • 番号付きリスト (順序付きリスト):

      Markdown

      1. 最初の項目
2. 次の項目
3. 最後の項目

      行頭に 数字. を置きます。

  1. リンク:

    Markdown

    [表示するテキスト](URL)

    例: [BookStackの公式サイト](https://www.bookstackapp.com/)

  1. 画像:

    Markdown

    ![代替テキスト](画像のURL)

    例: ![BookStackのロゴ](https://www.bookstackapp.com/img/logo.svg) (代替テキストは、画像が表示されない場合に表示される説明です)

  1. 引用:

    Markdown

    > これは引用です。
> 複数行にわたる引用も可能です。

    行頭に > を置きます。

  1. コードブロック:

    • インラインコード: バッククォート1つ () で囲みます。例: `print("Hello")`

    • ブロックコード: バッククォート3つ (```) で囲みます。言語を指定することもできます。

      Markdown

      ```python
def hello():
    print("Hello, world!")

hello()

  1. 水平線:

    Markdown

    ---
***
___

    上記のいずれかを3つ以上連続して書くと、水平線が表示されます。

BookStackでのMarkdownプレビュー:

BookStackのMarkdownエディタには、記述した内容をプレビュー表示する機能があることが多いです。編集画面の近くに「プレビュー」タブやボタンがあるはずなので、それをクリックすると、Markdownで書いた内容がどのように表示されるかを確認できます。

実際に試してみましょう:

BookStackの編集画面で、上記のMarkdown記法をいくつか試してみてください。例えば、見出しを作ったり、リストを作ったり、リンクを挿入したりしてみましょう。そして、プレビューでどのように表示されるか確認してみてください。

チャプター（章立て）の作成

📚 BookStack のチャプター機能の使い方ガイド

BookStack では、ページを整理し、階層的な構造を作成するために「チャプター」機能を使用します。ここでは、チャプターの作成方法、使い方、および管理方法について説明します。

🧭 チャプターの基本的な使い方

1. チャプターの作成

  1. BookStackにログインし、左側のナビゲーションバーから該当する「本」を選択します。
  2. 本のページ内で「新規チャプター作成」ボタンをクリックします。
  3. チャプターのタイトルを入力し、「作成」ボタンをクリックします。
  4. 作成されたチャプター内に、さらにページを追加できます。

2. チャプター内のページを作成

3. チャプターの順番を変更

  1. 左側のナビゲーションバーでチャプター一覧を表示します。
  2. ドラッグアンドドロップでチャプターの順番を変更できます。

🛠️ チャプターの管理

1. チャプターの編集

2. チャプターの削除

📑 チャプターとページの関係

🌱 チャプターの階層（サブチャプター）

💡 よく使われるチャプター活用例

📘 まとめ