NAME

oEdtk::Run - orchestrate a composition run: LaTeX, post-processing and output

SYNOPSIS

use oEdtk::Run qw(oe_compo_run oe_after_compo);

oe_compo_run($app, { mode => 'pdf' });
oe_after_compo($app, { outfile => $pdf });

DESCRIPTION

Runs one composition: it launches the LaTeX executable in the configured mode, post-processes the result (dvipdfm, cleanup, index import), and packs or exports the output through oEdtk::Outmngr and oEdtk::EDMS. It also provides the command helpers used throughout the oEdtk runtime.

FUNCTIONS

oe_status_to_msg

my $msg = oe_status_to_msg($status);

Translate a process wait status into a human message, or return nothing when the status is zero.

oe_compo_run

oe_compo_run($app, \%options);

Run the LaTeX composition of $app in the configured mode. %options may carry mode, jobname, extrapkgs, incdirs, fifo and cldstatus; in FIFO mode the process runs in the background and its pid is returned.

oe_after_compo

oe_after_compo($app, \%options);

Post-process the composition: run dvipdfm in DVI+PDF mode, print the path of the generated PDF, clean up the intermediate files, and import the index or build the EDMS pack when one was requested.

oe_csv_to_doc

my $doc = oe_csv_to_doc($input, $endtag);

Build an oEdtk::TexDoc from a two-column CSV: each numbered group becomes a table, and $endtag ends every record.

oe_outmngr_output_run_tex

my @lots = oe_outmngr_output_run_tex(\%filter, $type);

Export the matching lots, compose each one into a PDF, pad recto-verso lots, and pack each lot's index and PDF into a zip archive; return the lots.

oe_cmd_run

oe_cmd_run($cmd);

Run $cmd, with its stdout redirected to stderr, and die with the translated status when it fails.

The following subs are internal helpers and are not part of the public API: oe_cmd_run_bg, listing_depository, update_idx, oe_background_pdf and _filiere_is_rectoverso.

AUTHOR

The oEdtk team.