Javascript фрагмент за конвертиране на коментар в стил doxygen в HTML

Във връзка с този въпрос се чудех дали някой знае ли кодов фрагмент/библиотека на javascript за преобразуване на един коментар на doxygen в HTML?

Например,

/** This is a comment block
 *
 * \b bold text
 * \i italic text
 */

ще се преобразува в нещо като:

<p>This is a comment block</p>
<p><b>bold</b> text</p>
<p><i>italic</i> text</p>

Подобно за всички други тагове, свързани с форматиране на doxygen.

Вече намерих това, което изглежда е добра отправна точка, ако трябва да го внедря сам, но е възможно да ми липсва цялостен проект :-)

Така че, предложенията са добре дошли!


person Tobi    schedule 07.06.2009    source източник


Отговори (1)


Използването на съществуващ инструмент/кодова база, който прави поне част от това, което искате, е най-добрият ви залог. Разборът не е лесен проблем, особено намирането на doxygen коментари в кода, особено ако работите с няколко езика. Бързо търсене не откри ужасно очевидни проекти, но ако желаете да създадете свой собствен, ако е необходимо, бих предложил да започнете със самата кодова база на doxygen. Той е с отворен код и е достъпен чрез SVN или директно изтегляне. Имайте предвид, че doxygen е написан на C++, но ако можете да следвате действията на анализатора (може би само за конкретен език), това може да ви спести тонове работа и да предотврати липсващи ъглови случаи и т.н. Всичко зависи от това колко надежден искате вашият решение, което ще бъде, и дали ще го използвате само вие или ако в крайна сметка може да го поддържате за други. Късмет!

person Quinn Taylor    schedule 14.06.2009
comment
doxygen вече е в git (вижте doxygen.nl/download.html#gitrepos) - person albert; 24.12.2018