allows one to easily define bigger thumbnails, i.e., those where we
have to big images to show the full on a page, but still want to give
the user a good sized preview.
As PDF renders this already pretty nice by default we only have to
adapt the html asciidoc config. We do that by using asciidocs
"Conditional Attribute References"[0] and add a "big" attribute.
It can be used as:
> [thumbnail="pmg-gui-network-config.png", big=1]
NOTE: the value of big is ignored, it just matters if it's defined.
While it could be possible to add logic to handle big=0, it it's just
extra work without real use, just omit it if not wanted.
[0]: https://www.methods.co.nz/asciidoc/chunked/ch30.html
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
The configuration files of spamassassin (/etc/mail/spamassassin) are provided
and changed by 2 things:
* some files are rendered through the templating engine
* the rest is shipped with proxmox-spamassassin on package upgrades
This patch explicitly lists the first category of files, clarifying the
situation for our users.
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
This patch adds the configuration options for before/after queue filtering
and generation of NDRs to the feature list and explains the concepts in
'pmgconfig.adoc' below the 'Options' panel of the MailProxy configuration
(where the features can be enabled in the GUI)
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Users regularly ask how to classify mails containing some keywords as spam.
Given that this usually indicates a misconfiguration in their DNS-Setup, and
the changes lead to more false positives than actually catching more spam
we should address this more explictly in the documentation.
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Add a short section explaining DKIM and the specifics of Signing in PMG.
Additionally gen-pmg.conf.5-opts.pl was extended to create
'pmg.admin-dkim-conf-opts.adoc' for inclusion below the documentation.
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
One of the core features of PMG is the rule-system, which is documented in
'pmg-mail-filter.adoc' under the (correct) heading of 'Mail Filter'
In quite a few other places [0,1] where the features of PMG are highlighted we
refer to the (Object Oriented) Rule System.
When skimming through the documentation and quickly glancing at links the
connection 'Rule System' <-> 'Mail Filter' is not directly apparent and could
cause confusion.
This is addressed by adding 'Rule-Based' as prefix to the chapter title.
[0] https://www.proxmox.com/en/proxmox-mail-gateway/features
[1] https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#_features
Reported-by: Daniela Häsler <daniela@proxmox.com>
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
the apache/conf-available snippet for pmg-docs-apache should be named like the
package according to lintian (non-standard-apache2-configuration-name).
move the configfile via dpkg-maintscript-helper(1) (see the manpage for
the explaination of the prior version of 6.0-3~) and dh_installdeb(1).
Tested by upgrading pmg-docs-apache to a version with this commit, while having
modifications in '/etc/apache2/conf-available/pmg-docs.conf'
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
pmg.proxmox.com does not host only the documentation the default redirect
to '/pmg-docs' should be removed
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
The loading of an external hosted ExtJS is from a time where we did
not have a extra ExtJS package as it still was in the pve-manager
one, which was not desired to be installed on a non-pmg machine.
Add a dependency on libjs-extjs and a link from api-viewer/extjs to
the installation directory of the ExtJS package, this allows to reuse
ExtJS on PMG node hosted docs and on the hosted docs from proxmox.com
at the same time.
Adapted from the Proxmox VE version[0] of this change.
[0]: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff;h=e56030c4d7c3bd0de1ebc109d528fb6b7bef05a3
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
containing a short apache-config snippet for delivering the pmg-docs via apache.
Mostly added for consistency between pve-docs (containing pve-docs-mediawiki)
and pmg-docs (containing pmg-docs-apache, because it does not have a wiki)
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Requested by Martin as the support@ address is now quite wired to the
enterprise support ticket system, and office is for more general
requests.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
