Skip to main content

クエリ ヘルプ ファイルのテスト

CodeQL クエリヘルプファイルが有効であることを確認するために、Markdown としてプレビューする。

この機能を使用できるユーザーについて

CodeQL は、次の種類のリポジトリで使用できます:

[前提条件]

  • クエリ ヘルプ () ファイルには、同じベース名を持つ付随するクエリ () ファイルが必要です。
  • クエリ ヘルプ ファイルは、クエリ ヘルプ ドキュメントの標準の構造とスタイルに従う必要があります。 詳しくは、CodeQL リポジトリの「クエリ ヘルプ スタイル ガイド」を参照してください。

クエリ ヘルプ ファイルのプレビュー

  1. クエリ ヘルプ ファイルを Markdown としてレンダリングするには、次のコマンドを実行します。

    Shell
    codeql generate query-help <qhelp|query|dir|suite> --format=markdown [--output=<dir|file>]
    

    このコマンドで使用できるオプションについては、 AUTOTITLE を参照してください。

  2. 警告メッセージが表示された場合は、それらを確認して修正してから、コマンドを再実行します。 既定では、CodeQL CLI では次の場合に警告メッセージが出力されます。

    • クエリ ヘルプのいずれかが無効です
    • コマンドで指定された ファイルに、添付の ファイルと同じベース名がない
    • コマンドで指定された ファイルに、添付の ファイルと同じベース名がない
  3. 出力ディレクトリ、ファイル、またはターミナルでレンダリングされた Markdown を確認して、ファイルが期待どおりに表示されることを確認します。

詳細については、次を参照してください。

  • クエリ ヘルプ ファイル
  • AUTOTITLE