ナレッジベースシステム設定
管理者は、システム設定 UI を使用して、ナレッジ ベースのグローバル構成 (サイト全体) を設定できます。 この UI には、 コントロール パネル → 構成 → システム設定 → ナレッジ ベースからアクセスできます。 ナレッジベースの構成設定には、次の5つのセクションがあります。
- Knowledge Base サービス
- ナレッジベースの記事
- ナレッジベース・ディスプレイ
- ナレッジベース検索
- ナレッジベースのセクション
ナレッジ ベース サービス セクションの設定は、すべてのナレッジ ベース ウィジェットと、サイト管理のナレッジ ベース アプリにデフォルトを適用します。 他のセクションは特定のナレッジベースウィジェットに適用され、 ナレッジベースサービス のデフォルトを上書きします。
ナレッジベース アプリケーションのシステム設定の詳細な構成は、Liferay DXP 管理者のみが実行する必要があります。
ナレッジベースには、デフォルトで無効になっているオプション機能がいくつかありますが、システム設定から有効にして設定できます。 これらには、インポーターファイルの規則、新しい記事の優先度の増分、ソースURL、およびセクション名が含まれます。
インポーターファイルのコンベンション設定
これらの設定は、サポートされるファイル拡張子、親ファイルの接尾辞、およびインポートされた ZIP ファイル内の画像フォルダーのパスを定義します。 これらの設定は、ナレッジ ベースのシステム設定の ナレッジ ベース サービス セクションでアクセスできます。
次の設定は、インポーターがサポートするファイル拡張子を指定します。
Markdown インポーターアーティクルエクステンション: サポートされている記事の拡張子を設定します。 デフォルト値は .markdown および .md です。
Markdown インポーター画像ファイルエクステンション: サポートされている画像のファイル拡張子を設定します。 デフォルト値は、 .bmp、 .gif、 .jpeg、 .jpg、 .pngです。
サポートされているファイル拡張子を変更するには、
-
設定の横にある[+]または[-]ボタンをクリックして、サポートされているファイル拡張子をそれぞれ追加または削除します。
-
拡張子を追加する場合は、新しい値を入力します。
-
[保存]をクリックします。
次の設定は、インポーターの追加の記事設定オプションを定義します。
Markdown インポーター記事紹介: 親記事のファイルサフィックスを設定します。 デフォルト値は intro.markdown です。
Markdown インポーター画像フォルダ: インポーターがZIPファイルで検索する画像のフォルダパスを設定します。 デフォルトのパスは /images です。
記事インクリメント優先度を有効にする: 有効にすると、新しい記事の優先度を 1.0 ずつ増やします。 この増分を無効にして、記事が 1.0 のフラット値を取得するようにするには、チェックボックスの選択を解除します。
または、システム設定の対応するウィジェットの構成メニューで、各ウィジェットの記事の増分優先度機能を有効または無効にすることもできます。
ソースURL設定
ソースURL設定は、インポートするMarkdownファイルのソースの場所を定義します。 これは、ファイルが保存されているソースリポジトリを指している必要があります。 GitHubがデフォルトとして想定されています。 定義されると、ナレッジベースでは、表示される各記事の上にボタン (デフォルトのラベルは GitHub で編集) が表示されます。 ユーザーはボタンをクリックして記事のソースの場所へ移動できます。
ソース URL 設定は、ナレッジ ベースのシステム設定の ナレッジ ベース サービス セクションでアクセスできます。 ソースURLを有効にするには、[ソースURLが有効です] チェックボックスをオンにします。
ソース URL ボタンのラベルを変更するには、設定 ソース URL 編集メッセージ キーに新しい値を指定します。 ベストプラクティスは、値を言語キーとして指定することです。 たとえば、言語キー edit-on-bitbucket=Edit on Bitbucketを作成すると、その言語キーをボタンの新しいラベルとして指定できます。
edit-on-bitbucket
または、ラベルを明示的に指定することもできます。
Edit on Bitbucket
セクション名の設定
セクション名の設定は、記事に関連付ける任意のトピックの名前を指定するためのものです。 ナレッジベースセクション ウィジェットを使用して、記事の1つ以上のセクション(グループ)を表示できます。 セクションを使用するには、まず ナレッジベースセクション ウィジェットのシステム設定でセクションを定義する必要があります。
新しいセクションを作成するには、
-
[ナレッジベースセクション] 設定メニューに移動します。
-
[ナレッジベース記事セクション管理] 設定の横にあるプラスボタンをクリックして、必要なセクションごとに新しいフィールドを追加します。

-
新しいセクションごとに名前を入力し、 [保存] をクリックします。
セクションを追加したら、 ナレッジベース セクションのドキュメント の手順に従って、セクションの使用方法を確認してください。