forgejo/docs/content/doc/advanced
Alexander Scheel ee7df7ba8c Markdown: Sanitizier Configuration (#9075)
* Support custom sanitization policy

Allowing the gitea administrator to configure sanitization policy allows
them to couple external renders and custom templates to support more
markup. In particular, the `pandoc` renderer allows generating KaTeX
annotations, wrapping them in `<span>` elements with class `math` and
either `inline` or `display` (depending on whether or not inline or
block mode was requested).

This iteration gives the administrator whitelisting powers; carefully
crafted regexes will thus let through only the desired attributes
necessary to support their custom markup.

Resolves: #9054

Signed-off-by: Alexander Scheel <alexander.m.scheel@gmail.com>

* Document new sanitization configuration

 - Adds basic documentation to app.ini.sample,
 - Adds an example to the Configuration Cheat Sheet, and
 - Adds extended information to External Renderers section.

Signed-off-by: Alexander Scheel <alexander.m.scheel@gmail.com>

* Drop extraneous length check in newMarkupSanitizer(...)

Signed-off-by: Alexander Scheel <alexander.m.scheel@gmail.com>

* Fix plural ELEMENT and ALLOW_ATTR in docs

These were left over from their initial names. Make them singular to
conform with the current expectations.

Signed-off-by: Alexander Scheel <alexander.m.scheel@gmail.com>
2019-12-07 14:49:04 -05:00
..
api-usage.en-us.md
api-usage.zh-cn.md
ci-cd.en-us.md
config-cheat-sheet.en-us.md Markdown: Sanitizier Configuration (#9075) 2019-12-07 14:49:04 -05:00
config-cheat-sheet.zh-cn.md
customizing-gitea.en-us.md
customizing-gitea.zh-cn.md
external-renderers.en-us.md Markdown: Sanitizier Configuration (#9075) 2019-12-07 14:49:04 -05:00
hacking-on-gitea.en-us.md
hacking-on-gitea.zh-cn.md
logging-documentation.en-us.md
mail-templates-us.md
make.en-us.md
make.fr-fr.md
make.zh-cn.md
migrations.en-us.md
oauth2-provider.md
repo-indexer.en-us.md
signing.en-us.md
specific-variables.en-us.md
specific-variables.zh-cn.md
third-party-tools.en-us.md
third-party-tools.zh-cn.md