Reports

Overview

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 if minimal is true.

  • footer: Show footer listing number of jobs and elapsed time (true/false); defaults to true. Ignored if minimal is true.

  • line_length: The maximum length of each line in characters; defaults to 75 (integer). Ignored if minimal 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 preceding jobs-, if not using the default jobs.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 if minimal is true.

  • footer: Show footer listing number of jobs and elapsed time (true/false); defaults to true. Ignored if minimal 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.