如何看英文技术文档

本文以jekyll官方文档为例。

为小白简单介绍一下,jeyll就是一个静态博客生成器,你只要按照它给定的规则进行相关的配置后,你就可以只要专心写文章,什么数据库管理、自己搭建一个CMS系统等麻烦事情都不要管,也就是你不用写代码,只要写文章就够了,然后在终端输入命令他就会按照你给的配置生成一个静态博客,然后你只要部署就可以了,特别适合我这种”懒鬼”。

前言

在大概两年前的时候,由于一位学长的建议,我把我所拥有的终端设备都换成了英文的,我当时就苦逼了,一个单词一个单词查,好累,有点后悔,但是呢,还是决定坚持,毕竟Big高。

现在回想起来真的非常的感谢那位学长,因为现在看个什么jekyll、sass等什么的官方文档,呵呵,感觉真的还是挺流畅的,毕竟这也是成为一名合格的程序员应该必须具备的技能。

简单概述一下我学习技术英文的过程吧:

  1. 刚开始就是把所有设备全部设置成英文的,然后遇到什么就查,做到了看英文不恐惧。

  2. 编程过程中,遇到问题的时候先用英文google,看不懂,就用中文。(也正是因为这样的方式,我领悟到了一个道理,但是花了差不多一年半的时间,下文会讲)

  3. 与此同时坚持每天半小时的中英文文档对译着看,一般都看翻译的比较好的书,比如现在在看css secret。

就酱,时间静悄悄地流逝,一下子就一年半了,突然我发现我可以“看懂”英文文档了。为什么打个引号呢,因为其实如果一年半之前我知道了一个道理,我当时一样是可以看懂的。

道理竟然如此的简单——英文和中文本质上都是语言对吧!语言就是用来指代事物的对吧!所以说英文和中文唯一的不同就是表达方式不同对吧!换汤不换药对吧!就算你数学是体育老师教的也应该明白多对一的映射吧(见下图)。

映射图

其实看英文看不懂的原因就是你没有理解而已,翻译成中文你也看不懂,所以如果看一份英文技术文档,自己翻译成中文后,还是看不懂,说明是你没理解,真的不要怪英文的问题。说明这份文档不是为你写的,所以你要做的就是看懂你能够看懂的,就换一份英文资料看,不要死磕到那里(这就和你追女神是一个道理,追不到就算了,不要吊死在那里)。要不你就和我一样,找一些相关的中文资料先看看再看英文,这样对你的毁灭性打击比较小,我这样做的原因是我看英文一般只是为了获得更加系统及最新的资料,而不是入门,对于入门来说,中文资料真的够。

举个例子 blog-aware 如果直译的话就是 博客-知道 ,我擦,什么鸟语,然后我就看到了 blog-aware 的解释是如下图,简单就是说jekyll会帮你生成一个静态博客,你只要负责写文章就好了。

blog-aware解释

所以,和上面一样,当你看到一个类似 blog-aware 之类的东西不懂,换一份资料看,说不定就讲的很清楚了,只写了 blog-aware 而没写相关解释的作者假设你已经懂了那个东西的解释了而已。

所以,只要你有基本的英语语法了,你就具备看懂英文技术文档的能力了,英文技术文档基本就没有什么复杂的时态、语态等,都是一些基础的语法,就算有,那一小部分也不足矣影响理解主要意思,不信的话,你可以问下自己一个问题——看中文文档你字字都看懂了吗?所以一般情况丢掉那一小部分就是,不要有完美主义。

有些道理呢就像一层薄纸,你不捅破呢就和捅破了的人在不同的一个世界,这就是李笑来老师经常说的一念一世界。

噢噢,一不小心你和我在一个世界了。。。

jeykll 文档为例开始实战

明白了上面这个道理之后,我们来进入今天的正题,如何看英文技术文档。

你是不是也和我一样,首先想一字不落的把文档都看一遍,然后记住,并且忘了之后接着又看了几遍,想考验一下自己的毅力?因为我们都是经过“科举考试”的人啦,考试不就是叫我们把书本记得滚瓜烂熟么,竟然还有个好听的名词,就做“理解记忆”。

