mode для емакса такой написать просто, но не вижу применения - будет лишь загрязняться исходник.

В больших проектах везде используется doxygen, а там прикрепляется картинка без проблем одной строкой в комментарии.

ты ещё HTML5 с разметкой, видяшками и анимированными смайликами в качестве исходников программ захоти

В 2050 сорцы будут не в плейнтексте, а в виде наглядых приложух на электроне.

Кодь в MS Word, там так можно.

В 2050 сорцы будут не в плейнтексте, а в виде наглядых приложух на 1Се.

obv fix

Для таких вещей в сложных проектах используется отдельный архитектурный софт. Пихать структуру проекта в код — странное желание.

Попробую зайти с другой стороны и предложить вам найти хороший редактор ASCII-графики, чтобы подобные диаграммы рисовались быстро и удобно.

mode для емакса такой написать просто, но не вижу применения - будет лишь загрязняться исходник.

Так давно уже https://www.emacswiki.org/emacs/ArtistMode

Идея не моя а коллеги

Да-да, мы тебе верим.

но кажется очень здравой

Ну пишите код в Markdown, чо. Или в HTML5, там не только картинки вставлять можно. Компиляться уже не будет, но разве это проблема?

ОП хочет растровые цветные имги вставлять.

Вроде видел такое в BlackBox оберона, для нормальных языков - я хз есть ли такое

няшно

http://www.inr.ac.ru/~info21/blackbox/kabarda.png

Школьное... Черепашка... Дзыгъуэ...

Что это?!

В IDE от JetBrains есть удобная подсказка по файлам ресурсов изображений:

https://exlmoto.ru/wp-content/Images/comments/gish2.png

Но чтобы прямо такое, как ты хочешь, такого я ещё нигде не видел.

Doxygen же!

Произвольные картинки цепляются, как сказали, одной строчкой. Еще можно диаграмки рисовать в формате graphviz.

Альтернативно можно конвертировать картинки в ASCII крафику - см. тулы на основе aalib, libcaca.

Ему нужно прямо в редакторе.

Нам нужна плашка для шок-контента.

NSFW

http://www.inr.ac.ru/~info21/software.htm

чёрт из знает :/

http://www.inr.ac.ru/~info21/software.htm

ЗЫ щас подумал - вот бы одинэсникам закинуть вирус который бы им всё в такое превращал. было бы эпично.

Чего-то много завелось любителей странного. Как бы их не стало больше, чем любителей нормального, тогда конец мировой цивилизации.

То, чего вы хотите, слава богу, никто не запрограммировал. Но есть способ - использовать систему контроля версий. В ней наряду с файлами программного кода можно сохранять файлы документации В частности картинки. Систему контроля версий в любом случае надо использовать.

Хочется что бы можно было легким движением руки прицепить в код картинку (нарисованную на планшете или еще откуда взятую), и при работе с кодом что бы эта картинка висела рядом с заданной строчкой прямо в редакторе кода.

В том смысле, чтобы *графическая* картинка висела в коде?

man UML и средства для работы с ним.

А как же системы документирования, вроде Doxygen? А в Java, говорят, вообще в стандарт впихнули документирование.

В Javadoc можно вставлять теги img

/**
 * <img src="/tmp/img.png"/>
 */
public class Test123 {
    public static void main(String[] args) throws Exception {

    }
}

Если в Идее показать коммент по Ctrl+Q, то картинка подхватится.

Пути, конечно, лучше относительные, но только что проверил с абсолютным, работает.

Учат кабардинских детей искусству программизма на их родной мове, очевидно же.

Чтобы картинка прямо висела, так в режиме css/html слева от строк-картинок есть иконка, наведешься - покажет превью, плюс вот такие лабутены есть

https://intellij-support.jetbrains.com/hc/en-us/community/posts/207029945-How...

(первый коммент)

Можно парсить markdown, доставать из него секции кода и компилировать их.

Документация к коду не должна расползаться на тему архитектурных решений всего проекта, это не ее задача. Комментарий к функции должен говорить что эта функция дклает, а не зачем она это делает.

Для общих рассуждений есть UML, о котором я уже написал.

А комментарий к классу? К модулю?

Да, ради картиночек в коде городить сраный комбайн-парсер! Отличная мысль, так держать!

в emacs есть плагин для рисования ASCII

Это уже будут не просто к картиночкам. Тут вообще все переварачивается. Была документация к коду, а будет код к документации. Возможно, это даже улучшит качество документаций к ПО.

В IDEA показывает картинки для документации методов RxJava, как оно там под капотом реализовано, честно, не вникал.
https://ibb.co/bTc17f

Возможно, это даже улучшит качество документаций к ПО.

Код был говном, станет ещё хуже.

Сейчас можно глянуть в код и понять, что оно делает (хотя бы в теории). Потом в коде будет магия, а в документации — вода.

https://orgmode.org/worg/org-contrib/babel/intro.html#literate-programming

Я в курсе:-) Но там картинки вроде как низя.

Расскажите об этом Дональду нашему Кнуту.

Вообще говоря комменты должны говорить ещё КАК она это делает.

Таки да.

UML вообще про другое. Речь не идёт о структуре классов и пр. - речь идёт именно об иллюстрации конкретных решений в конкретной строке кода. Я хз чё там в продакшене, у нас в число дробилках этого очень не хватает.

Спасибо кэп, мы таки сидим под гитом. И если последовать Вашему совету, то картинок будет на порядок больше чем файлов с кодом - запаришься искать.

Можно конечно вести документация в техе, или там вешать ссылки на картиночки в комментах и научить дохиджен их вставлять в то чё он генерит, это возможно самый простой сейчас путь. Но прямо в редакторе было бы гораздо удобнее...

Насчёт ненужно очень спорно, но с дохидженом вообще мысль мне нравится - это наверное самое простое решение. Спасибо.

M-x org-display-inline-images

Не, это изврат от бедности. Такой графики не хватает, нам ещё формулы втыкать обычно надо...

Внезапно можно код вставлять прямо в документацию на LaTeX. В результате у тебя есть файлик, из которого можно скомпилировать как сырцы, так и красивую PDF.

Был какой-то уеб-сервис, позволяющий мышкой рисовать диаграммы и рендерить в ascii-графику

Или вставлять латех в код и рендереть доксидженом

PlantUML плагин, например. У эклипса на яве так можно.

Во-первых, апеллирование к авторитету выставляет тебя школотой потноладошечной.

Во-вторых, давно все рассказали, специально для тебя — пересказ на русском.