发布后,元元。 我们学习写在哈勃


-Coachman,但离发布还很远吗?
-是的,有两次排版。


到了最后-我正在用Habr编写有关如何用Habr编写文字的文章。 尽管有原因-我已经这样做了五年,但我已经看过并尝试了很多工具,因此现在与您分享最好的东西。


我将讨论如何从Habra编辑器中的HTML标记过渡到有意义的布局,快速的后期设计和高效的协作。 这里-关于我在Yandex.Money方面的经验,以及我如何组织有关habratext的工作,以免造成极大的痛苦。


风格就是我们的一切


我将从此类帖子最不明显的内容开始。


风格-我积极灌输给同事和学生的东西。 这与信息提要或科学和艺术无关,而与文本的外观有关。 如果您有一天学会制作样式 ,就不会回头。 (LaTex家伙在这个地方狡猾地窃笑-您太酷了,让我们让简单的凡人享受设计的乐趣。)



没人知道如何使用的菜单


底线很简单-您以正确的方式写出一段文字,保存模板,然后将其应用到需要的地方。 该模板在Word和Google文档中称为样式。 用样式排版文凭的学生比那些手动更改字体,缩进以及其他段落和标题(每页100页)的学生要快乐90%。


当然,有了Habr,一切都变得更加简单-足以理解文章的结构并安排所需级别的标题。 处理它非常简单-h1,h2,h3和h4-如html中所示。


处理marcdown


如果您突然还没有。


自从出现在habra编辑器中以来,Markdown一直让我感到恐惧。 它看起来像是一种敌对的东西,与通常的HTML标签不同,并且完全被自身排斥。 实践表明,最好选择两个选项之一。


即使您使用内置的Habr编辑器进行编写(尽管主管部门不建议这样做),降价也会为您节省大量时间和精力。 虽然,当然,最好选择其他工具。 Habra编辑器适合正确的预览,仅此而已。


Markdown的情况因情况而略有不同。 哈伯(Habr)具有自己的品味降价-链接是可以理解的指南,从中可以肯定值得从哈布雷博斯特(Habrapost)的布局开始进入无痛苦的世界。


在哪里写?


写在您方便的地方。 唯一要记住的是:编写起来很方便!=为Habr排版很方便。 如果vim对您方便,请继续,我将讨论更保守的文本编写方法以及它们在Habré上的适用性。


在Yandex.Money中,我们用不同的方式编写-不同的作者有不同的熟悉的文本编辑器,我尽量不要强迫他们。 一些作者在Yandex.Disk上或通过邮件发送文本文档,其他人则在市场或服务中立即撰写以进行共同编辑。


Visual Studio代码(或Sublime)


我在市场中就用VS Code编写了这段文字(以及其他大部分文字)。 屏幕的左半部分显示文本,右半部分显示通过相应插件在Markdown中编写的文本。 该插件称为Markdown MPE Preview-它支持将图片从计算机下载到imgur,并在文本的正确位置插入链接。



发布后,元元


一些写作人员会怪我-他们说Sublime Text 3更好。 我肯定知道marqdown还可以使用所有功能-如果愿意,可以使用它。 好吧,通常来说,针对所有平台和每种口味的数十名(甚至数百名)编辑者。 最主要的是写得好:)


微软Word


如果您有一台Windows计算机,则很可能在其中安装了Word。 还有您的共同作者(如果有共同作者),也很有可能。 对于大多数人来说,这是一个正常且熟悉的工具,尽管已付费。


问题在于在Word中(如果您没有皇家订阅)您将无法一起编辑文档,这意味着工作将被简化为Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx。 据我所知,这种痛苦困扰着一些设计师,插画家和其他“矫正”的人。


但这还不是那么可怕。 主要的麻烦是,如果没有举行仪式舞蹈,您将看不到文本在网站上的显示方式。 起初看来这没什么大不了的。 从Word文件传输文本花费了最初的几个小时之后,人们才意识到灾难的发生。


老实说,我不知道Habr通常会接受从doc到markdown的任何公共转换器。 我毫不怀疑它们是否存在,但是Yandex.Money在Word中的habratexts(如果编写的话)只是由一些作者编写的,然后它们很快就变成了marquedown。


谷歌文档


著名的好东西,也免费。 尽可能为许多作者,编辑和其他同情者的合作做好准备。 功能足以满足任何需求。 需要一个Google帐户,但是现在没有谁?


如果多个人用同一文字书写不同的部分(例如,有关iOS和Android上的付款API的工作),则可以在Google Dock中工作。 不同的开发人员,不同的块,段落,但是每个人都看到了一切,并且任何地方都没有丢失。 单独的加号是编辑的历史记录。


