blocks|key|171986|text|对于那些仍然想知道如何在APT中编写代码的人：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|171987|+++++This+is+regular+text
%2B---------------------
This+is+a+code+snippet
%2B---------------------
++++++More+regular+text|code-block|syntax|javascript|171988|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

For those who are still wondering how to make a code snipped in APT:

<pre><code> This is regular text
+---------------------
This is a code snippet
+---------------------
 More regular text
</code></pre>

blocks|key|3952437|text|Apache+Maven+Fluido皮肤突出显示了开箱即用的语法。Here你可以找到一个例子。关于Fluido中语法突出显示的信息:Fluido网站上的“源代码部分由Google+code+Prettify增强，用户可以选择启用行号渲染(默认情况下禁用)”。|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|3952438|entityMap|0|LINK|mutability|MUTABLE|url|http://maven.apache.org/skins/maven-fluido-skin/|1|http://logging.apache.org/log4j/2.x/manual/markers.html^0|0|J|0|Y|4|1|0^^$0|@$1|2|3|4|5|6|7|N|8|@]|9|@$A|O|B|P|1|Q]|$A|R|B|S|1|T]]|C|$]]|$1|D|3|-4|5|6|7|U|8|@]|9|@]|C|$]]]|E|$F|$5|G|H|I|C|$J|K]]|L|$5|G|H|I|C|$J|M]]]]

<a href="http://maven.apache.org/skins/maven-fluido-skin/" rel="nofollow">Apache Maven Fluido</a> Skin highlights syntax out of the box. <a href="http://logging.apache.org/log4j/2.x/manual/markers.html" rel="nofollow">Here</a> you can find an example. Information about syntax highlighting in Fluido: "Source code sections are enhanced by Google Code Prettify, users can optionally enable line numbers rendering (disabled by default)" from Fluido website.

blocks|key|3952474|text|这个|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3952475|%2B---------------------
code
%2B---------------------|code-block|syntax|javascript|3952476|语法正确。正如其他人所提到的，Fluido确实强调了开箱即用的Prettify。|offset|length|3952477|然而，Doxia在Site+Plugin+3.3中的一个改变打破了Fluido。MSKINS-86修复了这个问题，但是还没有发布。|3952478|变通方法|3952479|3952480|使用site.xml+workaround+<body>+++<head>+++++<script+type="text/javascript">+++++++$(document).ready(function+()+{+++++++++$("div.source+pre").addClass("prettyprint");+++++++++prettyPrint();+++++++});+++++</script>+++</head>+</body>+|ordered-list-item|style|CODE|3952481|Use+Site+Plugin+3.2|3952482|构建包含MSKINS-86修复程序的未发布的Fluido+1.4，并使用它代替1.3.1|3952483|3952484|entityMap|0|LINK|mutability|MUTABLE|url|https://github.com/google/code-prettify|1|https://issues.apache.org/jira/browse/MSKINS-86|2|https://plus.google.com/116267359728910593612/posts/8MQM8Y4CTeu^0|0|0|V|8|0|0|14|9|1|0|0|0|M|5R|B|A|2|0|0|0|0^^$0|@$1|2|3|4|5|6|7|1B|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|1C|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|1D|8|@]|9|@$I|1E|J|1F|1|1G]]|A|$]]|$1|K|3|L|5|6|7|1H|8|@]|9|@$I|1I|J|1J|1|1K]]|A|$]]|$1|M|3|N|5|6|7|1L|8|@]|9|@]|A|$]]|$1|O|3|-4|5|6|7|1M|8|@]|9|@]|A|$]]|$1|P|3|Q|5|R|7|1N|8|@$I|1O|J|1P|S|T]]|9|@$I|1Q|J|1R|1|1S]]|A|$]]|$1|U|3|V|5|R|7|1T|8|@]|9|@]|A|$]]|$1|W|3|X|5|R|7|1U|8|@]|9|@]|A|$]]|$1|Y|3|-4|5|6|7|1V|8|@]|9|@]|A|$]]|$1|Z|3|-4|5|6|7|1W|8|@]|9|@]|A|$]]]|10|$11|$5|12|13|14|A|$15|16]]|17|$5|12|13|14|A|$15|18]]|19|$5|12|13|14|A|$15|1A]]]]

The

<pre><code>+---------------------
code
+---------------------
</code></pre>

syntax is correct. And Fluido does highlight using <a href="https://github.com/google/code-prettify" rel="nofollow">Prettify</a> out of the box as others have mentioned.

