今天下午,我开始研究我的用户登录库,这是我几年前开始构建的。
我想编写有关如何替换内置样式的文档。我清单上的众多待办事项之一。
它是建立在 Liaison 之上的,Liaison 是我几年前开发的一个 PHP 框架,用于构建网站和后端 Web 应用程序。因此,我检查了 Liaison 的文档,了解如何从视图中替换 css 文件。
它没有记录在案。因此,我找到具有示例代码的测试函数,添加一些特殊注释来导出代码块,然后我将使用名为Code Scrawl 的库将其@import()
到我的 Liaison 文档中…我启动了另一个软件几年前。
所以一切顺利。我正在为 Liaison 的 css 文件内容编写更新的文档,并且我想使用@see_file(src/addon/Resources.php, Resources Addon)
Scrawl 中的一项功能)链接到其中一个源文件。但是我不太记得语法了,所以我跳到了 Code Scrawl 的文档。
(我可以只写 markdown 链接,但是如果找不到目标文件, @see_file()
会通知我错误。因此,如果我的代码库发生变化,我会知道我的文档弄乱了并修复它们这就是 Code Scrawl 的全部要点 – 您的文档不会因为这样的功能和测试中的代码导出/导入而过时。
它列出了@see_file(rel_path)
作为用法……但我只是知道这是不对的。所以现在我正在研究 Code Scrawl 实现(也是用 PHP 编写的),以确保@see_file()
接受第二个参数并向其添加文档块。确实如此。
我将文档添加到 Code Scrawl 中。关闭该项目。
我将文档添加到 Liaison。关闭该项目。
我回到了用户库,等等我在做什么?哦,是的,记录如何替换内置样式。
添加该文档,天哪,我刚刚花了一个小时在我的堆栈中调整库这个兔子洞。
总体来说这是一个很好的改进。我对今天的工作很满意。之后我就累坏了。我总是追求……基本上做任何事情。但这很好。
这对我来说通常就是编码的感觉。我在一个库中,它依赖于另一个库,而另一个库又依赖于另一个库,所以我最终深入了 2 或 3 个库,只是为了完成我真正想要处理的事情中的一个功能。
这是构建我自己的堆栈的副作用。 (我也构建了自己的测试框架。 )这样做的一个副作用是,当我……在编程和编写文档方面不太熟练时。所以很长一段时间以来,很多内容都是一团糟,现在我只是慢慢地——但肯定是在清理它并改进它。
(这不仅仅是技能水平较低。我还经常感到焦虑,感到匆忙,感觉自己没有足够的时间做任何事情。这也是精神疾病的产物,尽管当时的形式与现在不同)
阻碍我的主要因素是残疾。我有一些短暂的时间,可以花几天时间编写代码。但我每次还是只能走一两个小时。然后能量+渴望的组合逐渐消失,我再也做不到了,所以它又持续了一两个月,没有任何进展。
它的残疾方面帮助我更好地记好笔记。我总是记下我停下来的地方以及接下来需要做什么,并且十有八九我可以自信地相信这些笔记。我曾经试图把这一切都记在脑子里,但那真是一场噩梦。
顺便说一句,为此,我在每个项目的根目录下都有一个Status.md
,每次编码时我都会在其中做大量笔记,并注明日期。
我梦想着治愈我的精神疾病并完成这些该死的项目。他们有很大的潜力。关于他们的很多事情真的很棒。但它们的很多方面还需要改进。它们没有像需要的那样抛光。
其中一些基本上已经准备好发布了——比如 Code Scrawl。我的意思是,它并不完美……但它真正需要的只是文档和……嗯……营销方面的一点改进。
哦,我有没有提到 Code Scrawl 取决于我制作的 Lexer?从头开始?为此我创建了它自己的编程语言?是的。搞什么鬼。 (也是用 PHP 构建的,梦想有一天能够在语言之间转换代码)