Command line interface
The iolanta command renders Linked Data resources from local files, URLs,
queries, search results, and Jinja2 Markdown templates.
Use one input mode at a time:
- a positional URL or file path,
--query,--search,--render-template.
Reference
iolanta
Render a given URL.
Usage
iolanta [OPTIONS][URL]
Arguments
| Name | Description | Required |
|---|---|---|
URL |
No |
Options
| Name | Description | Required | Default |
|---|---|---|---|
--query TEXT |
SPARQL query to execute. | No | - |
--search TEXT |
Notion to look up across linked-data search APIs. | No | - |
--render-template PATH |
Jinja2 Markdown template to render. | No | - |
--as TEXT |
No | - | |
--language TEXT |
Data language to prefer. | No | en |
--without-visualization-cache-index |
Always refresh the visualization nanopub index from the registry; still write the result to the disk cache. | No | False |
--log-level [debug|info|warning|error] |
No | LogLevel.ERROR |
|
--install-completion |
Install completion for the current shell. | No | - |
--show-completion |
Show completion for the current shell, to copy it or customize the installation. | No | - |
Commands
No commands available
Common modes
Render a URL or local file as an output datatype:
iolanta https://orcid.org/0000-0002-1825-0097 --as title
Run a SPARQL query and render the result:
iolanta --query 'SELECT * WHERE { ?s ?p ?o } LIMIT 10' --as table
Search Linked Data APIs and emit JSON Lines:
iolanta --search 'Isaac Asimov' --as jsonl
Pre-render a Jinja2 Markdown document and redirect the rendered Markdown to a file:
iolanta --render-template source.jinja2.md > source.output.md
Template rendering
--render-template prints rendered Markdown to stdout. Use shell redirection to
write the output to a file.
Template rendering uses the template file's parent directory as
Iolanta.project_root. Templates can use local YAML-LD files in that directory,
project data, installed Iolanta facilities, and normal web loading.
See --render-template macros & variables
for the supported template surface.
Visualization discovery
Pass --without-visualization-cache-index to refresh the visualization nanopub URL list from the Knowledge Pixels registry on every run while still updating the disk cache. See iolanta:visualizes for the full discovery flow.