転職した先の会社の情報共有手段がConfluenceだったので、まったく初心者からのConfluenceのドキュメントを読んで、使い方を調べてみました。
概要
Confluence を技術文書の作成に使用するのチュートリアルを一通りやってみました。
https://support.atlassian.com/ja/confluence-cloud/docs/use-confluence-for-technical-documentation/
参考文献
[1] Confluence サポート https://support.atlassian.com/ja/confluence-cloud/resources/
詳細
Confluence Cloud の動作を確認する
・美しいページが作れる+Todo(Trello)の埋め込みもできる。
・共同編集最大12人
・基本的な構成
・スペース:概要(ダッシュボード)
・ブログ :お知らせ・更新
・ページ :なんでも作業用
・自動保存・自動バージョン管理(壊しても、もとに戻せる)
・インラインコメント(Wordのコメントみたいな感じもできるし、履歴も残る)
チームによる Confluence Cloud の使用方法を確認する
Confluence を技術文書の作成に使用する
ドキュメンテーション スペースを作成する
[スペース] > [すべてのスペースを表示] > [スペースを作成] >[ドキュメンテーション スペース]
コンテンツの再使用による時間の節約
再利用マクロがある
抜粋マクロ:リリースノートの概要を抜粋に指定
抜粋インクルード マクロ:新着情報ページに 抜粋インクルードマクロでリリースノがコピペされる(自動更新)。
ページ インクルード マクロ:ページごとコピペ(ただし折り畳みで表示したり?)
抜粋マクロ
https://support.atlassian.com/ja/confluence-cloud/docs/insert-the-excerpt-macro/
Confluence エディタで > [詳細を表示] >抜粋
・抜粋名 ver 0.1 リリースノート
抜粋インクルード マクロを挿入する
ツールバーから+>抜粋を含める
先ほど作った [ver 0.1 リリースノートを抜粋]
インクルード ページ マクロを挿入する
ツールバーから+> ページを含める
先ほど作った[抜粋マクロページを抜粋]
ラベル リスト マクロを挿入する
ページに着けたラベル(タグ的なもの)の一覧
人気のラベル マクロを挿入する
プロファイル画像マクロを使用する
最近の更新マクロを挿入する
スペースの一覧
タスクレポート
インクルードライブラリーを作成する
[作成] > 「_ConfluenceInclusions」ページを公開
[スペース設定] >[ページを管理] >[並び替え]
// よくわからん。素材置き場的なページを作るイメージか?
ページ テンプレートを使用する
作ったページをテンプレ化できるようす。skip
下書きを作成する
レビューアのみに閲覧・編集権限を絞って、ドラフトを公開。
その後、閲覧者を全体に変更。
skip
リンクとアンカーを使用する
便利なマクロ
ページ更新をトラッキングする
右上にあるウォッチボタン 更新状況がメール通知
[ページ履歴] でそのページの過去バージョン
PDF エクスポートのカスタマイズ
skip
その他の便利なツールとアプリ
Gliffy・Lucidchart 外部のフローチャート作成アプリを埋め込める