workflow_shared docs build pr

_shared-docs-build-pr.yml

Ansible collection docs build (PR)

Jobs

ID	Name	Permissions
build-ansible-docs	Build Ansible Docs	contents: read

---

Inputs

Name (✅required)	Type	Default	Description
collection-name	string	${{ github.event.repository.name }}	The collection name in the form namespace.collection.
collection-path	string		This is the relative path component of the collection in question, for example community/general.
python	string	3.9	The version of Python to install.
ansible-ref	string	stable-2.13	The ref from which to install ansible, for example "stable-2.13" or "milestone".
init-dest-dir	string		A directory relative to the checkout where the init process has already been run.
init-lenient	boolean	False	Use the lenient option during build init. Has no effect if init-dest-dir is supplied.
init-fail-on-error	boolean	False	Use the fail-on-error option during build init. Has no effect if init-dest-dir is supplied.
init-antsibull-docs-version	string		The version of antsibull-docs to use during build init. Has no effect if init-dest-dir is supplied. If not supplied, the latest version from PyPI is used. If supplied, must be a git ref from the antsibull-docs repository.
artifact-name	string	${{ github.event.repository.name }}docs${{ github.event.pull_request.head.sha }}	The name of the artifact to upload.
diff-size-limit	number	60000	The max size of the diff, past which it will be truncated.
sort-files	boolean	True	If true, sort the trimmed and rendered list of files.
render-file-line	string	> * `$` $<path_tail>	A template used to render each line of the file list as markdown. This will be processed as a JavaScript regex replace string, and the following named capture groups can be referenced: - $ -- the single character "status" letter in the file list, like "A" or an added file or "M" for a modified file. - $<path_stub> -- the part of the path that will be discarded in the "trimmed" file list. - $<path_tail> -- the relative part of the path; this can be used to concatenate to a URL to create links to the published site. Note that literal $ characters must be escaped as $$ and literal backslashes must be escaped as \
render-diff-truncate-text	string	The diff output was truncated because it exceeded the maximum size.	Markdown text to be used if the diff text was truncated. It will be available in the render-diff template.
render-diff	string	✳ see action.yml for full default value	A template used to render the diff output as markdown. It will be interpreted as a pseudo-JavaScript template literal and the following variables are available for ${var} interpolation: - ${diff} -- the diff text - ${truncated_msg} -- empty if the diff is not truncated, otherwise the value of render-diff-truncate-text

---

Secrets

Name (✅required)	Description

---

Outputs

Name	Description
artifact-name	The same artifact name as passed in, available as an output.
artifact-url	The URL to the build artifacts.
changed	If false, the PR does not change the documentation.
diff	The diff between the base and head of the PR.
diff-truncated	If true, the diff was truncated because it exceeded the max size.
diff-rendered	The markdownr rendered diff between the base and head of the PR.
diff-files	The raw file list from the diff output.
diff-files-trimmed	The file list from the diff with the paths trimmed.
diff-files-rendered	The markdown rendered file list from the diff.