标签 小程序 下的文章

“Linux” 小程序是 Linux 中国在 2019 年 2 月(恰恰是去年春节)发布的小程序,该小程序采用众包模式,对著名的 TLDR 项目中的 Linux 命令示例进行了翻译,并通过微信小程序的形式展现。

在过去的一年里,我们和广大的社区贡献者,一同将这个小程序中的内容进行了翻译,如今翻译进度已经接近 100%。在 2020 年的春节,我们面向更多的 PC 端用户,开放了 Web 版的 Linux 命令查询。Web 版和小程序版数据同步,让你在使用桌面计算机时也可以进行命令查询。

现在,你可以通过 https://tldr.linux.cn/ 来体验 PC 端的命令查询。

除此之外,为了让这个项目可以更好的发展,我们也将这个项目开源出来,你可以在 GitHub 中找到它。如果觉得不错,不妨在 GitHub 给我们一个星标!

不仅如此,我们还邀请了本项目的开发者来写了经验分享文章(请关注我们的后继文章),帮助有兴趣的开发者快速上手开发类似的项目,既可以参与到我们的项目协作中,也可以通过学习一些经验,来了解到更多关于 Web 应用开发的知识。

可能大家还记得,我们在一个多月前发布了一个小程序“Linux文章”,并用它来作为的我们的官方 APP。当时的实现的功能还是一个最简单的版本,基本上只是一个文章列表和文章查看。经过这段时间的不断打磨,我们终于在这个小程序的基础上,形成了比较完善的一个内容社区的官方应用。下面我给大家正式介绍一下这个小程序的功能。

首先,由于名字的原因,这个小程序没法叫做“Linux中国”,所以它的名称是叫做“Linux文章”,这有点尴尬,不过大家一般来说都可以通过扫描如下的小程序码来使用它。

扫码访问

首次访问这个小程序,会显示一个“操作指南”,从中我们可以看到,这个小程序没有采用惯常的“文章列表、点击查看”的模式,所以并不是将网站体验直接照搬到小程序当中。在这个小程序当中,充分利用了各种滑动操作,并且可以单手完成绝大部分操作。

给初次访问者的操作指南

按照指示,你可以在此屏幕上左滑或右滑看到首页的搜索框——可以搜索你想找的文章,也可以上滑看到默认文章列表或搜索结果。

首页的搜索框

而当将此页面上滑,或再次访问此小程序时,会直接显示文章列表(或搜索结果列表):

文章列表

如果进行了搜索,比如搜索“树莓派”,那么会在列表上指示搜索关键字,可以“关闭”这个关键字指示,返回默认文章列表:

搜索结果

在这个列表上,可以左右滑动,浏览更多的文章。此外,点击题图时,会切换该页面的显示模式,变成横屏模式,以题图为主要显示内容。而在横屏模式中,长按题图可以保存该题图到相册当中。

横屏模式

也可以再继续向上滑动,显示该文章内容。当然你也可以点击这个页面当中的标题访问文章内容。

文章内容

左右滑动文章页面可以看到文章内的素材信息,包括导航、链接、图片等,方便访问。

文章素材

在文章页面中,可以向下滑动回到列表,也可以继续向下滑动回到首页。

基本上,这个小程序实现了访问我们的内容的一个独立渠道,未来,我们还会增加一些方便而不会让小程序过于笨重的功能。希望大家喜欢。如果你有什么建议或 bug 反馈,请加入微信群:

半个月前,我们推出了一个“文章助手”的小程序,用于解决在微信公众号文章中无法放置可点击的链接的问题。

可能对于我们这种技术向的文章来说,很多时候都需要插入链接,而一个认真的读者也经常希望可以点击链接看看。在我们从 2013 年开始运营公众号以来,我们对此问题有过几种解决方案:

  • 直接将链接以文字的方式显示在正文中,读者需要手工选择并复制链接,然后另外在浏览器中打开
  • 类似于文章脚注一样,将链接放置在文末,读者需要翻到文末,根据所要找的链接标号来复制并在浏览器中打开
  • 将链接整理后放在另外一个 web 页面中,然后通过“阅读原文”的方式引导读者去点击,在其中完成链接功能

但是这几种方法都不太尽如人意,读者经常还是会下意识去点击文章内该出现链接的地方。所以,我们最近又有了新的解决方案。我们利用微信小程序的能力,在微信公众号文章内,采用小程序链接来替代外部链接;点击小程序链接后会打开该小程序,自动复制外部链接到剪贴板;打开浏览器(自动)贴入剪贴板中的链接来访问。

