Generación de documentación Code Diary y conversión a HTML

Este programa inicializa el entorno incluyendo macros específicas (`code_diary`, `convert_markdown_to_html`). Luego define, a través de pasos DATA y `datalines`, tablas de configuración para gestionar alias, el orden de las secciones, los encabezados y las reglas de limpieza ('scrub'). Finalmente, ejecuta la macro `%code_diary` para producir un archivo Markdown a partir de un proyecto SAS^©, seguido de la macro `%convert_markdown_to_html` para producir el resultado final en formato HTML.

Análisis de datos

Type : CREATION_INTERNE

Los datos utilizados (alias_list, order_list, header_list, scrub_list) son tablas de parametrización creadas directamente en el script a través de `datalines`.

1 Bloque de código

MACRO CALL

Explicación :
Inclusión de las definiciones de macros externas necesarias para el procesamiento desde el directorio apuntado por la variable macro `&MACRO_ROOT`.

¡Copiado!

1	%include "&MACRO_ROOT.code_diary.sas";
2	%include "&MACRO_ROOT.convert_markdown_to_html.sas";
3

2 Bloque de código

DATA STEP Data

Explicación :
Creación de cuatro tablas SAS temporales (`alias_list`, `order_list`, `header_list`, `scrub_list`) utilizando `datalines`. Estas tablas contienen los parámetros de configuración para la macro de documentación (mapeo de palabras clave, orden de visualización, etiquetas de encabezados, elementos a ocultar).

¡Copiado!

1	DATA work.alias_list;
2	INFILE DATALINES;
3	INPUT short_keyword $1-10 long_keyword $11-50;
4	DATALINES;
5	excl exclusion
6	stat statistics
7	;
8
9	DATA work.order_list;
10	INFILE DATALINES;
11	INPUT keyword $1-20 order_no 21-25;
12	DATALINES;
13	todo -30
14	exclusion -20
15	exclusion.time -19
16	exclusion.person -18
17	methods -10
18	no_keyword 0
19	;
20
21	DATA work.header_list;
22	INFILE DATALINES;
23	INPUT keyword $1-15 header $16-50;
24	DATALINES;
25	exclusion Exclusion criteria
26	person Subjects
27	time Time periods
28	todo Task list
29	;
30
31	DATA work.scrub_list;
32	INFILE DATALINES;
33	INPUT keyword $1-15;
34	DATALINES;
35	todo
36	regex
37	;

3 Bloque de código

MACRO CALL

Explicación :
Llamada a la macro `%code_diary` para analizar el archivo `project_main.sas`. Utiliza las tablas de configuración creadas previamente para estructurar y filtrar el contenido, generando dos archivos Markdown como salida.

¡Copiado!

1	%code_diary(
2	input_main_file = &DEMO_ROOT.project_main.sas,
3	out_dir = &DEMO_ROOT,
4	out_file = OUTPUT-coder.md,
5	out_file_scrubbed = OUTPUT-for-all.md,
6	debug_mode = 0,
7	section_aliases = work.alias_list,
8	section_order = work.order_list,
9	section_headers = work.header_list,
10	sections_scrubbed = work.scrub_list
11	);

4 Bloque de código

MACRO CALL

Explicación :
Llamada a la macro `%convert_markdown_to_html` para convertir el archivo Markdown generado (`output-for-all.md`) en una página HTML (`output-for-all.htm`).

¡Copiado!

1	%convert_markdown_to_html(
2	in_file_md = "&DEMO_ROOT.output-for-all.md",
3	out_file_html = "&DEMO_ROOT.output-for-all.htm",
4	debug_mode = 0
5	);

Este material se proporciona "tal cual" por We Are Cas. No hay garantías, expresas o implícitas, en cuanto a la comerciabilidad o idoneidad para un propósito particular con respecto a los materiales o el código contenidos en este documento. We Are Cas no es responsable de los errores en este material tal como existe ahora o existirá, ni We Are Cas proporciona soporte técnico para el mismo.

Retour à la liste