Skip to main content

Prueba de archivos de ayuda de consulta

Asegúrese de que los archivos de ayuda de consulta de CodeQL sean válidos al previsualizarlos como Markdown.

¿Quién puede utilizar esta característica?

CodeQL está disponible para los siguientes tipos de repositorios:

Prerrequisitos

  • Los archivos de ayuda de consulta () deben tener archivos de consulta adjuntos () con nombres base idénticos.
  • Los archivos de ayuda de consulta deben seguir la estructura estándar y el estilo de la documentación de ayuda de consulta. Para obtener más información, consulta la guía de estilo de la ayuda de consulta en el repositorio de CodeQL.

Vista previa de los archivos de ayuda de consulta

  1. Para representar los archivos de ayuda de consulta como Markdown, ejecute el siguiente comando:

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

    Para obtener información sobre las opciones disponibles para este comando, vea AUTOTITLE.

  2. Si recibe algún mensaje de advertencia, revise y corrijalos, vuelva a ejecutar el comando. De forma predeterminada, la CodeQL CLI imprimirá un mensaje de advertencia si:

    • Cualquiera de la ayuda de consulta no es válida
    • Los archivos especificados en el comando no tienen el mismo nombre base que el archivo que los acompaña.
    • Los archivos especificados en el comando no tienen el mismo nombre base que el archivo que los acompaña.
  3. Revise el Markdown renderizado en su directorio de salida, archivo o terminal para comprobar que sus archivos aparecen como se espera.

Lectura adicional

  • Consultar archivos de ayuda
  • AUTOTITLE