Render your pod documents and generate html, pdf or md output depending on the options --html, --pdf or --md. When one of the options are not used, the output files of previous runs are removed (see as if it is older documentation). The default option is --html if none of them is provided.
pod-render.pl6 --pdf bin/pod-render.pl6
pod-render.pl6 [<R<options>> ...] <R<pod-file | pod-dir>> ...
This is the file where to find the pod documentation and is rendered. A pod file is checked to have at least 5 pod render commands like =begin ...
or =for ...
to get rendered.
Search directory and subdirectories for perl6 pod documentation looking for extensions .pl6, .pm6, .pod6, .pl, .pm or .pod.
Normally the output is placed in the current directory or in the ./doc directory if it exists. This option will place the output elsewhere if present. if 'dir' does not exist, it is placed in the current directory.
Same as --d=dir except that the directory is taken from the first argument on the commandline. This is more convenient because autocomplete can be used in a terminal session.
pod-render.pl6 ... --d ... <outout-dir> <R<pod-file | pod-dir>> ...
Small warning though; the option will be set to "◩◪◩◪◩◪◩◪◩◪" to recognize that the program must get the output dir from the argument list. Raku will show a usage output if I don't.
Generate a list of markdown references into the file markdown-refs.md. The format of this file will be like the following;
[pod-render.pl6 html]: https://nbviewer.jupyter.org/github/MARTIMM/pod ... [pod-render.pl6 pdf]: https://nbviewer.jupyter.org/github/MARTIMM/pod- ... [pod-render.pl6 md]: https://github.com/MARTIMM/pod-render/blob/master ... ...
Where the github path is github.com/MARTIMM/pod-render and the pod files are found at bin/pod-render.pl6 and lib/Pod/Render.pm6.
Generate output in html format. This is the default. Result is placed in the current directory or in the ./doc directory if it exists.
Generate output in md format. Result is placed in current directory or in the ./doc directory if it exists.
Generate output in pdf format. Result is placed in current directory or in the ./doc directory if it exists. Pdf is generated using the program prince so that must be installed. See downloads.