ナレッジベースシステム設定
管理者は、システム設定UIを使用して、ナレッジベースのグローバル構成(サイト全体にわたる構成)を設定できます。この UI には、 コントロール パネル → システム設定 → ナレッジ ベース からアクセスできます。ナレッジベースの構成設定には、以下の5つのセクションがあります。
- 知識ベースサービス
- ナレッジベース記事
- 知識ベース表示
- 知識ベース検索
- 知識ベースセクション
ナレッジベースサービス セクションの設定は、すべてのナレッジベースウィジェットと、サイト管理のナレッジベースアプリに既定値として適用されます。その他のセクションは特定のナレッジベースウィジェットに適用され、 ナレッジベースサービス のデフォルトを上書きします。
ナレッジベースアプリケーションのシステム設定の高度な構成は、Liferay DXP管理者のみが行うべきです。
ナレッジベースには、デフォルトで無効になっているオプション機能がいくつかありますが、システム設定から有効にして設定できます。これらには、インポーターファイルの規則、新しい記事の優先度の増分、ソースURL、およびセクション名が含まれます。
インポーターのファイル規則設定
これらの設定は、サポートされるファイル拡張子、親ファイルの接尾辞、およびインポートされたZIPファイル内のイメージフォルダのパスを定義します。これらの設定は、ナレッジベースのシステム設定の ナレッジベースサービス セクションでアクセスできます。
以下の設定では、インポーターがサポートするファイル拡張子を指定します。
Markdown Importer の記事拡張子: サポートされている記事拡張子を設定します。デフォルト値は .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を作成した場合、その言語キーをボタンの新しいラベルとして指定できます。
ビットバケットで編集
あるいは、ラベルを明示的に指定することもできます。
Bitbucketで編集
セクション名設定
セクション名の設定は、記事に関連付ける任意のトピック名を指定するためのものです。ナレッジベースセクション ウィジェットを使用すると、1 つまたは複数の記事のセクション (グループ) を表示できます。セクションを使用するには、まずシステム設定で ナレッジベースセクション ウィジェットのセクションを定義する必要があります。
新しいセクションを作成するには、
-
ナレッジベースセクション 設定メニューに移動します。
-
管理者ナレッジベース記事セクション 設定の横にあるプラスボタンをクリックして、追加したいセクションごとに新しいフィールドを追加します。

-
新しいセクションごとに名前を入力し、 保存 をクリックします。
セクションを追加したら、 ナレッジベースセクションのドキュメント の手順に従って、それらの使用方法を学ぶことができます。