Reports
Reports contain the changes detected (diff) and can be one of the following formats (depending on the reporter used and, at times, its settings):
As a reminder, report sub-directives are set in the configuration.
Text
Unicode text
Optional sub-directives
details
: Includes the diff of each job (true/false); defaults to true. Ignored ifminimal
is true.footer
: Show footer listing number of jobs and elapsed time (true/false); defaults to true. Ignored ifminimal
is true.line_length
: The maximum length of each line in characters; defaults to 75 (integer). Ignored ifminimal
is true.minimal
: An abbreviated report version (true/false); defaults to false.separate
: Send a separate report for each job instead of a single combined report (true/false); defaults to false.
HTML
HTML
These reports are by default unified format diffs that are prettified by webchanges by:
Making links clickable;
Correctly representing Markdown formatting such as bolding / headers, italics, underlining, list bullets (•) and indentation;
Using intuitive colors and strikethrough to highlight added and deleted lines.
Note
You may receive a report that shows a deletion of some text and the addition of the same exact text: this is most likely due to a change in an underlying link.
Optional sub-directives
diff
: Deprecated; specify a differ in the job instead.footer
: Show footer listing number of jobs and elapsed time (true/false); defaults to true.separate
: Send a separate report for each job instead of a single combined report (true/false); defaults to false.title
: The document’s title. Use{count}
for the number of reports,{jobs}
for the title of jobs reported, and {jobs_files} for a space followed by the name of the jobs file(s) used within parenthesis, stripped of precedingjobs-
, if not using the defaultjobs.yaml
. Default:[webchanges] {count} changes:{jobs_files} {jobs}
.
Changed in version 3.21: Deprecated the sub-directive diff
.
Markdown
Markdown text, used in e.g. matrix
, telegram
, and webhook
reporters (if the latter has the sub-directive
markdown: true
)
Optional sub-directives
details
: Includes the diff of each job (true/false); defaults to true. Ignored ifminimal
is true.footer
: Show footer listing number of jobs and elapsed time (true/false); defaults to true. Ignored ifminimal
is true.minimal
: An abbreviated report version (true/false); defaults to false.separate
: Send a separate report for each job instead of a single combined report (true/false); defaults to false.