Синтаксическая подсветка HTML со ссылками
Существует ли инструмент, который конвертировал бы приведенные источники в HTML со ссылками?
Под ссылками я имею в виду, что каждый используемый тип, класс и метод будут указывать через href на его определение.
Мне не удалось заставить подсветку, подсветку синтаксиса и фрагменты работать таким образом. Даже если он поддерживает ввод из ctags, он добавляет только атрибут title, но не ссылки.
2 ответа
Подсветка может быть легко изменена для поддержки таких вещей, как добавление ссылок на определения функций / классов, а также ввод записей вручную.
Я смог подключиться к обнаружению классов и функций, и каждый экземпляр связывался с Руководством по PHP в моем тестировании. Я не знаю, на что вы хотите, чтобы ваши ссылки ссылались, так что это ваш выбор (конечно, для каждого языка).
В зависимости от языка вашего исходного кода вы можете использовать DOxygen. Он поддерживает множество исходных языков и может экспортировать комментарии в HTML и LaTeX.
Многие современные языки, такие как Java или C#, поддерживают XML-комментарии для документирования исходного кода. Затем вы можете извлечь эти комментарии в один файл XML, скомпилировав их со специальными параметрами. Из этого XML вы можете легко создать HTML, добавив соответствующий лист CSS. Например, документация MSDN в значительной степени основана на этих файлах HTML, созданных в автоматическом режиме.