Generación de documentos

El uso secundario de configlet es generar documentos.

Uso

El comando generate se puede usar para generar documentos de instrucciones o de introducción a partir de una plantilla.

configlet [global-options] generate

Global options:
  -h, --help                   Show this help message and exit
      --version                Show this tool's version information and exit
  -t, --track-dir <dir>        Specify a track directory to use instead of the current directory
  -v, --verbosity <verbosity>  The verbosity of output. Allowed values: q[uiet], n[ormal], d[etailed]

Documentos

Estos son los documentos que configlet puede generar.

Documento: archivo introduction.md de un ejercicio de concepto

Cada ejercicio de concepto tiene un archivo introduction.md. Cada ejercicio puede tener, de forma opcional, un archivo introduction.md.tpl.

El archivo de plantilla debe tratarse como un archivo Markdown normal, pero con una característica adicional: la posibilidad de especificar marcadores de posición. Se admiten los siguientes marcadores de posición:

• %{concept:<slug>}: hace referencia al documento introduction.md del concepto

Cuando configlet detecta que un ejercicio de concepto tiene un archivo introduction.md.tpl, genera a partir de él un archivo introduction.md. La introducción generada tendrá el mismo contenido que la plantilla, salvo los marcadores de posición, que se reemplazarán por el contenido de los documentos a los que hacen referencia.

Documento: archivo introduction.md de un ejercicio de práctica

Cuando configlet detecta que un ejercicio de práctica implementa un ejercicio de Problem Specifications que tiene un archivo introduction.md, configlet sincronizará el archivo .meta/introduction.md del ejercicio de práctica con el archivo introduction.md del ejercicio de Problem Specifications.

Documento: archivo instructions.md de un ejercicio de práctica

Cuando configlet detecta que un ejercicio de práctica implementa un ejercicio de Problem Specifications, configlet sincronizará el archivo .meta/instructions.md del ejercicio de práctica con el archivo instructions.md del ejercicio de Problem Specifications o con su archivo description.md cuando no se encuentre ningún archivo instructions.md.

Documento: archivo .meta/config.json de un ejercicio de práctica

Cuando configlet detecta que un ejercicio de práctica implementa un ejercicio de Problem Specifications, configlet sincronizará las claves source y source_url del archivo metadata.yml del ejercicio de Problem Specifications con las propiedades source y source_url del archivo .meta/config.json del ejercicio de práctica.