
This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type, podman-quadlet.7.md for general quadlet information and podman-quadlet-basic-usage.7.md for quadlet examples. - Removes the original podman-systemd.unit.5.md file. - Adds support for jinja2 templating language in the markdown_preprocess. - Uses jinja2 in options/*.md to use the single .md file for both podman subcommands man-pages and quadlet man-pages. This deduplicates the Quadlet man-pages a lot. - Adds new `@@option quadlet:source.md` preprocess command to import such .md files from options directory. Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
1.2 KiB
####> This option file is used in: ####> podman build, podman-build.unit.5.md.in, farm build ####> If file is edited, make sure the changes ####> are applicable to all of those. {% if is_quadlet %}
File=Containerfile
{% else %}
--file, -f=Containerfile
{% endif %}
Specifies a Containerfile which contains instructions for building the image, either a local file or an http or https URL. If more than one Containerfile is specified, FROM instructions are only be accepted from the last specified file.
{% if is_quadlet %}
Note that for a given relative path to a Containerfile, or when using a http(s)://
URL, you also must set
SetWorkingDirectory=
in order for podman build
to find a valid context directory for the
resources specified in the Containerfile.
Note that setting a File=
field is mandatory for a .build
file, unless SetWorkingDirectory
(or
a WorkingDirectory
in the Service
group) has also been set.
{% else %}
If a build context is not specified, and at least one Containerfile is a
local file, the directory in which it resides is used as the build
context.
{% endif %}
Specifying the option {{{ 'File=-' if is_quadlet else '-f -
' }}} causes
the Containerfile contents to be read from stdin.