エディターからの Markdown ドキュメントの作成
- トピック:
- オーサリング
- Web エディターの機能
作成対象:
- ユーザー
Markdown は、プレーンテキストドキュメントに書式設定要素を追加するのに役立つ軽量のマークアップ言語です。 Adobe Experience Manager Guidesには、エディターから Markdown \(.md\) トピックを作成、オーサリング、プレビューする機能が用意されています。 また、既存の Markdown ドキュメントをアップロードして、エディターで編集することもできます。
Markdown トピックの作成
エディターから Markdown トピックを作成するには、次の手順を実行します。
-
リポジトリーパネルで「
-
新規トピック ダイアログボックスで、次の詳細を入力します。
-
タイトル:トピックのタイトルを指定します。
-
名前:ファイル名は、トピックのタイトルに基づいて自動的に提示されます。 管理者が UUID 設定に基づく自動ファイル名を有効にしている場合、「名前」フィールドは表示されません。
-
テンプレート:ドロップダウンリストから Markdown を選択します。 テンプレート トピック はデフォルトで選択されています。
-
パス:トピックファイルを保存するパスを参照します。 デフォルトでは、リポジトリで現在選択されているフォルダーのパスが「パス」フィールドに表示されます。
アップグレードの場合、使用中の現在のフォルダープロファイルに Markdown テンプレートを追加する必要があります。 エディターから 新しいマークダウンテンプレートを作成するか、マークダウンオーサリングに既存のテンプレートを使用できます。 Experience Manager Guidesにオーサリングテンプレートを追加する方法について詳しくは、 グローバルプロファイルまたはフォルダーレベルのプロファイルの設定を参照してください。
-
-
「作成」を選択します。
Markdown トピックが選択したパスに作成され、編集用に開かれます。
Markdown トピックのエディター機能を理解する
この節では、Markdown トピックのオーサリング用にエディターで使用できる様々な機能について説明します。 オーサリングインターフェイスは、次のセクションまたは領域に分かれています。
ツールバー
ツールバーは、タブバーのすぐ下にあります。 ツールバーで使用できる機能の説明は次のとおりです。
注意:画像やその他のファイルを Markdown エディターにドラッグ&ドロップすることもできます。 ファイルは相互参照リンクとして追加され、イメージは標準イメージ要素として表示されます。
コンテンツ編集領域
コンテンツ編集領域には、トピックの Markdown ソースが表示されます。このソースで、すべてのコンテンツ編集を行います。 左右に並べて表示する場合、この領域は 2 つのセクションに分割されます。左側に Markdown ソースビュー、右側にプレビューです。 複数のトピックを同時に開いて、それぞれのタブに表示することができます。
Source、並べて表示およびプレビューモード
Markdown オーサリングの場合、エディターは、コンテンツの作成と書式設定に役立つ 3 つの異なる表示モードをサポートします。
- ソース
- 並列
- プレビュー
ソース
これは、エディターの Markdown コードビューです。 通常のマークダウンエディターと同様に、マークダウントピックを編集できます。 Source ビューには、文書のリビジョンの保存、見出しの挿入、表の挿入、イメージの挿入などのオプションがあります。
このビューは、レンダリングされた出力を表示せずに、生のマークダウンの書き込みと編集にのみ焦点を当てる場合に使用します。
並列
このモードでは、エディターが次の 2 つのパネルに分割されます。
- 編集中の Markdown トピックを表示するSource パネル。
- Markdown トピックのレンダリングされた出力をリアルタイムで表示するプレビューパネル。
このビューは、markdown トピックの編集時にレンダリングされた出力をリアルタイムで表示する場合に使用します。
プレビュー
プレビューモードで Markdown トピックを開くと、ブラウザーでユーザーが表示したときにトピックがどのように表示されるかを示します。 この表示では、すべての編集機能がツールバーから削除されます。 ただし、ツールバーの 新規バージョンとして保存 機能、ロック/ロック解除 機能、右側のパネルの ファイルプロパティ 機能には引き続きアクセスできます。
右側のパネル
右側のパネルでは、「**ファイルのプロパティ」パネルにアクセスできます。
ファイルのプロパティには、次の 2 つのセクションがあります。
一般
「一般」セクションでは、次の機能にアクセスできます。
- ファイル名:選択したトピックのファイル名が表示されます。
- ID:選択したトピックの ID が表示されます。
- 言語:トピックの言語を表示します。 プロパティページの「言語」フィールドから設定されます。
- 作成日: トピックが作成された日時を表示します。
- 変更日: トピックが変更された日時を表示します。
- ロック済み: トピックをチェックアウトしたユーザーを表示します。
- ドキュメントの状態:現在開いているトピックのドキュメントの状態を選択および更新できます。 詳しくは、 ドキュメントの状態を参照してください。
- タグ:トピックのメタデータタグです。 これらは、プロパティ ページのタグ フィールドから設定します。 ドロップダウンから入力または選択できます。 タグがドロップダウンの下に表示されます。 タグを削除するには、タグの横にある十字アイコンを選択します。
- その他のプロパティを編集:ファイルのプロパティページから、その他のプロパティを編集できます。
参照
「参照」セクションでは、次の機能にアクセスできます。
- 使用されている場所:参照に使用されているは、現在のファイルが参照または使用されているドキュメントのリストです。
- 送信リンク:送信リンクには、現在のドキュメントで参照されているドキュメントのリストが表示されます。
使用されているすべてのインリンク参照および送信リンク参照は、ドキュメントにハイパーリンクされています。 リンクされたドキュメントを簡単に開いて編集できます。
機能の制限
次のExperience Manager Guides機能は、現在、Markdown オーサリングには適用されません。
- レビュー
- 結合
- AI アシスタント
- 変更の追跡
- 検索と置換
- 検索とフィルター
親トピック: エディターの概要