Библиографические цитаты в ScalaDoc
Несколько инструментов документирования поддерживают создание библиографий и маркеров цитирования. Например, построитель файлов справки Sandcastle позволяет определить <reference>и ссылаясь на них <cite> MAML теги. R Markdown поддерживает множество форматов библиографии, включая BibTeX, и учитывает стили цитирования при экспорте PDF-файлов с помощью Pandoc.
Есть ли способ разместить ссылки в комментариях Scaladoc? Лучшее, о чем я мог подумать, это включить запись BibTeX как дословно {{{ }}} код, который хорошо, когда класс или метод основан на одной статье. Однако ссылаться на конкретные страницы или рисунки (т. Е. Этот метод реализует псевдокод из с.26, рис. 3.a того-то) неудобно в этом смысле. Я бы очень предпочел один файл.bib на проект и \cite теги.