最近天天坐着写代码,有时候枯燥又烦躁,有些部分写起来比较绕脑,心想如果在旁边能够附上一张手绘的流程图就好了,用文字很多东西都表述不清楚,下次回看代码的时候又要理解半天,如果能够在旁边放一张图片,辅助文字那很多难以理解的逻辑一目了然就清楚了。为啥程序语言发展这么久,就没有出现过一款支持这种想法的产品呢?
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
|