#ruby #documentation #markdown
#ruby #Документация #markdown
Вопрос:
Я написал руководства для некоторых драгоценных камней Ruby, которые я написал. Он находится в текстовом документе markdown (Kramdown). Для обеспечения целостности исходного кода в руководствах по мере продолжения разработки драгоценных камней я хочу извлечь исходный код из учебного документа и запустить test, чтобы убедиться, что код правильный и рабочий. Прежде чем изобретать велосипед, я искал, но ничего не нашел по проблеме такого рода. Есть ли какое-либо программное обеспечение, которое может помочь мне решить мою проблему? Программное обеспечение Ruby было бы классным, но я не разбираюсь в языке. Я уверен, что не могу быть первым человеком, столкнувшимся с этой проблемой.
Другой вариант заключается в том, чтобы в документах руководства были только заполнители мест, а все файлы располагались извне, после чего документ заполнялся перед публикацией. Это означало бы намного больше свободных файлов, но было бы значительно проще в реализации.
Ответ №1:
Режим организации в emacs может это сделать, но это означает, что вы не можете писать в Markdown.
Ответ №2:
Вам нужно что-то вроде Ruby DocTest?