在这里,就像在Word中一样,放置标题就足够了,然后在导出时,您不必做很多不必要的工作。


缺点-如果您共享文件链接,则文件泄漏到错误位置的位置会容易得多。 但是,如果您不写任何包含NDA的内容,那就可以了。 这里的预览仍然很复杂,但还有一些优点-将文本从google-dock传输到集线器要容易得多。


还会发生什么


txt文件中的文本仍然存在着令人难以置信的世界,缩进了三到五个空格。 出于道德原因,我无法展示它(我不敢自己打开它),但请相信我-上面的所有选择肯定更好。


还有什么可以改善你的生活


印刷师


如果正确的引号,短划线和随机双空格消失了,您的文本将会好一百倍。 为此,请一位Lebedev工作室的排版员 -将文字上传到此处,然后您将获得精美的结果。



这里还显示了markdown的其他内容-如果将整个Google Dock或虚构的Word文件放入打印机,则输出仍将获得纯文本。 图片也将丢失。 但是markdown没问题-布局是在生成之后生成的,图片是链接,因此您可以进行任意数量的操作,只需有时间按Ctrl +A。


当然,这不能消除由良好的校正器进行文本验证的需要。 另一方面,如果您不写公司博客,而只是在Habré上分享内容,那么这对您的工作很有帮助。


哈布拉转换器


Google文档中的文本可以通过不同的方式进行传输-手动或通过不同的转换器传输。 我还没有遇到理想的解决方案,因此通常我将两种出色的功能结合在一起。


第一个是https://shirixae.imtqy.com/habraconverter-v2/ 。 复制整个Google Dock到文本框中-就是这样。 如果您记得设置标题,它会生成一个不错的Markdown。 从Google-Dock中拉出指向图片的链接也很好-当然,它们需要在Habrastorage上重新加载,但总比没有好。


第二个是Docs To Markdown扩展。 生成最佳的降价代码,可以很好地与换行符一起使用,但是对图片一无所知。



为什么如此重要-如果五个人用图片写文本,那么很难从所有文件中获取文件,然后需要对其进行排序,正确排列并发布。


当然,如果您写自己,并且所有内容都经过仔细编号,并按爸爸排列,则只需上传到Habrastorage。


当我编辑多个作者的文本时,我会执行以下操作-从第二个转换器中获取文本,然后使用第一个转换器中的链接将图片重新上传到Habrastorage。 听起来并不简单,但可以节省大量时间。


有关降价的实用提示等


  1. 将文本分成段落 。 拜托
  2. 图片在哈伯斯托拉奇 。 这是显而易见的,但最好重复一遍。 没有什么比五年前开一个有用的帖子并意识到与图片的链接早已变质更糟糕的了。 顺便说一下,HS给出了Markdown中包装好的现成链接。
  3. 在列表编号中,只有第一个元素很重要;其余元素可以随意放置。 如果您决定将列表中的元素重新排列10个元素,但又懒得更改数字,这将很有用。
  4. 表-图片 。 在marqdown中,有趣的桌子第一次使大脑折断了几次,但是Habr不知道如何精美地显示它们-单元格中的文本被转移到新的一行。 最好将它们绘制到其他位置并嵌入PNG。
    更新。 意见书中opanas的一个很好的建议是“建议在图片表附近放置一个扰流板(图片表将是文本,读者可以复制,机器人可以处理索引)”。
  5. 使用doc.new链接创建了一个新的Google码头 -将其添加到书签栏中以节省时间。
  6. 保留草稿-将它们与一些云同步。 当然,您总是可以从Habré上的出版物中获得布局,但是,正如实践所示,它更可靠。
  7. 至少在前30次中,不同级别的标题之间的缩进是世界上最随机的事情。 在发布之前,请确保仔细检查文本中是否包含普通缩进。
  8. 将HTML与Habr-markdown混合使用会在第三方编辑器中创建有趣的错误。 例如,如果您使用<code/>而忘记正确关闭它。 原来是这样的:

结论


这篇文章中的所有技巧均来自个人经验。 它们只会帮助您节省时间和精力,以减少准备帖子所需的其他工作,而且没人会取消撰写有趣的文字。


实践表明,如果您对某些事情感兴趣,那么布局,html或转换复杂性都不会阻止您。 您将成功填写所有图片,用手放置标题和标签,设置代码格式,然后结果仍然会很好-因为显然,文本比设计更重要。 但是没有人愿意让美丽和讨好读者。 因此,您需要这样做。


赢了

Source: https://habr.com/ru/post/zh-CN442666/


All Articles