Question

我有一个使用HTML的Doxygen ALIAS代码（通过@htmlonly），为了显示youtube视频，我可以简单地写入（＆＃34; .markdown＆＃34;） - file：

Youtube Link：

https://www.youtube.com/watch?v=**CODE**

使用ALIAS：

@youtube{**CODE**}

没有ALIAS：

@htmlonly

<div align="center">
<iframe
    title="my title" width="560" height="349"
    src="http://www.youtube.com/embed/**CODE**?rel=0&loop=1"
    frameborder="0" allowfullscreen align="middle">
</iframe>
</div>

@endhtmlonly

将以下ALIAS添加到Doxyfile：

ALIASES               += youtube{1}="@htmlonly<div align='center'><iframe title='my title' width='560' height='349' src='http://www.youtube.com/embed/\1?rel=0&loop=1' frameborder='0' allowfullscreen align='middle'></iframe></div>@endhtmlonly"

我的问题是，从上面可以看到的宏是巨大，看起来真的是 CONFUSING ！

问题：

有没有办法让它看起来干净？
如何处理更大的HTML原始代码？
我应该使用ALIAS的任何其他Doxygen替代品吗？

Answer 1

我设法搞清楚了。

而不是：

ALIASES               += youtube{1}="@htmlonly<div align='center'><iframe title='my title' width='560' height='349' src='http://www.youtube.com/embed/\1?rel=0&loop=1' frameborder='0' allowfullscreen align='middle'></iframe></div>@endhtmlonly"

我可以使用：

@youtube {link}，附：

ALIASES+=addyoutube{1}="@htmlonly</p><div class='addYoutube'>\1</div>@endhtmlonly"
ALIASES+=youtube{1}="@addyoutube{\1} @htmlinclude add_youtube.html"

EXAMPLE_PATH          += @CMAKE_CURRENT_SOURCE_DIR@/add_youtube.html

并在当前目录add_youtube.html：

的文件中添加以下javascript代码

<script type="text/javascript">

var $getDiv = $('div.addYoutube').last();

var filmId = $getDiv.html()
filmId = filmId.replace("https://","")
filmId = filmId.replace("www.","")
filmId = filmId.replace("youtube.com/watch?v=","")

document.write("<div align='center'><iframe title='my title' width='560' height='349' src='http://www.youtube.com/embed/"+filmId+"?rel=0&loop=1' frameborder='0' allowfullscreen align='middle'> </iframe> </div>");
$getDiv.remove()
</script>

Answer 2

参加聚会有点晚了，但是在Doxygen 1.8.12中，可以创建doxygen标签@brief和HTML元素的某种组合。
为HTML元素定义属性时，可以使用撇号class='someClass'，也可以将引号与反斜杠class=\"someClass\"一起使用。
要缩进html，请使用带有反斜杠符号\的字符串conconconnation。

ALIASES +=               "briefWithImage{3} = @brief \
                            @htmlonly \
                                <span><img class='imgBriefImage' src='\1' alt='\1'></span> \
                                </span><span class='spanBriefText'>\2(<b>\3</b>)</span> \
                            @endhtmlonly"

我不确定别名的替代方法。一种方法是为每个页面以及页面加载时定义自定义HTML标头-使用自定义JS函数替换您自己的占位符。

使用HTML制作干净的Doxygen ALIAS

2 个答案: