コンテンツの作成と公開

コンテンツは、APIのスキーマに沿って入力する1件の原稿です。作成・編集・削除はオーナーと編集者が行えます。閲覧者は内容の確認のみできます。

新しい原稿を作る

1. ヘッダーのワークスペース名を押し、対象のワークスペースに切り替えます。
2. 画面上部に並ぶAPIの名前から、編集したいAPIを選びます。
3. リスト形式なら「新しいコンテンツ」を押します。オブジェクト形式なら「コンテンツを作成」または「コンテンツを編集」を押します。
4. タイトルや本文など、表示された項目を入力します。
5. 「保存する」を押し、「保存済み」の表示を確認します。

APIの名前は横一列に並び、画面の幅に収まらない場合は横にスクロールできます。メディアやワークスペースの設定は、ヘッダーのワークスペース名のメニューから開きます。

入力しただけでは保存されません。 画像のアップロード中や保存中は完了を待ってください。保存に失敗した場合はエラーを確認し、再度保存します。

本文を書く

リッチテキストの項目では、文章に見出しやリンクなどの装飾を付けられます。画像を挿入した場合は、必要に応じて代替テキストも設定します。

通常のテキスト項目にHTMLを書いても、リッチテキストの編集欄にはなりません。用途に合った種類をオーナーに設定してもらってください。

Enterは新しい段落、Shift＋Enterは同じ段落内の改行です。エディタでは段落の間に余白が付き、段落内の改行は通常の行間で表示されます。配信されるHTMLはそれぞれ別のp要素とbr要素になるため、公開サイト側でも段落間隔をCSSで設定できます。日本語の文章の直後に**太字**や*斜体*と入力すると、太字・斜体に変換されます。

表を入れる

リッチテキストの項目には表を入れられます。

1. 表を置きたい位置にカーソルを合わせます。
2. カーソルの横に出る挿入の帯で「＋」を押します。
3. 並んだ道具から「表」を選びます。

表の中にカーソルを置くと、行と列を追加・削除する操作が現れます。追加した行や列は、カーソルのあるセルを基準に入ります。行と列をすべて削除すると、表自体が本文から消えます。

セルの結合と列幅の調整には対応していません。 見出し行と、行・列の増減までが今の範囲です。複雑な表を載せたい場合は、表を分けるか、箇条書きに置き換えてください。

他のサービスから取り込んだ表も、同じ範囲だけが残ります。配信されるHTMLで扱うのはtable、thead、tbody、tfoot、tr、th、tdと、colspan・rowspanの属性です。それ以外のタグや、列幅などの指定は取り込みのときに落ちます。

公開状態を選ぶ

エディタの「設定」から公開状態を選び、保存します。

配信されなくなった記事は、一覧では除外され、IDを指定した取得では404になります。公開状態の変更は、保存が完了してから反映されます。

原稿を開かずに公開状態を変えることもできます。コンテンツ一覧の行の「⋯」→「公開状態」を選びます。変更のたびに確認が表示され、公開予約では未来の日時を指定します。未公開の変更がある原稿を公開すると、その変更も一緒に公開されます。

公開中の記事を直す

公開中の原稿では、リスト形式の編集画面で「保存する」の右側にある「▾」から「下書きとして保存」を選べます。オブジェクト形式では編集時に「下書きとして保存」ボタンが表示されます。変更は未公開のまま保存され、サイトと通常の配信APIには公開中の内容が引き続き表示されます。下書きや公開予定など、公開中でない原稿にはこの操作は表示されません。

保存するとエディタに保存日時付きの案内が出て、次に開いたときも未公開の変更から編集を続けられます。コンテンツ一覧や言語ごとの表示には「未公開の変更」の印が付きます。「差分を見る」では公開中の内容と保存済みの未公開の変更を項目ごとに比較できます。日本語の文章は文字単位、リッチテキストはMarkdownとして差分を表示します。画面でまだ保存していない入力は差分に含まれません。

公開するには「保存する」を押します。未公開の変更が保存済みなら、入力をさらに変えていなくても押せます。変更はその時点で配信対象になります。「変更を破棄」を押すと公開中の内容に戻ります。確認画面が表示され、保存していない編集もあれば一緒に失われます。未公開の変更を保存・破棄するだけではWebhookは送られず、公開時には通常の更新通知が送られます。

公開状態を下書きや公開終了へ変更した場合、履歴を復元した場合、取り込みで上書きした場合は、保存済みの未公開の変更が消えます。言語版を削除した場合も、その版の変更は失われます。公開状態の変更は配信にも影響します。原稿を下書きにして保存すると、通常の配信APIからは取得できなくなります。

表示先がキャッシュや静的生成を使っている場合、管理画面での保存だけでは画面が更新されないことがあります。Webhookで再検証や再ビルドを接続します。

保存した内容を確認する

一度保存した原稿は、下書きプレビューで実際のサイトの見た目を確認できます。プレビューで使われるのは保存済みの内容です。未保存の入力を反映したい場合は、先に保存してください。

日時を指定したい場合は予約公開、以前の内容へ戻したい場合は編集履歴を参照してください。

原稿を削除する

不要な原稿は、コンテンツ一覧の行の「⋯」→「削除」で削除できます。行のチェックボックスで複数を選び、まとめて削除することもできます。削除した原稿は通常の配信・プレビューのどちらからも取得できず、その原稿の編集履歴も失われます。

削除前に、関連ページや他の記事から参照されていないか確認してください。サイト側では、記事が取得できない場合に404ページなどを表示する処理を用意します。コンテンツ取得に例があります。

言語版を作成・編集する

多言語を有効にしたAPIでは、リスト形式の一覧に言語版の状態が表示されます。原稿を開いて「編集する言語」を切り替えます。オブジェクト形式でもコンテンツ画面の言語切り替えから同じ操作ができます。未作成のサブ言語は「未作成」と表示され、「メイン言語からコピーして作成」を押すと、その時点のメイン言語の値を下書きとしてコピーします。コピー後に翻訳し、保存してください。メイン言語を後から変更しても翻訳版は自動更新されません。

各言語版は値と公開状態を別々に持ちます。メイン言語が下書きでもサブ言語だけ公開できます。反対に、ある言語を下書きへ戻しても、ほかの言語の公開状態は変わりません。コンテンツIDとスキーマは共通のため、言語版からIDを変更することはできません。予約公開、プレビュー、編集履歴も言語ごとに扱います。

「この言語版を削除」を選ぶと、そのサブ言語の内容と履歴が削除されます。メイン言語とほかの言語の版は残ります。メイン言語の原稿自体を削除する場合は、紐づくすべての言語版も失われます。