Generación de documentación Code Diary

Este script configura y ejecuta el proceso de documentación automática. Comienza incluyendo las definiciones de macros necesarias a través de `%include`. Luego, crea varias tablas temporales de SAS^© (`work.alias_list`, `work.order_list`, etc.) que contienen los parámetros de configuración (alias, orden de las secciones, encabezados). Finalmente, llama a la macro `%code_diary` para generar el informe Markdown y a la macro `%convert_markdown_to_html` para producir la versión HTML.

Análisis de datos

Type : CREATION_INTERNE

Los datos de configuración se crean directamente en el script mediante pasos DATA que utilizan DATALINES.

1 Bloque de código

INCLUDE

Explicación :
Carga de las bibliotecas de macros ubicadas en el directorio definido 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 las tablas de parametrización (alias, orden, encabezados, exclusiones) necesarias para el funcionamiento de la macro de documentación.

¡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 :
Ejecución de la macro `%code_diary` para el análisis del código y la generación del archivo Markdown, seguida de la conversión a HTML a través de `%convert_markdown_to_html`.

¡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	);
12
13	%convert_markdown_to_html(
14	in_file_md = "&DEMO_ROOT.output-for-all.md",
15	out_file_html = "&DEMO_ROOT.output-for-all.htm",
16	debug_mode = 0
17	);

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