Failed to execute the [include] macro when i used ukranian language

Hello. I have a problem.
I am using xwiki with two languages English and Ukrainian. Using the example of an automatically created XWiki space that has a page “XWiki Syntax Guide”, I will demonstrate the error.
If I set the English language, I can view this page without any problems (see the screenshot)
image

But when the Ukrainian language is set, I see only errors on this page
image

Can you tell me how I can fix it?

> org.xwiki.rendering.macro.MacroExecutionException: Cannot find section [H2.1Introduction] in document [xwiki:XWiki.XWikiSyntaxIntroduction]
>  at org.xwiki.rendering.internal.macro.include.IncludeMacro.execute(IncludeMacro.java:157)
>  at org.xwiki.rendering.internal.macro.include.IncludeMacro.execute(IncludeMacro.java:59)
>  at org.xwiki.rendering.internal.transformation.macro.MacroTransformation.transform(MacroTransformation.java:311)
>  at org.xwiki.rendering.internal.transformation.DefaultRenderingContext.transformInContext(DefaultRenderingContext.java:183)
>  at org.xwiki.rendering.internal.transformation.DefaultTransformationManager.performTransformations(DefaultTransformationManager.java:88)
>  at org.xwiki.display.internal.DocumentContentAsyncExecutor.executeInCurrentExecutionContext(DocumentContentAsyncExecutor.java:395)
>  at org.xwiki.display.internal.DocumentContentAsyncExecutor.execute(DocumentContentAsyncExecutor.java:268)
>  at org.xwiki.display.internal.DocumentContentAsyncRenderer.execute(DocumentContentAsyncRenderer.java:112)
>  at org.xwiki.rendering.async.internal.block.AbstractBlockAsyncRenderer.render(AbstractBlockAsyncRenderer.java:157)
>  at org.xwiki.rendering.async.internal.block.AbstractBlockAsyncRenderer.render(AbstractBlockAsyncRenderer.java:54)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.syncRender(DefaultAsyncRendererExecutor.java:290)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.render(DefaultAsyncRendererExecutor.java:267)
>  at org.xwiki.rendering.async.internal.block.DefaultBlockAsyncRendererExecutor.execute(DefaultBlockAsyncRendererExecutor.java:125)
>  at org.xwiki.display.internal.DocumentContentDisplayer.display(DocumentContentDisplayer.java:67)
>  at org.xwiki.display.internal.DocumentContentDisplayer.display(DocumentContentDisplayer.java:43)
>  at org.xwiki.display.internal.DefaultDocumentDisplayer.display(DefaultDocumentDisplayer.java:96)
>  at org.xwiki.display.internal.DefaultDocumentDisplayer.display(DefaultDocumentDisplayer.java:39)
>  at org.xwiki.sheet.internal.SheetDocumentDisplayer.display(SheetDocumentDisplayer.java:123)
>  at org.xwiki.sheet.internal.SheetDocumentDisplayer.display(SheetDocumentDisplayer.java:52)
>  at org.xwiki.display.internal.ConfiguredDocumentDisplayer.display(ConfiguredDocumentDisplayer.java:68)
>  at org.xwiki.display.internal.ConfiguredDocumentDisplayer.display(ConfiguredDocumentDisplayer.java:42)
>  at com.xpn.xwiki.doc.XWikiDocument.display(XWikiDocument.java:1366)
>  at com.xpn.xwiki.doc.XWikiDocument.getRenderedContent(XWikiDocument.java:1503)
>  at com.xpn.xwiki.doc.XWikiDocument.displayDocument(XWikiDocument.java:1452)
>  at com.xpn.xwiki.doc.XWikiDocument.displayDocument(XWikiDocument.java:1421)
>  at com.xpn.xwiki.api.Document.displayDocument(Document.java:787)
>  at jdk.internal.reflect.GeneratedMethodAccessor810.invoke(Unknown Source)
>  at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
>  at java.base/java.lang.reflect.Method.invoke(Method.java:568)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.doInvoke(UberspectImpl.java:571)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.invoke(UberspectImpl.java:554)
>  at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:221)
>  at org.apache.velocity.runtime.parser.node.ASTReference.execute(ASTReference.java:368)
>  at org.apache.velocity.runtime.parser.node.ASTReference.value(ASTReference.java:704)
>  at org.apache.velocity.runtime.parser.node.ASTExpression.value(ASTExpression.java:75)
>  at org.apache.velocity.runtime.parser.node.ASTSetDirective.render(ASTSetDirective.java:242)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:439)
>  at org.apache.velocity.runtime.parser.node.ASTIfStatement.render(ASTIfStatement.java:190)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.xwiki.velocity.internal.directive.TryCatchDirective.render(TryCatchDirective.java:86)
>  at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:304)
>  at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:439)
>  at org.apache.velocity.Template.merge(Template.java:358)
>  at org.apache.velocity.Template.merge(Template.java:262)
>  at org.xwiki.velocity.internal.InternalVelocityEngine.evaluate(InternalVelocityEngine.java:225)
>  at com.xpn.xwiki.internal.template.VelocityTemplateEvaluator.evaluateContent(VelocityTemplateEvaluator.java:105)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.evaluateContent(TemplateAsyncRenderer.java:219)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.renderVelocity(TemplateAsyncRenderer.java:174)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:135)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:54)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.lambda$syncRender$0(DefaultAsyncRendererExecutor.java:284)
>  at com.xpn.xwiki.internal.security.authorization.DefaultAuthorExecutor.call(DefaultAuthorExecutor.java:98)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.syncRender(DefaultAsyncRendererExecutor.java:284)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.render(DefaultAsyncRendererExecutor.java:267)
>  at org.xwiki.rendering.async.internal.block.DefaultBlockAsyncRendererExecutor.render(DefaultBlockAsyncRendererExecutor.java:154)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:904)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderFromSkin(InternalTemplateManager.java:866)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:853)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderNoException(InternalTemplateManager.java:808)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderNoException(InternalTemplateManager.java:800)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.renderNoException(DefaultTemplateManager.java:79)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.renderNoException(DefaultTemplateManager.java:73)
>  at org.xwiki.template.script.TemplateScriptService.render(TemplateScriptService.java:54)
>  at jdk.internal.reflect.GeneratedMethodAccessor244.invoke(Unknown Source)
>  at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
>  at java.base/java.lang.reflect.Method.invoke(Method.java:568)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.doInvoke(UberspectImpl.java:571)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.invoke(UberspectImpl.java:554)
>  at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:221)
>  at org.apache.velocity.runtime.parser.node.ASTReference.execute(ASTReference.java:368)
>  at org.apache.velocity.runtime.parser.node.ASTReference.render(ASTReference.java:492)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.apache.velocity.runtime.directive.VelocimacroProxy.render(VelocimacroProxy.java:218)
>  at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:331)
>  at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:261)
>  at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:304)
>  at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:439)
>  at org.apache.velocity.Template.merge(Template.java:358)
>  at org.apache.velocity.Template.merge(Template.java:262)
>  at org.xwiki.velocity.internal.InternalVelocityEngine.evaluate(InternalVelocityEngine.java:225)
>  at com.xpn.xwiki.internal.template.VelocityTemplateEvaluator.evaluateContent(VelocityTemplateEvaluator.java:105)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.evaluateContent(TemplateAsyncRenderer.java:219)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.renderVelocity(TemplateAsyncRenderer.java:174)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:135)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:54)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.lambda$syncRender$0(DefaultAsyncRendererExecutor.java:284)
>  at com.xpn.xwiki.internal.security.authorization.DefaultAuthorExecutor.call(DefaultAuthorExecutor.java:98)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.syncRender(DefaultAsyncRendererExecutor.java:284)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.render(DefaultAsyncRendererExecutor.java:267)
>  at org.xwiki.rendering.async.internal.block.DefaultBlockAsyncRendererExecutor.render(DefaultBlockAsyncRendererExecutor.java:154)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:904)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderFromSkin(InternalTemplateManager.java:866)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:853)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderNoException(InternalTemplateManager.java:808)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderNoException(InternalTemplateManager.java:800)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.renderNoException(DefaultTemplateManager.java:79)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.renderNoException(DefaultTemplateManager.java:73)
>  at org.xwiki.template.script.TemplateScriptService.render(TemplateScriptService.java:54)
>  at jdk.internal.reflect.GeneratedMethodAccessor244.invoke(Unknown Source)
>  at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
>  at java.base/java.lang.reflect.Method.invoke(Method.java:568)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.doInvoke(UberspectImpl.java:571)
>  at org.apache.velocity.util.introspection.UberspectImpl$VelMethodImpl.invoke(UberspectImpl.java:554)
>  at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:221)
>  at org.apache.velocity.runtime.parser.node.ASTReference.execute(ASTReference.java:368)
>  at org.apache.velocity.runtime.parser.node.ASTReference.render(ASTReference.java:492)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.apache.velocity.runtime.directive.VelocimacroProxy.render(VelocimacroProxy.java:218)
>  at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:331)
>  at org.apache.velocity.runtime.directive.RuntimeMacro.render(RuntimeMacro.java:261)
>  at org.apache.velocity.runtime.parser.node.ASTDirective.render(ASTDirective.java:304)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.apache.velocity.runtime.parser.node.ASTIfStatement.render(ASTIfStatement.java:171)
>  at org.apache.velocity.runtime.parser.node.ASTBlock.render(ASTBlock.java:147)
>  at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:439)
>  at org.apache.velocity.runtime.parser.node.ASTIfStatement.render(ASTIfStatement.java:190)
>  at org.apache.velocity.runtime.parser.node.SimpleNode.render(SimpleNode.java:439)
>  at org.apache.velocity.Template.merge(Template.java:358)
>  at org.apache.velocity.Template.merge(Template.java:262)
>  at org.xwiki.velocity.internal.InternalVelocityEngine.evaluate(InternalVelocityEngine.java:225)
>  at com.xpn.xwiki.internal.template.VelocityTemplateEvaluator.evaluateContent(VelocityTemplateEvaluator.java:105)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.evaluateContent(TemplateAsyncRenderer.java:219)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.renderVelocity(TemplateAsyncRenderer.java:174)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:135)
>  at com.xpn.xwiki.internal.template.TemplateAsyncRenderer.render(TemplateAsyncRenderer.java:54)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.lambda$syncRender$0(DefaultAsyncRendererExecutor.java:284)
>  at com.xpn.xwiki.internal.security.authorization.DefaultAuthorExecutor.call(DefaultAuthorExecutor.java:98)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.syncRender(DefaultAsyncRendererExecutor.java:284)
>  at org.xwiki.rendering.async.internal.DefaultAsyncRendererExecutor.render(DefaultAsyncRendererExecutor.java:267)
>  at org.xwiki.rendering.async.internal.block.DefaultBlockAsyncRendererExecutor.render(DefaultBlockAsyncRendererExecutor.java:154)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:904)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderFromSkin(InternalTemplateManager.java:866)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.renderFromSkin(InternalTemplateManager.java:846)
>  at com.xpn.xwiki.internal.template.InternalTemplateManager.render(InternalTemplateManager.java:832)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.render(DefaultTemplateManager.java:91)
>  at com.xpn.xwiki.internal.template.DefaultTemplateManager.render(DefaultTemplateManager.java:85)
>  at com.xpn.xwiki.XWiki.evaluateTemplate(XWiki.java:2565)
>  at com.xpn.xwiki.web.Utils.parseTemplate(Utils.java:180)
>  at com.xpn.xwiki.web.XWikiAction.execute(XWikiAction.java:651)
>  at com.xpn.xwiki.web.XWikiAction.execute(XWikiAction.java:339)
>  at com.xpn.xwiki.web.LegacyActionServlet.service(LegacyActionServlet.java:108)
>  at javax.servlet.http.HttpServlet.service(HttpServlet.java:623)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:209)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at com.xpn.xwiki.web.ActionFilter.doFilter(ActionFilter.java:122)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.xwiki.wysiwyg.filter.ConversionFilter.doFilter(ConversionFilter.java:61)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:51)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.xwiki.container.servlet.filters.internal.SetHTTPHeaderFilter.doFilter(SetHTTPHeaderFilter.java:63)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.xwiki.resource.servlet.RoutingFilter.doFilter(RoutingFilter.java:132)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.xwiki.container.servlet.filters.internal.SavedRequestRestorerFilter.doFilter(SavedRequestRestorerFilter.java:208)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.xwiki.container.servlet.filters.internal.SetCharacterEncodingFilter.doFilter(SetCharacterEncodingFilter.java:111)
>  at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:178)
>  at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:153)
>  at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:168)
>  at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:90)
>  at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:481)
>  at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:130)
>  at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:93)
>  at org.apache.catalina.valves.AbstractAccessLogValve.invoke(AbstractAccessLogValve.java:670)
>  at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:74)
>  at org.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:765)
>  at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:342)
>  at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:390)
>  at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:63)
>  at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:928)
>  at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1794)
>  at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:52)
>  at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191)
>  at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659)
>  at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
>  at java.base/java.lang.Thread.run(Thread.java:840)
> Caused by: java.lang.RuntimeException: Cannot find section [H2.1Introduction] in document [xwiki:XWiki.XWikiSyntaxIntroduction]
>  at org.xwiki.display.internal.DocumentContentAsyncExecutor.getContent(DocumentContentAsyncExecutor.java:144)
>  at org.xwiki.display.internal.DocumentContentAsyncExecutor.initialize(DocumentContentAsyncExecutor.java:119)
>  at org.xwiki.display.internal.DocumentContentAsyncRenderer.initialize(DocumentContentAsyncRenderer.java:101)
>  at org.xwiki.display.internal.DocumentContentDisplayer.display(DocumentContentDisplayer.java:59)
>  at org.xwiki.display.internal.DocumentContentDisplayer.display(DocumentContentDisplayer.java:43)
>  at org.xwiki.display.internal.DefaultDocumentDisplayer.display(DefaultDocumentDisplayer.java:96)
>  at org.xwiki.display.internal.DefaultDocumentDisplayer.display(DefaultDocumentDisplayer.java:39)
>  at org.xwiki.sheet.internal.SheetDocumentDisplayer.display(SheetDocumentDisplayer.java:123)
>  at org.xwiki.sheet.internal.SheetDocumentDisplayer.display(SheetDocumentDisplayer.java:52)
>  at org.xwiki.display.internal.ConfiguredDocumentDisplayer.display(ConfiguredDocumentDisplayer.java:68)
>  at org.xwiki.display.internal.ConfiguredDocumentDisplayer.display(ConfiguredDocumentDisplayer.java:42)
>  at org.xwiki.rendering.internal.macro.include.IncludeMacro.execute(IncludeMacro.java:155)
>  ... 183 more

Looks like there is something wrong in the Ukrainian translation for the page XWikiSyntaxIntroduction. It’s far from obvious but the section title (the things between all the ===) are actually identifiers that should not be translated, but unfortunately it looks like it was.

You can fix that in your instance by editing the page XWiki.XWikiSyntaxIntroduction (so a URL that looks like https://mydomain/xwiki/bin/edit/XWiki/XWikiSyntaxIntroduction) and it would be great if you could fix it on the reference translation when you have something that works well for you.

Thank you for your response.
The page has the correct address, in Latin characters.

image

I also have a Character Replacement Strategy Configuration that prevents Cyrillic characters from getting into the page address.
image

So I also know Russian language and decided to check how it works with Russian, but this page is not translated into Russian and everything is displayed correctly.
Now I understand this problem.
But now I wonder if I will have any problems when composing my pages in Ukrainian using XWiki 2.1 syntax?

Hello @Shekel,
Many thanks for noticing this issue. I’ve fixed subheadings on l10n pages, my mistake was that I checked the translation on individual syntax pages. Updated translation versions should be included in the next version of XWiki.

Yes, currently, it’s the only way to manually provide character replacement on that page.

Only this improvement is reported Loading....