From af8b867079353fedb31763b319ac5aec6083a19f Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Fri, 7 Aug 2026 11:57:23 +0200 Subject: [PATCH] Drop backslash escapes that Markdown does not need Pages converted from APT with an older doxia-converter carry an escape in front of punctuation that is not markup where it stands: a hyphen or underscore inside a word, a parenthesis, a full stop after a letter. The backslash renders as nothing and only makes the source harder to read and to edit. Only positions where the bare character can never be markup are touched. A full stop after a digit keeps its escape, so an ordered list marker cannot appear by accident, and angle brackets keep theirs, since would otherwise be read as a tag. Code spans, fenced blocks and link destinations are left alone. --- src/site/markdown/examples/filter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/site/markdown/examples/filter.md b/src/site/markdown/examples/filter.md index c0f517c..240ae5d 100644 --- a/src/site/markdown/examples/filter.md +++ b/src/site/markdown/examples/filter.md @@ -147,7 +147,7 @@ and adding that to our POM ``` -**Warning:** Do not filter files with binary content like images\! This will most likely result in corrupt output. +**Warning:** Do not filter files with binary content like images! This will most likely result in corrupt output. If you have both text files and binary files as resources, it is recommended to have two separated folders: one folder `src/main/resources` (default) for the resources which are not filtered and another folder `src/main/resources-filtered` for the resources which are filtered.