The package functions generally follow a dual-interface design:
plain-text variants (*_pacha()) for interactive exploration, and Markdown
variants (*_pacha_md()) for document rendering. Both share the same underlying
source logic, differing only in formatting and error handling. Specific
function availability is detailed in their respective documentation pages.
Designed for interactive lookups and inline queries about a single taxon. They prioritize explicit feedback:
Return a localized message when data is missing.
Raise an R warning() and return a connection message on network failure.
Warn when ColDP taxon resolution requires disambiguation.
Print output directly to the console via cat() (returning invisibly)
to preserve multi-line formatting (except indexation_urls_pacha()).
Designed for assembling multi-component or multi-taxon Markdown reports. They prioritize clean document compilation:
Suppress all R warning()s, including connection and disambiguation issues.
Return an empty string ("") invisibly when data is unavailable,
preventing broken layouts or redundant headers in the compiled document.
Use *_pacha() when inspecting an individual taxon interactively.
Use *_pacha_md() when generating dynamic reports (e.g., Quarto or R Markdown),
where unavailable data should omit silently rather than disrupt document rendering.