V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
yangyaofei
V2EX  ›  Java

在 Javadoc 中如何应用 markdown 或者类似的文本标记语法

  •  
  •   yangyaofei ·
    yangyaofei · 2021-05-11 14:33:55 +08:00 · 1133 次点击
    这是一个创建于 1053 天前的主题,其中的信息可能已经有所发展或是发生改变。

    以前一直在写 Python, 用 sphinx 写文档, 加个示例代码, 高亮标记, 加粗什么章节什么的都比较容易,也很简单

    最近有写东西要用 java 写, 发现 javadoc 只有部分 html 标签可以用,自带的 tag 也不是很好用.

    在 github 中找到了一个 https://github.com/Abnaxos/markdown-doclet ,可以用, 但是已经很久没 更新了,引入到 gradle 里面也各种错误(java 新手,gradle 玩不溜, 上次写 java 还是 SSH 时代).

    所以请问,有什么比较好的解决方案么,在代码里面手写 html 还有转义字符什么的实在是难以称之为好的 代码体验,java 都这么多年了,不应该都直接文档手敲纯文本文本,偶尔加点 html 标签吧

    目前尚无回复
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5286 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 08:15 · PVG 16:15 · LAX 01:15 · JFK 04:15
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.