From 5348e198db6cd84467c99d6741715291b33598a1 Mon Sep 17 00:00:00 2001 From: Lunny Xiao Date: Mon, 14 Feb 2022 21:56:17 +0800 Subject: [PATCH] Add example to render html files (#18736) * Add example to render html files * Use class in example Co-authored-by: zeripath --- .../doc/advanced/external-renderers.en-us.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/content/doc/advanced/external-renderers.en-us.md b/docs/content/doc/advanced/external-renderers.en-us.md index e5de7e8efd..34329408a1 100644 --- a/docs/content/doc/advanced/external-renderers.en-us.md +++ b/docs/content/doc/advanced/external-renderers.en-us.md @@ -103,6 +103,27 @@ Once your configuration changes have been made, restart Gitea to have changes ta **Note**: Prior to Gitea 1.12 there was a single `markup.sanitiser` section with keys that were redefined for multiple rules, however, there were significant problems with this method of configuration necessitating configuration through multiple sections. +### Example: HTML + +Render HTML files directly: + +```ini +[markup.html] +ENABLED = true +FILE_EXTENSIONS = .html,.htm +RENDER_COMMAND = cat +; Input is not a standard input but a file +IS_INPUT_FILE = true + +[markup.sanitizer.html.1] +ELEMENT = div +ALLOW_ATTR = class + +[markup.sanitizer.html.2] +ELEMENT = a +ALLOW_ATTR = class +``` + ### Example: Office DOCX Display Office DOCX files with [`pandoc`](https://pandoc.org/):