[前提条件]
- クエリ ヘルプ () ファイルには、同じベース名を持つ付随するクエリ () ファイルが必要です。
- クエリ ヘルプ ファイルは、クエリ ヘルプ ドキュメントの標準の構造とスタイルに従う必要があります。 詳しくは、CodeQL リポジトリの「クエリ ヘルプ スタイル ガイド」を参照してください。
クエリ ヘルプ ファイルのプレビュー
-
クエリ ヘルプ ファイルを Markdown としてレンダリングするには、次のコマンドを実行します。
Shell codeql generate query-help <qhelp|query|dir|suite> --format=markdown [--output=<dir|file>]
codeql generate query-help <qhelp|query|dir|suite> --format=markdown [--output=<dir|file>]このコマンドで使用できるオプションについては、 AUTOTITLE を参照してください。
-
警告メッセージが表示された場合は、それらを確認して修正してから、コマンドを再実行します。 既定では、CodeQL CLI では次の場合に警告メッセージが出力されます。
- クエリ ヘルプのいずれかが無効です
- コマンドで指定された ファイルに、添付の ファイルと同じベース名がない
- コマンドで指定された ファイルに、添付の ファイルと同じベース名がない
-
出力ディレクトリ、ファイル、またはターミナルでレンダリングされた Markdown を確認して、ファイルが期待どおりに表示されることを確認します。
詳細については、次を参照してください。
- クエリ ヘルプ ファイル
- AUTOTITLE