yihui 还有哪些是你需要的?

暂时还想到三个,尽管我知道这些功能可以自己仿照、网上找材料尽力去实现,但是对大部分用户来说,太难了,对我也很难。

  1. 有的表格比较宽一点,是否也能像超宽图片那样,突破正文的宽度?

  2. 是否可以加一些注意、提示、警告之类的 block?

  3. 是否可以支持 utteranc.es ?

  4. 是否可以支持分栏,比如双栏?

  5. 是否可以支持某篇博客根据需要加载数学公式?

  6. 是否可以支持自包含的模式,一个篇文章一个大 HTML ?类似 Frank Harrell 大人的 R Workflow 文章

  7. 是否可以支持 PNG 图片优化压缩?

  8. 是否可以在参考文献后支持附录?

我倾向于让每一篇博客独立起来管理,让博主们一心往前创作,一旦写完就不用担心新博客还和旧博客有任何技术上的交叉影响,甚至包括图片。比如,我之前想把博客图片全放在一个全局位置,后来,下定决心一定要随博文一起,不用 Github 图床是因为我想以后复用起来方便,也怕万一 Github 不让用了找不回来了,还有墙的问题,出现问题可以一股脑全搬去新图床。

是否可以支持到这样一种程度,就是像 Quarto 那样,还有个帮助文档,基于某个博客主题(比如 blogdown 书里介绍的 hugo-lithium ),把这些功能的使用详细介绍一下,用户只需要照着弄就好了。Hugo 主题其实不需要太多,感兴趣有能力的人自个定制去,咱们是否可以提供一款主题,这款主题能覆盖 99% 常用功能,并且持续打磨以提高用户体验。

至于怎么做的可以在高级定制篇里介绍,属于可选项。 若能从零开始介绍如何制作一个这样的博客主题,就更好了!这样,小白、菜鸟、忍者等用户都覆盖了。 我曾苦口婆心劝 @yuanfan 学习一下以 Rmd 格式给统计之都主站投稿,她那些饱含交互图形的文章最适合了,她坚决不干,说是 blogdown 太复杂了,太难了。我原想自己动手弄一两篇 Rmd 格式文章,后面大家可以照葫芦画瓢,目前看来,还有不少困难。

我前段时间简单尝试了 Quarto 有种立马被吸引了的感觉,它好像吸收了 R Markdown 很多精华,很多用户常用的功能都打磨得很好,解决了很多痛点。比如 Quarto 会支持多种格式的幻灯片 HTML/pdf,通用性就是解决一大痛点,一套语法适用很多种输出,Pandoc 加一堆 lua 外挂(以及 TS / JS)实现用户常用功能。还支持那些博客写得多的人,方便他们写书。这样喜欢折腾主题,博客写得少的;时间不富裕,博客写一般多的;有恒心持续写博客,写很多的人;他们都有自己的出口。

所以,我也相信 Quarto 这款产品将来肯定是会流行起来的,至少在 R 圈!

最后,关于我的博客,确实文章很长,有好处也有坏处,可能我首先是满足自己需要,尽管博客网站对外公开,但首先还是面向自己,满足自己。目录确实是想要加的,Rmd 渲染出 md 格式加不了, Rmarkdown 渲染出 markdown 能加, Rmd 渲染出 HTML 能加,一篇文章想要加个目录竟然和源文档的格式有关系!从用户视角,这就有痛点。另外希望最好支持一种方式就是 Rmd 渲染出 HTML,当然可以支持 md (只要用户自愿放弃一些功能),希望把各种支持怼到一种格式上。

技术写作方面,总结起来,是我最喜欢的一句话: Do one thing, and do it well! Quarto 潜力巨大!

