Confluence(社内Wiki的なもの)の使い方　技術文書編

転職した先の会社の情報共有手段がConfluenceだったので、まったく初心者からのConfluenceのドキュメントを読んで、使い方を調べてみました。

# 概要
Confluence を技術文書の作成に使用するのチュートリアルを一通りやってみました。
https://support.atlassian.com/ja/confluence-cloud/docs/use-confluence-for-technical-documentation/

こういうのが作れるようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/7c617ed6-1547-f424-5f68-2c66b0ad1092.png)


# 参考文献
[1] Confluence サポート　https://support.atlassian.com/ja/confluence-cloud/resources/

# 詳細

## Confluence Cloud の動作を確認する
https://support.atlassian.com/ja/confluence-cloud/docs/what-is-confluence-cloud/

・美しいページが作れる＋Todo（Trello）の埋め込みもできる。
・共同編集最大12人
・基本的な構成
　・スペース：概要（ダッシュボード）　
　　・ブログ　：お知らせ・更新
　　　　・ページ　：なんでも作業用
・自動保存・自動バージョン管理（壊しても、もとに戻せる）
・インラインコメント（Wordのコメントみたいな感じもできるし、履歴も残る）

## チームによる Confluence Cloud の使用方法を確認する
https://support.atlassian.com/ja/confluence-cloud/docs/see-how-teams-use-confluence-cloud/
### Confluence を技術文書の作成に使用する
#### ドキュメンテーション スペースを作成する
　[スペース] > [すべてのスペースを表示] > [スペースを作成]  >[ドキュメンテーション　スペース]  

それっぽいページのテンプレートができる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/1b5f2302-5f73-cdee-4423-2e3829e6a5f8.png)


#### コンテンツの再使用による時間の節約
　再利用マクロがある
　　抜粋マクロ：リリースノートの概要を抜粋に指定
　　抜粋インクルード マクロ：新着情報ページに　抜粋インクルードマクロでリリースノがコピペされる（自動更新）。
　　ページ インクルード マクロ：ページごとコピペ（ただし折り畳みで表示したり？）

##### 抜粋マクロ
　https://support.atlassian.com/ja/confluence-cloud/docs/insert-the-excerpt-macro/
　Confluence エディタで  > [詳細を表示] >抜粋
　・抜粋名 ver 0.1 リリースノート
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/2a3b3270-86cb-f4a3-4641-0d524459c2b6.png)
　　
##### 抜粋インクルード マクロを挿入する
ツールバーから＋>抜粋を含める
先ほど作った [ver 0.1 リリースノートを抜粋]
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/3390e7f2-54a2-ad39-5c62-712474fcc62a.png)

##### インクルード ページ マクロを挿入する
ツールバーから＋>　ページを含める　
先ほど作った[抜粋マクロページを抜粋]

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/607a93c4-5b12-e399-93e1-a782ac0c8b75.png)

##### ラベル リスト マクロを挿入する
ページに着けたラベル（タグ的なもの）の一覧

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/4a0df45b-95fb-0cf1-313c-b16a61873717.png)

##### 人気のラベル マクロを挿入する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/2898fb69-5e4e-932d-f3e9-5acc861fba49.png)

##### プロファイル画像マクロを使用する
/プロファイル画像
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/2712b02b-5d70-2f68-49c8-ba7034a5b516.png)

##### 最近の更新マクロを挿入する
/最近の更新
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/783225c8-133a-393a-59d3-bec083a15434.png)

##### スペースの一覧
##### タスクレポート
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/d593dc29-ca21-e6be-477a-760c87127368.png)

##### インクルードライブラリーを作成する
[作成] > 「_ConfluenceInclusions」ページを公開
[スペース設定] >[ページを管理] >[並び替え] 
// よくわからん。素材置き場的なページを作るイメージか？

#### ページ テンプレートを使用する
作ったページをテンプレ化できるようす。skip

#### 下書きを作成する
レビューアのみに閲覧・編集権限を絞って、ドラフトを公開。
その後、閲覧者を全体に変更。
skip

#### リンクとアンカーを使用する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/ef786004-f241-17ca-8d61-f30b71a360fb.png)

#### 便利なマクロ
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2311625/831b671d-f119-b17b-6a7e-24d9b4ec1c41.png)

#### ページ更新をトラッキングする
右上にあるウォッチボタン　更新状況がメール通知
 [ページ履歴] 　でそのページの過去バージョン

#### PDF エクスポートのカスタマイズ
skip

#### その他の便利なツールとアプリ
Gliffy・Lucidchart　外部のフローチャート作成アプリを埋め込める