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