我如何写博客

2025-06-07

我如何写博客

很久以前,我输入了一些文字,点击“提交”,就写好了一篇博文。虽然简单,但缺乏技巧;文章也缺乏润色。每写一篇文章,我都会调整我的流程、我的网站和我的工具。现在,让我来概述一下这一切的进展,从构思,到 Markdown 和 HTML,再到发布和推广。

如果您不太关心技术细节,请向下滚动到“校对”或“发布”。

主题和文本

想一个主题就像拔一只疯鸡的毛:选择太多了,有的容易抓,有的难以捉摸,有的漂亮,有的丑陋。我想写什么,我写作的动力是什么,以及我认为人们会感兴趣的内容,这些因素交织在一起,最终的选择永远都难以确定。姑且假设主题会从泥潭中神奇地冒出来吧。

相比之下,写作过程本身却出奇的简单:一个纯文本编辑器 Kate,搭配 Markdown。我不想被格式分心;文本编辑器让我可以立即开始,在文档中跳转,并轻松进行修改。

本文截图

与编码一样,我使用比例字体并启用换行。

关于风格我就不多说了。我心里有一套风格指南,我的手指有时会遵循它,但我也喜欢尝试新事物。考虑到我家墙上挂的奖品不多,我们也可以肯定地说,我在这方面没什么特别突出的成就。

Markdown 格式

我选择 Markdown 是因为它对文本的影响最小。它的开销很低,语法冗余也很少。然而,它提供的格式化功能并不多。

我刚开始用 Markdown 的时候,好像没用过。我感觉我只是写了一些文本文件,然后用在线编辑器格式化。这肯定不太好,因为我的大脑几乎把这些记忆都抹去了。

我使用一个自定义的 Markdown 处理器将文本转换为 HTML 代码,我的主要平台 Wordpress 也支持 HTML 代码。这个处理器是用 Pythonmarkdown库编写的。它不是一个好用的模块;很难更改格式,而且扩展名处理得也不好。目前为止,我只能忍受它,认为这是一个可以接受的解决方案。

让我们看看我使用的某些扩展。

乳胶

$`a + b`
Enter fullscreen mode Exit fullscreen mode

我的许多文章都用到了公式,适当的数学格式也让我受益匪浅。虽然我觉得Latex语言很糟糕,但它支持我可能需要的任何公式。美元符号+反引号扩展名让我可以内联Latex。

texi2dvi为了进行测试,我的处理器将使用、dvips和 的序列创建 PNG 文件convert。它允许我在本地查看包含公式的页面。导出为 HTML 时,它使用 WordPress 内联 Latex 符号。

在我再次更改网站外观之前,我需要自己在WordPress上处理Latex。之前提供的主题做得很糟糕。由于Latex格式不正确,我被迫很快放弃了之前的主题更改。不过,自己做方程式图片需要翻阅所有旧文章并进行更新!

我的FencedCode

我不喜欢默认代码块的格式。它没有提供任何修改方法;我复制了代码并做了一些修改,以生成适合我网站的不同格式。我修改了生成的 HTML 结构和传递给codehilite扩展程序的选项。

当我与Leaf 网站共享此生成器时,我还添加了一个选项,使 Leaf 成为默认语言。

我有一个pygmentsLeaf 的格式化程序。它适合常规的语法高亮工具链。

中心和简介

对于图片,我有一个>>处理器可以把段落居中。我以前用它来处理LaTeX公式,但后来改成了自动居中。现在我应该用它来处理图片,但我倾向于稍后在WordPress的可视化编辑器中插入图片。我现在打算“正确地”操作,先上传图片,然后在Markdown中添加图片链接。

每篇文章的最后一个宣传短文是一个>B>区块,它会在 HTML 中创建一个标签。如果您在其他网站(例如dev.to)aside上阅读本文,您可能看不到这些;我有时会在交叉发布时删除这些短文。

校对