很幸运,经过了多份文档的“磨练”之后,我发现有些地方不看也没有关系,咿呀,真的不用看耶,然后慢慢地我跳出了这个坑(我顿时就用一句古文来安慰一下自己——故天将降大任于斯人也,必先苦其心志,劳其胫骨...),并形成了自己的方法,文档真的不用记,知道文档哪里有什么东西,你能够在用到的时候知道查找就可以了(其实这个道理你一定听过,其实我早就听过了,但是那些说这个道理给我听的人,都和放屁一样,根本就不说怎么做,所以我决定写下此文,不再放屁),常用的东西用多了自然就记住了的,不常用的东西你记他干什么?我就是这样被害得到现在为止还是单身狗的,呵呵。

战斗开始,大胆地往前冲啊!!!

冲啊!!!

考察地形

打仗之前肯定要先考察一下地形嘛,肯定先要找到敌人的要害,然后一次性歼灭掉嘛。

jekyll官网首页

打开文档首页,上面的黄色字体就相当于敌人的一个个站点(一般就是链接到文档的不同页面的那几个不大不小的字),开始派侦察兵化为民众去侦查...

HOME

首页嘛,当然一般都会介绍下是个什么东西,干什么的,全部扫一扫。

Transform your plain text into static websites and blogs.,大标题就讲清楚了这个东西用来干什么,好,这一页就差不多了。

其它的Simple,Static,Blog-aware等讲特性的东西一般瞄一眼就好了,没必要深入看,一般都会吹吹牛什么的。

Get up and running in seconds.教我怎么快速运行起来。

最下面讲了host,部署。

好,看完了,过,下一个站点。

DOCS

DOCS 是 documents 的简称,一看就知道大概就是司令部了。

DOCS一进去就看到的首段内容

一进去Welcome 的第一段就说 This site aims to be a comprehensive guide to Jekyll. ,在看看右侧的索引就知道了,应该是司令部。

过,下一个站点。

NEWS

看看右边的索引,好像讲的是新版本发布相关新闻,可以,继续。

COMMUNITY

看看首段,扫扫下面文章的标题,哦,讲的是使用经验分享什么的东西。

可以,继续。

HELP

看了首句Need help with Jekyll? Try these resources.,扫扫下面的内容,讲的是遇到问题怎么解决的帮助信息。

继续。

VIEW ON GITHUB

VIEW ON GITHUB,点开一下就是github的仓库,源码什么的。

进攻司令部

经过上面考察地形之后,我发现了司令部了,DOCS,哈哈,噢耶 \(o)/。

DOCS进去的页面

首先一样看看右边的索引,GETTING STARTED这一部分是要稍微认真一点看的,因为这一部分基本上涉及到了这个技术的所有的内容,就相当于这个技术的全局轮廓图,只是没有涉及到具体的细节罢了,具体的细节具体用到查就行。

准备武器

先准备武器,“检视阅读法”,简单的介绍一下,真的很简单,真的很强大:看每一页的最上面的大标题下的那一小段文字,就能够知道这一页讲什么东西了;看每一段开头的一句或两句话,你就知道这一段讲的是什么内容了;然后看懂了,下面的内容就不看了,跳过——其实这就是为什么有些人说他看文档好快、看书好快,其实用的就是这个方法或者类似的东西。

上面的方法是不是小学老师就教过我们,但是真的直到大学才发现它如此强大呀,说来惭愧,哈哈。

举几个例子。

http://jekyllrb.com/docs/structure/

如上面的图片,看看stores configuration data. 第一句话就知道了,存储配置数据,然后就可以不用看后面的细节了,这里跳过的内容比较少。

http://jekyllrb.com/docs/templates/

看了filter一个字之后,过滤,什么鬼,再看看下面的第一行的例子就知道是干什么的呢,就不看了。这里跳的内容就比较多了,需要了查就行,如果你实在不记得文档有这个东西了,那就找google吧。

总之一个原则,看最少必要的内容,知道这里大概干什么的就够了,不要继续看了,只要能够通过他们知道了到哪里能够查找到什么内容就够了,也就是通过他们了解整个文档的全貌。

有些情况下,你根本不知道那里讲的是什么东西,毕竟是官方文档,为了显得比较专业,就喜欢把简单的东西用鸟语来描述,那就看过就好,知道那个名词,过,知道有那么个东西在就好。比如说开头的 blog-aware,看不懂,拉倒,看过就好,说不定下文就讲到了呢,或者你看的下一份资料。记住,就算看不懂,也要看看——为什么看不懂还要看呢?因为一个东西,你第一遍看不懂,那你就先学其它的,过几天,说不定再来看你就可以看懂了的,说不定是信息缺口或者是大脑需要消化时间呀。并且一个东西你不懂,存在疑惑,只要你认识他了,你的资料当中就会不知不觉的出现好多相关的资料,其实只是你平时没有注意罢了。