应该说,效果还是达到了我们的预期,虽然有些功能限于小程序本身支持无法做到,比如无法得到来源公众号的信息、无法主动唤起浏览器等。

不过,在使用过程中,公众号编辑们发现对链接一个个进行替换非常繁琐,所以,我决定给这个“文章助手”提供一个“助手”。我做了一个静态页面,在此页面内,只要将你编辑的公众号文章内容贴入其中的输入框,一键点击即可将全部链接转换为“文章助手”链接。

此外,经常还有认识或不认识的朋友,对我们的公众号排版表示好奇,比如这种 注释性的标签 Ruby tag 是怎么回事?也有人希望采用 PingFang 字体,这个是微信编辑器默认不提供的。这次我们就一便提供好了。

“文章助手”的助手地址如下: https://linux.cn/static/tools/a.html

  • 这个页面是纯静态页面,你可以连着其中使用的 jQuery 保存下来自行使用。
  • 该小程序永久免费,并永久不添加第三方广告。
  • 除不可抗力(如被微信官方封杀,但目前我们判断并未触犯微信使用规则),该小程序会一直运营下去。
  • 贴入输入框的文章内容可能暂时不能显示来自微信已发送文章内的图片,但是并不影响转换和转换后再贴入微信编辑器内使用。
  • 在输入框中选定格式“中文(English)”这样的内容时,点击下方的“转换 RUBY”的按钮,会将该字符串转换为 中文 English 样式。
  • 如果要全文使用“PingFang”字体,转换前勾选即可(最显眼的区别是,逗号和句号是垂直居中而不是底线对齐的)。

好了,老王的这些家底都给你们了,祝你们的公众号文章看起来越来越专业、越来越漂亮。

经常看公众号文章的人都知道,一般而言,公众号内是无法放超链接的。这对于一般的文章来说其实不要紧,但是对于我们这种技术类的文章,往往会带有很多链接,而不能插入链接,会导致一篇文章的价值和可信性降低。

备注:

公众号文章可以放超链接的情况有几种:

  1. 认证的服务号可以放任意链接
  2. 可以链接已经发送的任意公众号文章

针对这种情况,我们之前有过几种解决方案:

  1. 将链接 URL 以文字的方式显示在文章中或文章底部。
  2. 将链接转换成二维码,可以长按识别跳转。
  3. 将文内的链接整理放到一个专门的 HTML 页面,通过“阅读原文”引导读者访问。

其中第 3 种解决方案是我们近几年一直采用的方式。不料,前一段时间,有个读者留言问,链接怎么不能点?而这个读者居然是从 2013 年就关注我们的读者,这让我很吃惊。这说明,一方面我们对读者的提示和帮助还不够;另外一方面,大部分读者还是习惯性的去点击链接(我们文章内的链接有易于识别的样式,一看就像是链接)。

思考之下,结合最近我们正在研究的小程序,我们提出了第 4 种解决方案:用小程序来承载链接。读者点击小程序后,小程序负责将该链接复制到剪贴板中,这样读者只需要打开手机浏览器,就可以手动粘贴该链接进行访问了(有的浏览器会自动询问是否访问剪贴板中的链接)。虽然,还需要打开浏览器一个步骤,但是这样感觉直接多了。

这个功能在我们的公众号和我们专用的小程序“Linux文章”上试验打磨之后,我们决定建立一个公用的小程序,将这个功能开放给大家使用。

使用方法

1、在微信文章编辑器中,点击插入“小程序”,输入“文章助手”查找(使用这个小程序不需要公众号关联):

选择小程序

就是这个大眼睛,然后下一步:

2、这里输入路径“/pages/a?link=链接地址&title=链接标题”,请使用你的链接链接标题分别替换路径参数:

输入路径

当然,展示方式你也可以不使用“文字”,选择图片也是可以的。

插入文字链接后效果如下:

小程序链接效果

小程序效果

读者在看到你推送的公众号文章后,看到这种熟悉的链接样式,自然而然就知道可以点击了。点击后,会弹出如下小程序界面:

小程序界面

“文章助手”小程序会显示该链接,并自动复制到剪贴板。当你的剪贴板内有较多内容时,不会自动复制,以避免冲掉你的重要内容。这种情况下,可以点击一下链接框,手动复制即可。

然后就可以打开手机上的浏览器来浏览啦。

除此以外,点击小程序左上角的头像,读者还可以看到他查看过的所有链接。

