Lazarus中文手册-2025-5-25

[复制链接]
Lazarus中文手册.png

《Lazarus 中文手册》开始通第二遍了。

从头再学一遍,把之前发的视频全删了,重新录、重新发。

第一遍翻译算是做完了,留空的地方、有争议的条目,这回补上;之前翻错、讲错的地方,也一一纠正。

在二次整理的时候,又发现了新问题,有些控件的属性是复选框,也就是布尔类型。

之前对这种属性,习惯用一句话带过,现在才发现,这种方式其实有很大弊端。

比如说 ParentColor,作用是是否继承父控件的背景色。

可问题是:到底是 True 时继承,还是 False 时继承?

道理我们都懂,可真用起来的时候,还得去确认状态,反而添了麻烦。

像这种情况,不如直接拆开讲清楚。当 ParentColor 为 True 时是什么效果,为 False 时又是什么效果。

这样翻手册的时候,一眼就能看明白,还省掉了大量不必要的测试时间。

在整理过程中,还暴露出更多界面上的问题。我们拿“页签”这个控件来举个例子。

Style 属性的用途是“页签按钮样式”

可问题来了:什么是页签?界面上哪个位置才叫页签?

当然,这只是个简单的例子。页签控件本身还算直白,就算不解释,猜也能猜个大概。

但如果是那种细节特别多、条条框框很密的控件呢?

界面上全是细线条、各种小按钮和标识,到底哪个对应哪个?

就算告诉你“这里用来修改页签按钮样式”,你也得先知道“页签”到底指的是哪儿吧?

所以,又定了一套统一的命名规范:

在翻译和解释用途之前,先用图纸把控件拆解开。

明确告诉你,这里叫什么,那里又叫什么。

等有了这张“图纸”,再去看属性解释,你马上就能反应过来 —— 哦,原来这里说的就是那个地方。

还有就是属性用途描述的问题 —— 有的属性一句话就能讲明白,有的却得啰嗦一大段才能说清楚。

虽然一直在尽量精简,可有些地方哪怕删到最短,句子还是很长。

再往下砍,意思就讲不透了。

这种时候,就没必要再硬塞一个「参考:属性示例1」去拆出去了。

于是在手册里加了个气泡提示框:鼠标移到问号上,就会弹出更详细的补充说明。

之前那些没讲透、没说清的地方,就都放在这里补上。既不破坏正文简洁,又能让人点一下就懂。

可新问题又冒出来了 ——

有些控件的属性是带图片的,比如 Cursor,里面是各种鼠标指针样式。

光靠文字翻译,用户根本看不到鼠标长什么样。

于是又加了个弹窗功能:点击后,会额外弹出一个新页面,里面既有中英文对照,也配上了对应的指针图片。

这样用户一眼就能明白,这个光标到底是什么样子。

同时也补了一句说明:不同操作系统下,指针样式可能会有细微差别。

同时,也对网页做了不少 CSS 样式的优化 ——

文本高亮、文字颜色、表格样式,还有鼠标交互、划中选中的效果,都重新调过,看着更清楚,用着也更顺手。

既然界面都能画图、拆解控件了,那回头想想,之前讲语法语句的时候,为什么不能也画图呢?

有些人学习,只要听一遍就能懂,但忘得也快,得反复记;

可还有些人,光听是根本学不会的。他们必须“看见”——要有图、有流程、有底层原理,脑子才能转过弯来。

本人就属于后者。只听,是听不懂的。所以下定决心:必须把图画出来。

语句的走向图、数据类型图、过程、函数……一个都不能少,全都得画出来。

再搭配不同的颜色,提高视觉辨识度。这样下次一看到图,脑子里就能立刻回想起对应的逻辑,省时又省力。

因为自己英语不好,起点很低 —— 低到用初中学历去学编程。

既然是从这么低的起点来写这套《Lazarus 中文手册》,那它天然就把门槛压到了初中学历就能看懂的水平。

反过来想,连初中学历都能看明白,那高材生自然更是一眼就能懂。

所以自己一直觉得,英语不好、学历不高的人,最适合找那种从同样泥坑里爬出来的人教。

只有走过同样的路,才知道你卡在哪儿。

要是让起点高的人来教,他默认你就会微积分、懂英文、能啃官方文档,讲起来自然跳步、省略。

你跟着学,学着学着就发现跟不上了,最后只能放弃。

《Lazarus 中文手册》,就是给低起点的人做的教学。不装、不跳、不默认你会,只求你能真正学会。

同样的,还在不间断地发视频。

毕竟之前已经完整讲了一遍,再讲的时候,心里有底,说话也顺溜多了。

不像以前那样,一个视频得反复录好几遍才敢上传。

第二次讲解,也不再像第一次那样死板 —— 之前是哪怕同一个属性、同一个事件,只要换了个控件,就再讲一遍。

现在不一样了,通用属性只讲一次,后面就不再重复,只专心讲每个控件独有的东西。

当然,控件是干嘛用的,依然会演示得清清楚楚。

视频里还是会讲得很细、很透,生怕大家学不会。

其实说白了,主要还是给自己加深印象 —— 自己要是跳过去了,保不齐哪天也就真不会了。

所以这也算是一边录视频,一边逼着自己实践。

那段时间,也留意到有几个小 UP 主在讲 Lazarus。

特意去看了几期,发现他们讲得特别简单 ——

控件基本都是一笔带过,甚至好几个控件凑在一起讲,只提主要作用,细节属性几乎不碰。

但人家封面做得漂亮,偶尔还露个脸,视频包装也精致。

明明发的视频不多,讲得也浅,可粉丝涨得快。说实话,心里确实有一点点眼红。