可能上面言语中有不妥的地方,冒犯之处还请见谅!

    我不知道 yihui 有没有在公共场合做过调查,Hadley 之前在 twitter 上问大家长宽格式转化操作函数,应该取什么名字好?最后 pivot_wider() / pivot_longer() 胜出,我是觉得这个调查是非常成功的。 关于 blogdown 产品,是否也可以罗列一个功能单子,收集一些大家的反馈?也许需要一个出口,让不同的声音发出来,这样产品会更好。以上都是个人愚见,仅供参考。

    最后,关于「技术写作」这个产品,上面已将用户划分了三类

    1. 喜欢折腾主题,博客写得少
    2. 时间有限,博客写得一般多
    3. 有恒心持续写,博客写得多

    这三者前提都是做内容的,即使介绍怎么折腾主题的,介绍工具怎么使的,也有助于技术写作。还有一类没啥内容,或内容没啥价值的,也算上。

    四类人能促进技术写作生态发展壮大的就靠前面三类人。工具如何能帮助那些有价值有内容的输出的人更好地创作是工具最大的价值,写完了感觉是句废话,😮‍💨

    原来湘云视角是这样的啊,哈哈,容我偷着乐一会先。你老早提过的那些,包括 Alison Presmanes Hill 的博客我也去翻过了,但是总觉得有些让我搞不懂的、很关键的地方被当做默认已知的常识一笔带过了,我也确实没看懂。

      Hugo 主题其实不需要太多,感兴趣有能力的人自个定制去,咱们是否可以提供一款主题,这款主题能覆盖 99% 常用功能,并且持续打磨以提高用户体验。

      至于怎么做的可以在高级定制篇里介绍,属于可选项。

      为什么连博客主题也要求全啊,那么多博客主题被鼓捣出来,本来就是那些作者取舍之后做出来的啊。主题的高级定制篇……我觉得 hugo 工具和 hugo 主题不应混为一谈。

      说句题外话,上次被怼了以后,我曾考虑过以后在论坛里发言要么虚伪一点、把文字弄得冠冕堂皇一点,要么用很多很多文字把自己的意说尽、免得被误会,要么加上一些语气助词、恶意卖萌防止被误解,要么要么……哈哈,后来觉得还是真诚沟通最重要,还是继续愤怒怼怼、感性喷喷好了。

      yuanfan 这个困难你可以详细说说,blogdown 书里哪里比较难懂,在已经提供 Rmd 格式稿件的情况下,仍然无法依葫芦画瓢,困难点究竟在哪个环节?

        Cloud2016

        喂,从我的视角看那不是个葫芦样啊喂。
        我没看明白content>post>2022-03-19-scihub>index_files这个文件夹下面的那么多东西是怎么生成的?我平时写博客新建一篇通常是Rstudio->Addins->New Post,可是从这里生成的index_files里面只有一个header-attrs。另,益辉的那几本书我没有通读过,每次是遇到问题搜解决方法的时候搜到那里才瞅瞅。

          yihui 因为我感觉我很少看到能忍住不换皮肤的人,我自己都觉得难忍,我想看看这次是不是遇到了一位神仙(五年内不换即可封神),毕竟人类的新鲜感都是难以持续的,惊鸿一般只能存在于一瞥中,瞥完还是一只肥大雁。

          我就从没动过换博客主题的念头,最初建站的时候只是记录了一些想改动的地方,后来改得差不多了就更没想过了。我最初挑选博客主题的时候,把 hugo 网站上的主题都翻了个遍,然后捋了捋自己最想要的功能,本来我最中意的是lilith那个主题,可是列弛和三水大人都用那个主题,那时候还有奇怪的疑心病,觉得用跟喜欢的博主们一样的主题会被怀疑是别有用心,最后就选了我现在这个主题。

          当然也有觉得别人的博客主题好看过,但竟然从没有见到过令我感到惊鸿一瞥的主题。也没有想要把别的功能移植到现在的主题上的想法,因为我原来想要实现的已经实现了。

          湘云说希望存在一个包含了99%功能的主题,恰好那样的主题对我来说毫无吸引力,对我来说给的太多就不是我想要的了。话说回来列弛的博客主题不就没换过么,园主的本来也是没怎么换过的。

          我喜欢比较简洁风格的博客风格,在xmin基础上改了下,字体字号排版基本格式顺眼了,就不再想过多折腾(最近唯一想改变的,是把评论换成Github issue留言那种)。

          看到大家这么兴趣盎然,觉得自己老了。

            shrektan 莫愁。经过这么多年,不想再折腾,我索性把博客给关了。有我垫底,你们都是好样的。

            yuanfan

            1. 应该就 blogdown 那本书的一两个章节而已,不需要把其它书都给看了。

            2. 回到本楼核心问题, Quarto 是主打技术写作,它把技术写作需要的常用功能,我觉得是 99% 的功能都覆盖了,具体例子就是 R Workflow,你可能没有注意这个技术写作的讨论前提。

            3. 大家的需求不一样,你的技术性博客,比如关于 echarts4r 都自己截图贴图了,篇幅也不长,一波操作下来,markdown 足以容纳,不需要 R Markdown 编译,只要自己看着喜欢,用啥 hugo 主题都行。

            最后,请求不要回帖的时候带我真名,有种被押赴刑场的感觉,使用我的论坛 ID @Cloud2016 吧,我不出名,也不想出名,谢谢🙏

            yihui 对你的博客来说,内容相当棒,我个人觉得其实只缺一样功能,就是目录,因为你有一种把天地掏空的写作风格,写得相当全面,就不可避免会写得超级长,读者容易在里面迷失方向,不知道读到哪里了。要是能加个目录,我觉得会减轻不少读者的压力。

            我把目录给加上了,还调整了正文占用的宽度和代码字体大小。但是目录在开头,侧边没有,暂时不想去弄了,等明年 可能会迁移到 Quarto 上。

            有位博主 Andrew Heiss 也是要把天地都掏空的写作风格,你看这篇文章 Marginalia: A guide to figuring out what the heck marginal effects, marginal slopes, average marginal effects, marginal effects at the mean, and all these other marginal things are

              Cloud2016 把天地都掏空的写作风格挺好的,读者只需要收藏或记得一个页面,可以随时回来查阅。

              上面 Cloud2016 的反馈极好,我需要更多的时间消化;目前来看,你的那些需求并不是很复杂,可以不必依赖 Quarto 实现的。等我有时间了会把掉的链子接起来。

                yihui 等我有时间了会把掉的链子接起来。

                期待,那我就没有搬迁动力了,毕竟搬家要花不少时间 😄

                Cloud2016 3. 在主题 hugo-lithium 下,已经把 disqus 换成 utterances 评论系统,详见我的 repo,有需求的坛友可以照葫芦画瓢 😄

                  Cloud2016 已经把 disqus 换成 utterances 评论系统,详见我的 repo,有需求的坛友可以照葫芦画瓢

                  提上日程,抽空去抄一下 😄

                    lijin 对新起步或评论还不多的网站主人,我个人强烈建议早日弃用 Disqus,投奔 utterances 或者 giscus(我感觉这二者中后者在功能上更好一些,但相对新一些,所以我还不知稳定性到什么程度了)。Disqus 太笨重,会加载一大坨脚本和资源,还有一些视觉垃圾,就更不必说墙内用户无法用了。

                    Cloud2016 6. Python 版 plotly 用起来,没有生成很多的本地 JS 文件(副产品),通过看渲染出来的 HTML 发现,里面是直接引用 CDN 上的 JS 库。一篇介绍 Python 版 plotly 的文章动画制作与 Plotly Python,还有其它方面,整体感觉 Python 版要比 R 版好太多了。

                      Cloud2016 这是我好几年前就跟厂里的人建议过的,但他们没有采纳。把所有 JS/CSS 文件本地化的好处显而易见,可以让用户在没有网络连接的情况下继续用这些包;坏处就是如果经常用 HTML Widgets 的话,就会生成大量冗余文件,浪费空间。其实 HTML Widgets 也不是不能用 CDN 资源,只是厂里带头选择了本地化,后来的作者们就都选择了这样做。

                      用 CDN 资源还有个问题,就是文档用自包含模式(self_contained = TRUE)时,Pandoc 得从 CDN 上下载一坨文件,这可能有点浪费时间和带宽。好几年前我同样跟 Pandoc 作者建议过增加一个选项,自包含模式时不下载 CDN 资源,但他也没有听。不过很多个版本后,他提供了一种曲折的方式支持这个功能,就是如果使用外部 CDN 资源,在 HTML 标签上加 external=1 属性即可让 Pandoc 跳过下载,如 <script src="https://example.org/foo.js" external=1></script>。但这个办法对用户没什么用,因为用户通常无法控制如何生成这些 HTML 代码,也就无法加个 external=1 的属性。