Doc Cloud
外部のドキュメントサービスに置いてあるページを、zudo-text の frame の中で開いて書き、そのまま公開まで進められます。ブラウザとエディタを行き来せずに、書く道具を 1 つにまとめたい人のための連携です。
この連携を使わなくても zudo-text はふつうに使えます。相手のサービスにアカウントを持っていないときは、読み飛ばして構いません。
できること
サービス側のプロジェクトを一覧し、その中のページを開けます。
ページの本文と見出し情報を編集できます。書いたそばから保存されます。
公開の前に checkpoint を作り、あとから戻せるようにしておけます。
サイトの公開を頼み、その後の進み具合を追えます。
書いたものはサービス側に保存されます。zudo-text の workspace の中に入るわけではありません。この違いは後述の「note の公開との違い」で扱います。
Doc Cloud の開き方
Command Palette（Mod+K で開く、コマンドの検索窓）の Open Doc Cloud を実行すると、Doc Cloud（外部サービスのページを開いて編集する画面）が frame に入ります。空の frame の一覧から選ぶこともできます。
1 つのウィンドウに置ける Doc Cloud は 1 つだけです。すでに開いているときは、そちらに切り替わります。
iOS では使えません。iOS のアプリでは、この画面も Settings → Doc Cloud も出てきません。
アカウントの接続
つながっていないときは、Connect Doc Cloud という案内が出ます。Calling token の欄にサービス側で用意した token を貼り付け、Connect with token を押します。
token が古かったり間違っていたりすると、その旨がその場で表示されます。新しいものを貼り直してください。
macOS のデスクトップアプリでは、貼り付けた token は端末の安全な保管場所に預けられます。ブラウザで使っているときは、その回のあいだだけ覚えられます。
画面の見かた
Doc Cloud の上端には、いま開いているプロジェクトの名前と、公開サイトの状態が出ます。その右に、開いているページのタブが並びます。
タブに付く小さな丸は、そのページの状態を表します。保存されていない変更、他所で加えられた変更、保存の衝突、消えてしまったページ、といった区別です。
右端には次のボタンがあります。
Open site — 公開中のサイトをブラウザで開きます。公開範囲が Private のサイトでは押せません。
Checkpoint — いまの状態に目印を付けます。
Publish — 公開の手続きに進みます。
Edit / Preview / Split — 本文だけ、表示だけ、左右に並べる、を切り替えます。
左側には Doc Cloud outline（プロジェクトの分類とページを木の形で並べた欄）があります。境目にある小さなつまみで開いたり閉じたりできます。
プロジェクトとページの開き方
つないだ直後は Projects の一覧が出ます。Search projects で名前や識別子から絞り込め、その隣で Recently updated と Title の並び順を選べます。
プロジェクトを選ぶと、そのプロジェクトの画面になります。上の切り替えで次を行き来します。
Overview — ページ数、下書きの数、分類の数、公開 URL、公開の進み具合、最近の動きが並びます。
Activity — 動きの記録と checkpoint の並びです。Refresh activity と Refresh history で読み直せます。
Editor — 開いているページのタブに戻ります。開いているページがあるときだけ出ます。
Doc Cloud outline でページ名をクリックすると、そのページがタブとして開きます。
ページの編集
本文の上に、そのページについての欄が並びます。
Title — ページの題名です。
Description — 概要です。
Draft — 入れておくと下書きの扱いになります。
Date / Updated — 日付です。
本文の下の帯には、保存の状態、版の番号、書式の警告の数、単語数が出ます。保存はひとりでに行われるので、保存のボタンはありません。
Content preview（本文の見え方を確かめる欄）は、書いた Markdown の中身をそのまま確かめるためのものです。公開後のサイトの配色や飾りまで再現するものではありません。
ほかの場所で同じページが変わったとき
自分が書いているあいだに同じページが別の場所で変わると、保存が衝突します。書きかけの内容は残したまま、帯に確認が出ます。
Retry my draft — 自分の書いたものでもう一度保存を試します。
Discard my draft — 自分の書いたものを捨てて、相手側の内容に合わせます。
ページそのものがサービス側から消えていた場合、そのタブは読み取り専用になります。本文をコピーして取り出すことはできます。
checkpoint
Checkpoint を押すと Create checkpoint の画面が出ます。Checkpoint label に名前を入れて Create checkpoint を押すと、その時点の目印が作られます。
Settings → Doc Cloud の Checkpoint before editing が入っていると、その回で最初にページを編集したときに目印が自動で作られます。この設定は最初から入っています。
作られた目印は Activity の並びに出ます。目印の時点まで戻す操作は zudo-text の中にはなく、行の右の案内からサービス側の画面に移って行います。
公開
Publish を押すと Publish Doc Cloud site の画面が出ます。書きかけのページをすべて保存してから、いまの状態を読み直します。
Site label に今回の公開の名前を入れます。必要なら Checkpoint label (optional) も入れておくと、公開と同時に目印が残ります。Publish を押すと申し込みが送られます。
Note
Accepted と出たら、申し込みが受け付けられたという意味です。まだサイトは切り替わっていません。この画面を閉じても、その後の進み具合は追い続けられます。
Overview には Draft、Accepted、Building、Live の 4 段階が並び、いまどこまで進んだかが分かります。
公開できない理由があるときは、その一覧が出ます。原因になっているページには Jump to page が付いていて、押すとそのページが開きます。短いあいだに何度も押したときは、次に押せるまでの秒数が表示されます。
Command Palette の Doc Cloud: Publish でも同じ手続きに入れます。こちらは Doc Cloud の frame を選んだ状態でないと実行できません。
公開の結果は、Settings → Doc Cloud の Publish notifications が入っていれば知らせとして届きます。この設定も最初から入っています。知らせについては通知にまとめています。
Settings → Doc Cloud
Default project slug — Doc Cloud を開いたときに最初に開くプロジェクトの識別子です。空にすると Projects の一覧から始まります。指定したプロジェクトが開けないときも一覧に戻ります。この項目だけは端末ごとに変えられます。
Checkpoint before editing — 最初の編集で目印を自動的に作ります。既定で入っています。
Publish notifications — 公開の受け付け、作成中、公開済み、失敗を知らせに出します。既定で入っています。
Advanced の Server origin — つなぎ先のサーバーです。変えると接続がいったん切れ、書きかけの扱いを確認したうえでつなぎ直しになります。ふつうは触りません。
つながっているときは、アカウントの名前とアドレスの横に Disconnect Doc Cloud が出ます。押すと、この連携だけを切れます。zudo-text のサインインはそのままです。
逆に、zudo-text からサインアウトすると Doc Cloud の接続も一緒に切れます。
端末ごとの設定についてはデバイスごとの設定にまとめています。
note の公開との違い
zudo-text には、workspace の note を 1 本だけ web のページにする機能が別にあります。相手にリンクを 1 つ渡すための機能で、こちらは公開で扱います。
このページで説明しているのは、外部のサービスに置いてあるページを編集して、そのサービスのサイトとして公開するほうです。原稿の置き場も、公開されるものも別々です。