ナレッジベースのZIPファイルの要件
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。
ナレッジベースインポーターは記事の階層をサポートしているため、ZIPファイルのディレクトリ構造のどこにでもマークダウンファイルを指定できます。 それらは、任意の数のフォルダーにネストできます。 添付ファイルでサポートされているファイルは画像ファイルのみです。
ZIPファイルの記事は、ファイル順にインポートされます（英数字順）。 記事の優先度を指定するには、ファイル名に数値の接頭辞を追加します。 たとえば、 01-file.markdown および 02-file.markdown という名前の記事の優先度は 1.0 および 2.0ます。
記事を同じソースフォルダー内の他のすべての記事の親として指定するには、ファイル名の末尾に -intro.markdownます。 これにより、親子階層が作成されます。 親記事にプレフィックス 00 を使用して、それらをフォルダーのファイル順序の一番上に配置できます。 インポーターは、記事の優先順位としてイントロファイルのフォルダーの数値プレフィックスを使用します。
00 プレフィックスの基本的なロジックは次のとおりです。
- 非イントロファイルのファイルプレフィックス
00は、結果の記事の優先度を1.0割り当てます。 - 最上位のイントロファイルのファイルプレフィックス
00は、記事の優先順位を、1.0以上の最初に見つかったフォルダーの数値プレフィックスに設定します。
この規則により、階層内のトップレベル（子ではない）記事の優先順位を指定できます。
インポートするときに、チェックボックス 付けたままにします。記事ファイルの数値のプレフィックスを優先度 として適用します。 ファイルにプレフィックスがない場合、その記事は次に使用可能な優先度（現在の最高の優先度に1を加えたもの）を取得します。
以下は、これまでに述べた機能を示すZIPファイル構造の例です。
ZIPファイル構造の例：
-
01-winter-events/00-winter-excursions-intro.markdown01-star-dust-snow-shoeing.markdown02-lunar-alpine.markdown
-
02-summer-events/00-summer-excursions-intro.markdown01-lunar-rock-scrambling.markdown02-extra-terrestrial-mountain-biking.markdown03-lunar-olympics/00-lunar-olympics-intro.markdown01-zero-gravity-diving.markdown
-
images/some-image.pnganother-image.jpeg
上記のZIPファイルは、隣接するMarkdownファイルの親として 00-winter-excursions-intro.markdown しています： 01-star-dust-snow-shoeing.markdown および 02-lunar-alpine.markdown。 同様に、 00-lunar-olympics-intro.markdown は 01-zero-gravity-diving.markdownの親です。 00-lunar-olympics-intro.markdown は、 01-lunar-rock-scrambling.markdown および 02-extra-terrestrial-mountain-biking.markdownのピアでもあり、 00-summerの子でもあります。 -excursions-intro.markdown。
ZIP例の結果の関係と優先順位
01-winter-events/00-winter-excursions-intro.markdown- 記事： 冬の遠足
- **関係： 夏の遠足の ピア
- 優先度： 1.0
01-winter-events/01-star-dust-snow-shoeing.markdown
- 記事： スターダストスノーシューイング
- **関係： 冬の遠足の子供
01-winter-events/02-lunar-alpine.markdown
- 記事： 月の高山
- **関係： 冬の遠足の子供
02-summer-events/00-summer-excursions-intro.markdown
- 記事： 夏の遠足
- **関係： 冬の遠足の ピア
02-summer-events/01-lunar-rock-scrambling.markdown
- 記事： ルナロックスクランブル
- **関係： 夏の遠足の子供
02-summer-events/02-extra-terrestrial-mountain-biking.markdown
- 記事： 地球外マウンテンバイク
- **関係： 夏の遠足の子供
02-summer-events/03-summer-olympics/00-lunar-olympics-intro.markdown
- 記事： 太陰五輪
- **関係： 夏の遠足の子供
02-summer-events/03-summer-olympics/01-zero-gravity-diving.markdown
- 記事： ゼロ重力ダイビング
- **関係： 夏の遠足の 孫
ZIPファイルは次の要件を満たしている必要があります。
- 各ZIPファイルは、サフィックス
.zip終わる必要があります。 - 各ZIPファイルには、オプションでフォルダに整理された、少なくとも1つのMarkdownソースファイルが含まれている必要があります。
- 参照されるすべての画像ファイルは、ZIPファイルのルートにある
imagesという名前のフォルダーにある必要があります。 - 画像ファイルはサポートされている形式である必要があり、適切なファイル拡張子を使用する必要があります。 サポートされている拡張子は
.BMP、.GIF、.JPEG、.JPG、及び.PNG。 アプリのシステム設定で指定します。 詳細については、 ナレッジベースシステム設定参照してください。
記事のZIPファイルを取得したら、それをインポートします。
次の手順に従って、ZIPファイルをインポートします。
-
メニュー（
）で、 サイト管理 （サイトのメニュー）→ コンテンツ → ナレッジベース → 記事ます。
-
追加 （
）→ インポート をクリックして、インポーターページを表示します。
-
ファイルの場所を参照し、ほとんどの場合、記事の優先度のチェックボックスをオンのままにして、 *[保存]*クリックします。
ファイルがアップロードされ、インポーターは各ソースファイルのMarkdownテキストをHTMLに変換し、HTMLを結果の記事に適用します。 記事で参照され、ZIPファイルに含まれている画像ファイルは、記事への添付ファイルとしてインポートされます。
ソースファイルと画像に加えて、ソースファイルのリポジトリの場所を指定するインポーターのベースソースURLシステム設定を構成できます。 各記事の GitHubの上の編集 （有効な場合）ボタンを押して、元の場所にユーザーを取ります。 インポーターは、各ファイルのパスの先頭にベースソースURLを付けます。 これにより、記事のリポジトリソースの場所へのURLが作成されます。 [ベースURL] / [記事のファイルパス]ように見えます。 次に、ベースソースURLの例を示します。
https://github.com/liferay/liferay-docs/blob/master/develop/tutorials
このベースURLと記事ソースファイル folder-1 / some-article.markdown から構成されるソースURLは次のようになります。
https://github.com/liferay/liferay-docs/blob/master/develop/tutorials/folder-1/some-article.markdown
ベースソースURLは、ZIPファイルのルートフォルダーにある .METADATA というファイルで指定します。 インポーターは .METADATA ファイルを標準のJavaプロパティファイルとして扱い、ベースソースURLを使用して、ZIPファイルのすべての結果の記事のソースURLを作成します。
ソースURL機能を使用するには、管理者が ナレッジベースシステム設定有効にする必要があります。