写完一篇文章后,我会把它放一天。然后我会以更清醒的头脑重读一遍,这样我就有机会修改句子结构,或者重新考虑段落的重要性。

我不喜欢填充内容,所以会尽可能地删除信息。这样做会使文章比书籍或其他技术参考资料更短,但阅读速度更快。我知道在某些情况下,这样做会带来一些弊端,会增加细节密度和复杂性。如果某些内容需要进一步解释,我可能会另写一篇文章进行补充——通常我会先发表一篇文章,这样我就有了一个可以链接的参考资料。

发布之前,我会把文本粘贴到 Grammarly 上。它给出了很多不靠谱的建议,但确实能发现很多我的大脑容易忽略的常见错误。

很久以前,我请一位朋友编辑我的文章,但那太耗时了。我希望再次拥有一位人工编辑。

出版

校对完成后,我会在本地进行视觉检查。如上所述,Markdown 处理器可以生成本地测试。它会修改一些内容,并将 CSS 添加到生成的 HTML 中(与我在网站上使用的 CSS 相同)。我可以在本地打开此文件,大致了解它在mortoray.com上的显示效果。

如果它太像一堵文字墙,我会想办法让它更容易理解,比如分节符、旁白,或者偶尔加一张图片。

现在也是右键单击所有链接以确保它们正确的时候。

准备就绪后,我生成了最终的 HTML 代码。我再次用 Firefox 查看了一遍,以确保它能正常工作——因为之前的文件已经存在,我只需要重新加载即可。我按下 Ctrl+U 查看源代码,然后复制粘贴到 WordPress 中。

现在需要调整一些细节:将标题移到特殊字段,选择类别,添加一些标签,选择社交媒体简介(我会在其中添加标签)。还需要一张精选图片;我倾向于在pixabay上找这类图片。

按“发布”即可完成...

交叉发布

唉,我的网站(至少目前)还不算家喻户晓,虽然粉丝数量不少,但只在网站和社交媒体上发帖并不能让我的文章获得太多关注。虽然有时我做得还不错,但运气成分很大。我一直想找个时间写一篇关于互联网彩票的文章。

我的阅读量通过交叉发布而增加。我的发布内容会随着时间推移而变化;我会持续关注优质内容。我不想到处发垃圾信息,也不想获得低回报(这需要付出努力)。

目前,我几乎所有的文章都发布到dev.to上。我使用 Markdown 源码,但需要做一些修改。如果公式太多,我可能不会交叉发布,因为从我的网站抓取图片链接需要太多手动操作。如果我已经切换到自己制作 Latex 图片,就不会有这个问题了。

我的很多文章也发布在Medium上。Medium 有导入功能,但导入源代码的功能很差。我不会在那里发布任何代码量很大的文章。

我在CodeMentor上发表了几篇文章,提升我的知名度。我想收一些学生可能会更有帮助。

我以前经常在 Reddit 上发链接,但那里的抽奖效应和标题偏见非常明显。更糟糕的是,很容易被封禁、列入黑名单,甚至招致别人的讨厌。现在我希望别人能帮我发帖——虽然我曾经看到我的域名被一些子版块列入黑名单,即使我并没有在自我推销!

闪亮的新生鸡蛋

最终,我们完成了一篇文章。或许听起来,为了相对较少的文字,我们付出了巨大的努力,但只要人们阅读并享受其中,我认为一切都是值得的。

如果你正在考虑开博客,我建议一开始就保持简洁。我没有坐下来一下子就创建好所有工具,也没有一夜之间就确定好风格,更没有一下子解决所有技术细节。和所有事情一样,这是一个不断发展的过程。很有可能在我点击“提交”之前,我就会对一些内容进行修改。


如果您喜欢我的文章,请在 TwitterFacebook上关注我,或者成为我的支持者,继续关注我。感谢您的阅读。

文章来源:https://dev.to/mortoray/how-i-write-my-blog-54n0
PREV
如何在编程面试中失败
NEXT
已经知道面试代码题目了?别承认!