# HackMDの使い方

## はじめに
わたしたち『橘ありすの端末』では、総選挙の議事録作成にHackMDという外部ツールを使用しています。
HackMDでは、**リアルタイムで共同編集が可能**なノートサイトです。
誰かが編集した内容が、即座に反映されるということです。

ですが、第11回総選挙キックオフ時点で、特定の人物しか利用方法がわからない問題が浮き彫りになりました。

このページでは議事録作成のために、HackMDの利用方法について紹介します。
これを読んで、次回会議から議事録記入に参加していただければ幸いです。

## 編集方法

==議事録を記入するだけであれば、 **アカウントの取得は必要ありません**。==
各回の議事録を開いたら、その時点で誰でも記入ができます。

### 0. 議事録を開く
議事録を開きます。
次のようなページが出てきますが、閲覧画面ですので編集はできません。
<img src="https://i.imgur.com/R9K5JYP.png" width="40%">

### 1. 編集モードに切り替える
ペンのアイコンを選択してください。
画面上部にある編集ボタン:lower_left_fountain_pen:を押すことで編集画面に移動します。
移動しても変化がない場合、目のアイコン:eye:をペンのアイコン:lower_left_fountain_pen:に切り替えてください。
画面が黒くなれば、編集画面に移動した証拠です。
<img src="https://i.imgur.com/rgqlOqC.png" width="40%">

### 2. 記入する
自分の意見や、議事録などを自由に記入してください。
入力した文字が閲覧画面に反映されて、他の人からも見えるようになります。
間違えて消してしまっても、作成者権限で元に戻せます。
自由に記入してみてください。
:::info
記入してある文章は「誰か」が書いたものです。
元に戻せるからといって、いたずらに消さないようにしてください。
:::

### 3. 同時に確認する
閲覧画面と編集画面を同時に確認することができます。
本のアイコン:book:を選択してください。
編入しながら、『どのように見えるのか』が確認できます。
なお、このモードは**PC限定**です。
スマホから参加する場合は利用できない機能です。
<img src="https://i.imgur.com/o5iffdt.png" width="50%">

### よくありそうな質問
**Q. 編集画面に切り替えができない。**
**A. ロックしています。**

いたずらに改ざんされないよう、編集機能を制限している場合があります。
『橘ありすの端末』では、最新の議事録以外の編集機能を制限しています。
編集したい内容がある場合、管理人さんもしくはわたしに連絡をください。

**Q. 箇条書きがうまくできない。**
**A. 半角スペースを空けてください。**

HackMDでは文の先頭に`- (ハイフン)`をつけることで箇条書きにすることができます。
ですが、ハイフンと文章の間に半角を付け忘れると正しく表示されません。
また、ハイフンが全角の場合も機能しません。
それぞれ確認してください。

**Ｑ． 箇条書きを増やしたい。**
**Ａ． Tab空白を増やしてください。**

Tab空白を増やすことで段落を増やせます。
空白を複数入力することでは使用できません。よって、スマホでは再現できないことがあります。

- 橘ありす
    - coolアイドル
        - 12歳

と入力することで、
- 橘ありす
- coolアイドル
- 12歳

と表示されます。

**Q. 広い空行やインデントを使いたい。**
**A. 「そんなもの ウチにはないよ……」**

ありません。
`---(ハイフン3つ)`を使うことで水平線を挿入できます。これで空行を再現してください。
文章の先頭にある空白は無視されます。そのため、Tab空白は使えません。
前述した箇条書きを用いてインデントを表現してください。

**Q. おしゃれな記述をしたい。**
**A. :question:を押してください。**

目のアイコン:eye:の近くにある、はてなアイコン:question:を押すと特殊記述の一覧が表示されます。
使い分けて見やすい議事録を作成してください。
先人が記述した内容を転用してみるのもいいと思います。

**Q. なんかカラフルなんだけど。**
**A. 仕様です。**

一部の特殊記述に反応して色が変わります。
記述の範囲がわかりやすくなる機能です。

## 『橘ありすの端末』における議事録作成方法
記事の作成にはアカウント登録が必要です。
事前にアカウントを作成してください。
また、『橘ありすの端末』チームに所属していると議事録のテンプレートを利用できます。
チームに所属したい方は会議に参加の上直接お声がけください。
テンプレートは[こちら](https://hackmd.io/@AliceDevice/HySbQOxm5)。

<img src="https://i.imgur.com/r3MdlC6.png" width="70%">

議事録は、各回会議終了直後に次回のものを作成してください。
自由記述できる時間の確保、作成忘れ防止などが目的です。
気づいた人が作成をお願いします。
また、編集済みの議事録は各会議終了後チャンネルに貼り付けてください。
編集権限を**ログイン済み者**に変更することを忘れないでください。

新規議事録を作成する場合、次の手順に従ってください。

### 0. 新規記事を作成する
目のアイコン:eye:の横のプラスアイコン:heavy_plus_sign:をクリックしてください。
新規記事が作成されます。

### 1. テンプレートをコピーする
[テンプレート](https://hackmd.io/@AliceDevice/HySbQOxm5)を開いてください。
編集画面を開き、なかにあるコードを**すべて**コピーします。
その後、⓪で作成した新規記事に貼り付けます。

==チームに所属していてテンプレートを用いる場合、①の手順は不要です。==

### 2. 日付を挿入する
タイトルと予定にある日付を正しく修正します。
Ｘには会議のナンバリングを丸数字で記入してください。(例:①、②)
M/DDにはそれぞれ月と日を入力してください。(例:3/25)

### 3. 項目を挿入する
会議のまとめを挿入してください。
- 今回の予定
その回で話し合いたいことを箇条書きで入力してください。
- 前回の振り返り
前回に決定したことを箇条書きで入力してください。
- タイムスケジュール
タイムスケジュールを順序付きリストで入力してください。
具体的な時間は下線を用いて表示してください。
(例:``**1. 定例会議の曜日と時間の検討** ++22:00～22:15++``)
タイムスケジュールを記入後、各項目の説明をする際は`####`を付けてください。
詳細は[過去議事録](https://hackmd.io/@yanabethe08/BJjUU8sM5)を参照してください。
- 過去決定事項
前回会議以前の決定事項を簡潔かつ箇条書きで入力してください。
過去議事録の記述をコピーするとわかりやすいと思います。

### 4. 議事録を公開する
画面右上の3点アイコンをクリックしてください。
共有は:eye:**閲覧モード**、権限はどちらも**全員**で公開してください。
間違いがなければ、公開をクリックしてください。
共有項目のURLをコピーすることで、記事のリンクを発行できます。
URLを次回会議のチャンネルの先頭と議事録保管庫チャンネルの最後にそれぞれ貼り付けてください。

おつかれさまでした、以上で議事録の作成は終了です。

## おわりに
記事を読んでいただきありがとうございました。
「橘ありすちゃんを応援したい！」「応援するために総選挙会議を頑張りたい！」
その気持ちは共通していると思います。
HackMDはさまざまな特殊記述や機能があります(あるそうです)。
いつか読み返したときに、わかりやすい議事録の作成を作っていきましょう。

この記事は、ログイン者の編集を許可しています。
不足内容や不備があれば自由に編集してください。
その他、疑問点はいちごオレ(Twitter:[yanabethe08](https://twitter.com/yanabethe08))までご連絡ください。