4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

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

Last updated at Posted at 2022-12-06

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

概要

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

こういうのが作れるようになります。
image.png

参考文献

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

詳細

Confluence Cloud の動作を確認する

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

チームによる Confluence Cloud の使用方法を確認する

Confluence を技術文書の作成に使用する

ドキュメンテーション スペースを作成する

 [スペース] > [すべてのスペースを表示] > [スペースを作成] >[ドキュメンテーション スペース]

それっぽいページのテンプレートができる。
image.png

コンテンツの再使用による時間の節約

 再利用マクロがある
  抜粋マクロ:リリースノートの概要を抜粋に指定
  抜粋インクルード マクロ:新着情報ページに 抜粋インクルードマクロでリリースノがコピペされる(自動更新)。
  ページ インクルード マクロ:ページごとコピペ(ただし折り畳みで表示したり?)

抜粋マクロ

 https://support.atlassian.com/ja/confluence-cloud/docs/insert-the-excerpt-macro/
 Confluence エディタで > [詳細を表示] >抜粋
 ・抜粋名 ver 0.1 リリースノート
image.png
  

抜粋インクルード マクロを挿入する

ツールバーから+>抜粋を含める
先ほど作った [ver 0.1 リリースノートを抜粋]
image.png

インクルード ページ マクロを挿入する

ツールバーから+> ページを含める 
先ほど作った[抜粋マクロページを抜粋]

image.png

ラベル リスト マクロを挿入する

ページに着けたラベル(タグ的なもの)の一覧

image.png

人気のラベル マクロを挿入する

image.png

プロファイル画像マクロを使用する

/プロファイル画像
image.png

最近の更新マクロを挿入する

/最近の更新
image.png

スペースの一覧
タスクレポート

image.png

インクルードライブラリーを作成する

[作成] > 「_ConfluenceInclusions」ページを公開
[スペース設定] >[ページを管理] >[並び替え]
// よくわからん。素材置き場的なページを作るイメージか?

ページ テンプレートを使用する

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

下書きを作成する

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

リンクとアンカーを使用する

image.png

便利なマクロ

image.png

ページ更新をトラッキングする

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

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

skip

その他の便利なツールとアプリ

Gliffy・Lucidchart 外部のフローチャート作成アプリを埋め込める

4
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?