这是一个创建于 874 天前的主题，其中的信息可能已经有所发展或是发生改变。
最近天天坐着写代码，有时候枯燥又烦躁，有些部分写起来比较绕脑，心想如果在旁边能够附上一张手绘的流程图就好了，用文字很多东西都表述不清楚，下次回看代码的时候又要理解半天，如果能够在旁边放一张图片，辅助文字那很多难以理解的逻辑一目了然就清楚了。为啥程序语言发展这么久，就没有出现过一款支持这种想法的产品呢？
 |
1
liyang5945 2022-07-01 23:43:01 +08:00
有没有可能这个东西叫文档
|
 |
2
wdc63 OP @liyang5945 文档和源码还是不一样啊，而且支持图片的文档也没法直接从源代码生成吧，还要自己来写或者多花很多额外时间去编辑生成，也太麻烦了。
|
 |
3
clf 2022-07-01 23:47:48 +08:00
为什么要往文本里塞图片和音频……源代码用啥存储？？？做成 word 、ppt 、excel 的那种形式么。
真要图片和音视频文档很简单，自己注释里贴个 URL 。 另外就如#1 所说，你说的是不是叫做文档…… |
 |
4
XiLingHost 2022-07-01 23:55:55 +08:00
富文本你怎么做版本控制
|
 |
5
llh880808 2022-07-01 23:59:48 +08:00  12
为什么不在每段代码嵌入一段可交互的 VR ，让作者给我当面解释当时干嘛要这么写
最好把产品经理提需求的会议实时录像也嵌入进去 |
 |
6
haolongsun 2022-07-02 00:05:48 +08:00
富文本还要加个解析库，从语言上来说不可能加的，纯纯浪费时间和空间，还要去兼容 IDE ，不值得，IDE 也不可能去实现，全是图片卡的要死，并且图片会造成注意力不集中。
不过可以用 markdown 的形式来注释，并且还能一键生成文档，在注释里加入单元测试。rust 就是这样干的。 |
 |
7
stein42 2022-07-02 00:06:18 +08:00
用 markdown 写注释，markdown 可以引用图片，再用工具生成文档就可以了。
|
 |
8
israinbow 2022-07-02 00:07:20 +08:00 3
https://p1-tt.byteimg.com/origin/pgc-image/d8ad667fa26d40909b67c60f0d514ab3.jpg
你是不是想看这种二次元的图片, 说! (雾 |
 |
9
DOLLOR 2022-07-02 00:14:45 +08:00
纯文本的编辑器已经很卡了，你还要加多媒体的话……
|
 |
10
dcsuibian 2022-07-02 00:16:54 +08:00
一张图片几 MB ，直接把我的整个 src 文件打趴下。
|
 |
11
codingBug 2022-07-02 00:18:06 +08:00 via Android 1
如果用文字注释不能解释这一段代码的逻辑，那我认为这是你自己的问题
|
 |
12
xiangyuecn 2022-07-02 08:41:47 +08:00
 |
 |
13
secondwtq 2022-07-02 08:43:20 +08:00
别听楼上瞎解释，这个就是很简单的“又不是不能用”而已
|
|
14
xiangyuecn 2022-07-02 08:45:20 +08:00
有时候，放张图确实不错
得承认：文字解释 绝大部分情况下 没有直接可视化的东西 来的直观 |
 |
15
kwanzaa 2022-07-02 08:49:27 +08:00
自己写插件用插件就是了
|
 |
16
felixcode 2022-07-02 09:13:48 +08:00
嘿，这行代码自带 PPT 。
|
 |
17
sadfQED2 2022-07-02 09:20:23 +08:00 via Android 1
文字是最高效的交流方式了，视频啥的，一个简单问题，看 10 分钟 9 分钟都是废话。
楼主就是那种什么东西都要别人给你灌输，什么东西都不愿意自己去看的思想。 |
 |
18
AlisaDestiny 2022-07-02 09:31:44 +08:00
简单啊，用 microsoft word 写代码就行了。
Why Microsoft Word is the best IDE for programming |
 |
19
cxtrinityy 2022-07-02 10:55:48 +08:00 via Android
有没有可能是你不知道也不搜索而不是没有？
Rxjava 几乎都配了图片注释 |
|
20
wdc63 OP @haolongsun 渲染图片应该不会卡吧，图片可以作为资源文件和文本文件分开存放异步加载，也不会影响代码编辑的性能。
|
|
21
wdc63 OP @xiangyuecn 链接方式挺不错，但是受到的影响因素太多。
|
|
23
wdc63 OP @AlisaDestiny o(*≥▽≤)ツ┏━┓
|
 |
24
encro 2022-07-02 17:09:26 +08:00
你说的是 jupyter notebook ?
|
 |
25
FYFX 2022-07-02 19:38:34 +08:00
你说的这个算文学编程吧，jupyter notebook 是，你要拿 emacs 的 org-mode 写代码也能做到类似的效果
|
 |
26
searene 2022-07-02 20:18:00 +08:00
我记得 Visual Studio 就支持的，有人还给 Visual Studio Code 提了建议，希望它也支持
|
 |
27
Felldeadbird 2022-07-02 21:42:26 +08:00
技术上完全可行，没有流行应该是图片渲染问题。 你本来写着 A 行。图片没渲染出来，突然间完成了。A 行跳到很后面。你思路被打断了。
|
 |
28
yousabuk 2022-07-02 22:09:47 +08:00 via iPhone
咋没有，labview 就可以。
|
 |
29
smdbh 2022-07-02 22:29:20 +08:00
ascii art ？以前很多，现在少了
|
|
30
smdbh 2022-07-02 22:31:32 +08:00
|
Select Language