unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob 4b5f84a82e9f812aa37fb14923127179ef2a2c6c 2990 bytes (raw)
name: devel/nmbug/doc/man5/notmuch-report.json.5.rst 	 # note: path name is non-authoritative(*)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
==============
notmuch-report
==============

NAME
====

notmuch-report.json - configure output for **notmuch-report(1)**

DESCRIPTION
===========

The config file is JSON_ with the following fields:

meta
  An object with page-wide information

  title
    Page title used in the default header.

  blurb
    Introduction paragraph used in the default header.

  header
    `Python format string`_ for the HTML header.  Optional.  It is
    formatted with the following context:

    date
      The current UTC date.

    datetime
      The current UTC date-time.

    title
      The **meta.title** value.

    blurb
      The **meta.blurb** value.

    encoding
      The encoding used for the output file.

    inter_message_padding
      0.25em, for consistent CSS generation.

    border_radius
      0.5em, for consistent CSS generation.

  footer
    `Python format string`_ for the HTML footer.  It is formatted with
    the same context used for **meta.header**.  Optional.

  message-url
    `Python format string`_ for message-linking URLs.  Optional.
    Defaults to linking Gmane_.  It is formatted with the following
    context:

    message-id
      The quoted_ message ID.

    subject
      The message subject.

views
  An array of view objects, where each object has the following
  fields:

  title
    Header text for the view.

  comment
    Paragraph describing the view in more detail.  Optional.

  id
    Anchor string for the view.  Optional, defaulting to a slugged
    form of the view title

  query
    An array of strings, which will be joined with 'and' to form the
    view query.

.. _Gmane: http://gmane.org/
.. _JSON: http://json.org/
.. _Python format string: https://docs.python.org/3/library/string.html#formatstrings
.. _quoted: https://docs.python.org/3/library/urllib.parse.html#urllib.parse.quote

EXAMPLE
=======

::

  {
    "meta": {
      "title": "Notmuch Patches",
      "blurb": "For more information see <a href=\"http://notmuchmail.org/nmbug\">nmbug</a>",
      "header": "<html><head></head><body><h1>{title}</h1><p>{blurb}</p><h2>Views</h2>",
      "footer": "<hr><p>Generated: {datetime}</p></html>",
      "message-url": "http://mid.gmane.org/{message-id}"
    },
    "views": [
      {
        "title": "Bugs",
        "comment": "Unresolved bugs.",
        "query": [
          "tag:notmuch::bug",
          "not tag:notmuch::fixed",
          "not tag:notmuch::wontfix"
        ]
      },
      {
        "title": "Review",
        "comment": "These patches are under review, or waiting for feedback.",
        "id": "under-review",
        "query": [
          "tag:notmuch::patch",
          "not tag:notmuch::pushed",
          "not tag:notmuch::obsolete",
          "not tag:notmuch::stale",
          "not tag:notmuch::wontfix",
          "(tag:notmuch::moreinfo or tag:notmuch::needs-review)"
        ]
      }
    ]
  }

SEE ALSO
========

**notmuch(1)**, **notmuch-report(1)**, **notmuch-search(1)**, **notmuch-tag(1)**

debug log:

solving 4b5f84a ...
found 4b5f84a in https://yhetil.org/notmuch.git/

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).