重要提醒

此小程序的使用永久免费,并且我们承诺永远不会主动停止服务,所以不用担心你文章内的链接将来不能使用。

再上面的链接页面内有个预留广告位,我们保留将来投放广告的可能性——但是将来万一(我说万一)真的要投放广告了,我们会给出几种方式,以使你免除被绑架的忧虑:

  • 接受公众号或读者的捐赠或付款而享受免投放广告服务
  • 之前没有投放过广告的链接页面,我们保证不会出现广告(根据首次出现的时间线判定)

当然,如果你实在不相信我的人品,那么这个原理其实不复杂,你可以自己实现一个这样的小程序。

一直想有个 Linux 中国的 APP,因为种种条件限制而没有达成这个目标。

微信小程序出来之后,也考虑过是否可以用微信小程序来实现一个 Linux 中国的 APP。但是在这个小程序内应该实现什么功能呢?经过几番考虑,可能也是因为最近比较喜欢极简风格,因此就做了一个(真的)极简的 Linux 中国小程序。

好吧,以上是给我自己找的理由,实在是因为这个小程序里面不知道该放些什么功能才是大家需要的,所以这个小程序只有 3 个页面:一闪而过的封面、显示文章题图及标题的翻页列表,以及一个显示文章内容的 web-view。

扫描或搜索“Linux文章”小程序

打开这个小程序,封面闪过之后,就是这样的列表:

竖版界面

向左滑动,就是下一篇。

点击这个页面,会切换显示模式,以横屏模式显示题图。再次点击切换回来。横屏模式下长按图片,可以保存该图片(需要授权才行)。之所以做这样的功能,是因为我们的每篇文章,都会尽力去选择一张漂亮的题图,不能辜负这种对读者的心意。:D

横版题图

什么,你说如何访问文章?哦,是我忘记啦——在竖屏模式下,长按即可访问。

此外,要是遇到喜欢的文章,可以方便的分享出去:

分享

一个月前,我们发布了一个小程序“Linux”,可以用来快速查找 Linux 中的命令常用语法。这个小程序中我们收录了上千条 Linux 命令(严格地说,几乎包含了 Unix/BSD 乃至于 OSX 等的全部命令)。该小程序的数据来源于国外的一个著名开源项目:tldr.sh,其项目托管于 GitHub

这个小程序在推出前并没有特别周密的产品设计,我们在推出后,对这个产品进行了频繁的打磨和改进。几乎每天都会发布新的更新版本。甚至连小程序的 Logo 都换了两次。现在是这个:

Linux 小程序 Logo

这一个月来,这个小程序得到了大家的踊跃支持,很多命令都得到了大家的翻译贡献。应该说,这个小程序寄托着我们的一个实验性想法:我们希望提供一种众包式的机制,可以使大家可以利用碎片式时间来为开源文档提供碎片式的翻译。大家可能知道,我们的翻译组 LCTT 采用了和一些国际化翻译平台及其它一些开源翻译组织不同的模式,我们通常要求一个译者完成全篇文章的翻译,而非按段落切分,这样可以保证全文的质量和用语稳定。但是,这种模式在我们试图翻译 man 手册时遇到了困难——这可能是文章类和手册类的内容性质不同所造成的。

通过这次的实验,我们发现这种模式在对手册类的内容进行翻译还是有效的。因此,我们接下来会推出针对 man 手册的小程序,会同样采用这种众包方式进行翻译。

当然,在某个条目/手册的翻译成熟后,我们会将其推送会上游,以使更多人受惠。

这一个月来,这个小程序得到了八千多人的使用,一百多位贡献者实际参与了翻译贡献,其中贡献最高的“Datura stramonium L.”一个人就提交了 646 条翻译!

下面我来总结一下这一个月来我们的“Linux”小程序的改进要点:

  • 除了可以搜索命令名之外,还可以按描述搜索命令
  • 贡献排行榜
  • 首页随机推荐命令,显示最新更新动态
  • 显示风格调整
  • 强化贡献者呈现
  • 增加了命令的延伸阅读文章
  • 增加了中英文切换显示功能

接下来,我们计划进行如下改进:

  • 对命令页面中的占位符进行特殊渲染
  • 标定某个页面的翻译成熟,可以推送到上游
  • 添加评论框,以发表评论和丰富用法示例
  • 添加更新提示消息——当你编辑过的消息被再次更新,你可以收到提醒

最后,欢迎大家都来体验一下“Linux”小程序:

Linux 小程序码