archival import

Options

-h, --help

print help for this command.

-n, --name <field_name>

If generating objects, the data field to use to generate object file names.

-f, --format <csv|json>

The format of the source data. Inferred from the file extension if importing from a file.

-m, --map <from:to>

map a source field name to a destination field name.

Arguments

<object>

The object type if generating objects (e.g. `post`), or an object file to import to (`e.g. post/one.toml`) if importing to a child list.

[child]

If importing to a child list, this is the name of the children to import to.

[file]

The file containing data to import. If not provided, will read from stdout (and `--format` is required).

[path/to/archival-site]

optionally specify a path to an archival site. By default will run in the current working directory.


This command handles importing external structured data into archival object files, and typically is used during automated workflows or initial site data population.