千万不要怕错过什么重要的内容,如果你真的错过了什么重要的内容,你的应用肯定就运行不了,运行不了肯定就会有相应的错误提示,有提示就可以google嘛,google了之后肯定就可以找到答案了的。

其实呢,看不懂那个东西其实从一定程度上说明你没有那个东西也没有关系,一样可以运行程序(运行不了就会是上段说的那样子),只是你现在没有那样的需求而已。既然这样,那你死磕啥呢!等到以后,等你想要某个需求功能的时候,但是呢在你看懂了的东西中没有,那就肯定是你没看懂的东西中的,这个时候你google下就好啦,到这个时候再来学习。记住,未知是永远存在的,不是所有的东西你都要弄懂的,学海无涯,带着一定的未知前行未尝不是一件好事,把时间花在对你最重要最紧急并且收益最大的事情上面。

对待这种疑惑,我一般有两种最法:1.这个东西是我常用的,我就会刻意持续地学习它,比如说chrome浏览器,我天天要用它,当然要好好学习嘛;2.不常用的东西,比如说这个jekyll,我就只是搭建我的简历和博客而已,能够写字和部署就够了,我就会遇到需求再来解决。

开始攻击

准备好武器了之后就可以开始攻击了。

依我有限的经验,像get started部分的内容,肯定要认真的看,只不过看不懂不要死磕就行,如文章开头讲的道理,这份资料不适合你,换。

其它的话像右边索引的第二大块 YOUR CONTENT 及以下的内容,就可以开始用“检视阅读法”。

最下面的什么 MISCELLANEOUSMETA ,如果和我一样是菜鸟的话,看看最上面标题下面的那一小段文字知道有那么个东西在就好了,很长一段时间基本上是用不到的。

开始:

  1. GETTING STARTED部分内容

    1. 首先扫一下全页的小标题,了解一下全页的逻辑,知道有什么东西。

    2. 然后开始看,看不懂的肯定有,查查不认的单词,能够翻译成不能够理解的中文就够了,过(道理上面讲过)。

    很快就可以看完了,内容不是很多。

  2. 重要的内容看完了,就开始用“检视阅读法”开始扫其它的内容了。

    1. 首先扫一下全页的小标题,了解一下全页的逻辑,知道有什么东西。

    2. 使用 "检视阅读法" 扫其它内容,看不懂的肯定有,查查不认的单词,能够翻译成不能够理解的中文就够了,过(道理上面讲过)。

战斗结束

就酱,6个番茄钟(2个半小时,6*25min),战斗就结束了,好爽,快速的看文档向来是一件让人很爽的事情。

小结

  1. 只要你具备了基本的英语语法和词汇,看英文和看中文是没有区别的,看不懂只是你没有理解而了,看不懂就换资料看就行了,不要害怕。

  2. 使用检视阅读法阅读文档(除了get started部分外)。

    1. 考察地形,找到司令部;

    2. 使用检视阅读法攻击司令部;

      注意:肯定会有东西你看不懂的,看过就好了,认识它就行了;

  3. 知道文档中哪里有什么之后,就可以休息了。

END.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,602评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,442评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,878评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,306评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,330评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,071评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,382评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,006评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,512评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,732评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,283评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2 345

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,510评论 25 707
  • 昨天,2016年12月23日我收到了15年来,第一份圣诞节礼物,来自我的高中班主任。 她94年生,和我们的年龄相差...
    cherry_yyq阅读 311评论 0 0
  • 在开发多页面程序时,需要使用到跳转功能,例如从一个�列表tableview A的某个单元格,跳转到另一个列表界面t...
    yytester阅读 1,872评论 0 0
  • 今天考试了,对象是小学一年级的学生,科目是道德与法治(前身是思想品德)。为什么这是一次充满笑声的考试,考试不是挺严...
    缘本简恋阅读 492评论 0 3
  • 元稹 残灯无焰影幢幢,此夕闻君谪九江。 垂死病中惊坐起,暗风吹雨入寒窗。
    那年我19阅读 219评论 2 0