However, a Doxia change in Site Plugin 3.3 broke Fluido. <a href="https://issues.apache.org/jira/browse/MSKINS-86" rel="nofollow">MSKINS-86</a> fixes this, but hasn't been released yet.

Workarounds

<ol>
<li>Use the site.xml <a href="https://plus.google.com/116267359728910593612/posts/8MQM8Y4CTeu" rel="nofollow">workaround</a>
<code>
&lt;body&gt;
 &lt;head&gt;
 &lt;script type="text/javascript"&gt;
 $(document).ready(function () {
 $("div.source pre").addClass("prettyprint");
 prettyPrint();
 });
 &lt;/script&gt;
 &lt;/head&gt;
&lt;/body&gt;
</code></li>
<li>Use Site Plugin 3.2</li>
<li>Build the unreleased Fluido 1.4 that contains MSKINS-86 fix and use it instead of 1.3.1</li>
</ol>

blocks|key|2590855|text|我最终使用了Doxia+Macros+Guide：http://maven.apache.org/doxia/macros/index.html#Snippet_Macro中的代码片段宏|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|2590856|它将代码片段文件中的代码放入一个逐字逐句的框中。但是，它不提供语法高亮显示。|2590857|entityMap|0|LINK|mutability|MUTABLE|url|http://maven.apache.org/doxia/macros/index.html#Snippet_Macro^0|P|1P|0|0|0^^$0|@$1|2|3|4|5|6|7|N|8|@]|9|@$A|O|B|P|1|Q]]|C|$]]|$1|D|3|E|5|6|7|R|8|@]|9|@]|C|$]]|$1|F|3|-4|5|6|7|S|8|@]|9|@]|C|$]]]|G|$H|$5|I|J|K|C|$L|M]]]]

I ended up using the snippet macro from the Doxia Macros Guide: <a href="http://maven.apache.org/doxia/macros/index.html#Snippet_Macro" rel="nofollow">http://maven.apache.org/doxia/macros/index.html#Snippet_Macro</a>

It puts the code from the snippet file in a verbatim box. However it does not provide a syntax highlightning.

blocks|key|3952414|text|doxia+include宏的1.0版本不在maven+central，但是以下版本是：http://mvnrepository.com/artifact/org.tinyjee.dim/doxia-include-macro|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|3952415|entityMap|0|LINK|mutability|MUTABLE|url|http://mvnrepository.com/artifact/org.tinyjee.dim/doxia-include-macro^0|18|1X|0|0^^$0|@$1|2|3|4|5|6|7|L|8|@]|9|@$A|M|B|N|1|O]]|C|$]]|$1|D|3|-4|5|6|7|P|8|@]|9|@]|C|$]]]|E|$F|$5|G|H|I|C|$J|K]]]]

Version 1.0 of doxia include macro is not at maven central however the following versions are:
<a href="http://mvnrepository.com/artifact/org.tinyjee.dim/doxia-include-macro" rel="nofollow">http://mvnrepository.com/artifact/org.tinyjee.dim/doxia-include-macro</a>

I am currently starting to write a documentation for one of our projects. For reasons of simplicity we chose to use the Almost Plain Text (APT) Format, see more info here: 
<a href="http://maven.apache.org/doxia/references/apt-format.html" rel="noreferrer">http://maven.apache.org/doxia/references/apt-format.html</a>

APT is great documentation format, since it uses a minimal syntax and hence it is very easy to create and make changes to the documentation without knowing a lot about APT. 

However, I couldn't find a way to format code in a nice way. Is there a code tag or similar, which can be used to include some source code? I'm aware I could use FML, but this would be less desirable.

Thanks

Format code in Doxia Apt Format

翻译质量差，导致语言生硬或混乱。

没有提供实际的解决方法或示例。

解答不清晰，无法理解或解决问题。

页面排版不美观，阅读体验差。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

我现在开始为我们的一个项目写文档。为简单起见，我们选择使用几乎纯文本(APT)格式，请在此处查看更多信息：APT是一种很好的文档格式，因为它使用了最少的语法，因此在不了解APT的情况下很容易创建和更改文档。然而，我找不到一种很好的方法来格式化代码。有没有代码标签或类似的标签，可以用来包含一些源代码？我知道我可以使用FML，但这不太可取。谢谢

问Doxia Apt格式的格式代码
EN

回答 5

Stack Overflow用户

Stack Overflow用户

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问Doxia Apt格式的格式代码EN

回答 5

Stack Overflow用户

Stack Overflow用户

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问Doxia Apt格式的格式代码
EN