Skip to content

Commit

Permalink
update footnotes from inline ^[footnote] to [^n]
Browse files Browse the repository at this point in the history
  • Loading branch information
yihui committed Feb 24, 2023
1 parent b6a8400 commit f518a9a
Show file tree
Hide file tree
Showing 115 changed files with 894 additions and 264 deletions.
1 change: 0 additions & 1 deletion config.yaml
Expand Up @@ -147,7 +147,6 @@ params:
- "center-img.js"
- "right-quote.js"
- "no-highlight.js"
- "fix-footnote.js"
- "math-code.js"
- "hash-notes.js"
- "toggle-notes.js"
Expand Down
29 changes: 23 additions & 6 deletions content/animation/_index.md
Expand Up @@ -4,18 +4,35 @@ subtitle: A gallery of animations in statistics and utilities to create animatio
date: 2017-02-04
---

This is an R package to create and export animations to a variety of formats (HTML/JS, GIF, Video, PDF), and it also serves as a gallery of animations related to statistics and computing. A detailed introduction can be found in the this paper:^[Please note that it was written in 2011, and some functions may have been renamed or changed. This website contains more up-to-date information.]
This is an R package to create and export animations to a variety of formats
(HTML/JS, GIF, Video, PDF), and it also serves as a gallery of animations
related to statistics and computing. A detailed introduction can be found in the
this paper:[^1]

- Yihui Xie (2013). _animation: An R Package for Creating Animations and Demonstrating Statistical Methods._ Journal of Statistical Software, 53(**1**), 1-27. URL http://www.jstatsoft.org/v53/i01/.
[^1]: Please note that it was written in 2011, and some functions may have been
renamed or changed. This website contains more up-to-date information.

![The Gradient Descent Algorithm](https://assets.yihui.org/figures/animation/example/grad-desc/demo-a.gif)
- Yihui Xie (2013). *animation: An R Package for Creating Animations and
Demonstrating Statistical Methods.* Journal of Statistical Software,
53(**1**), 1-27. URL <http://www.jstatsoft.org/v53/i01/>.

You can install the stable version from [CRAN](https://cran.rstudio.com/package=animation), or the development version from [GitHub](https://github.com/yihui/animation):
![The Gradient Descent
Algorithm](https://assets.yihui.org/figures/animation/example/grad-desc/demo-a.gif)

```r
You can install the stable version from
[CRAN](https://cran.rstudio.com/package=animation), or the development version
from [GitHub](https://github.com/yihui/animation):

``` r
install.packages('animation')
# or development version
# remotes::install_github('yihui/animation')
```

Bugs and feature requests can be filed via Github issues in the repo [**yihui/animation**](https://github.com/yihui/animation/issues). You are very welcome to contribute code via pull requests on Github, or help us write [examples](/animation/examples/) on this website. The full source of this website is available on Github in the repo [**yihui/yihui.org**](https://github.com/yihui/yihui.org). Please feel free to fork the repo and submit pull requests with your contributions.
Bugs and feature requests can be filed via Github issues in the repo
[**yihui/animation**](https://github.com/yihui/animation/issues). You are very
welcome to contribute code via pull requests on Github, or help us write
[examples](/animation/examples/) on this website. The full source of this
website is available on Github in the repo
[**yihui/yihui.org**](https://github.com/yihui/yihui.org). Please feel free to
fork the repo and submit pull requests with your contributions.
18 changes: 13 additions & 5 deletions content/cn/2006-03-06-18-42-00.md
Expand Up @@ -4,9 +4,9 @@ date: '2006-03-06T18:42:00+08:00'
slug: 18-42-00
---

今天下午本来在看SEM,后来觉得论文都太长, 有些看不下去,于是随便找了本书叫《智慧的灵光》(主编:宋建林)读一读,见到第一章的序言中主编对其中一篇文章作如此评价“法国博物学家布封,在法兰西学院为他举行的入院典礼上发表了著名的‘论风格的演说’,**这一演说可称之为传世经典,人们可以从中获得深刻的启迪**”,颇为好奇,于是仔细读了读,其间想起赵老师经常说的一句话:“……关键是对**问题**的理解”,笑笑,觉得和本文的主旨之一很相似。看来人生还是应该多经历和见识一些事情,思想境界才会有所提高。没想到布封这位研究毛毛虫的老头儿,在如何行文写作上谈到的观点也是相当中肯、独到。要是我用一句话来概括这篇演讲,则是**“行文须趋‘均值’于真理,且制‘方差’于定域”。**
今天下午本来在看SEM,后来觉得论文都太长, 有些看不下去,于是随便找了本书叫《智慧的灵光》(主编:宋建林)读一读,见到第一章的序言中主编对其中一篇文章作如此评价“法国博物学家布封,在法兰西学院为他举行的入院典礼上发表了著名的‘论风格的演说’,**这一演说可称之为传世经典,人们可以从中获得深刻的启迪**”,颇为好奇,于是仔细读了读,其间想起赵老师经常说的一句话:“……关键是对**问题**的理解”,笑笑,觉得和本文的主旨之一很相似。看来人生还是应该多经历和见识一些事情,思想境界才会有所提高。没想到布封这位研究毛毛虫的老头儿,在如何行文写作上谈到的观点也是相当中肯、独到。要是我用一句话来概括这篇演讲,则是 **“行文须趋‘均值’于真理,且制‘方差’于定域”。**

> **论风格的演说**^[布封于1753年6月23日当选为法兰西学士院院士,补已故院士桑思总主教兰格·碍·热尔日的遗缺;8月25日举行入院式。因演说内容是谈风格,所以后人称之为“论风格的演说”。]
> **论风格的演说**[^1]
> 作者:布封
Expand Down Expand Up @@ -36,16 +36,24 @@ slug: 18-42-00
>
> 还有些人喜欢运用纤巧的思想,追求那些轻飘的、无拘束的、不固定的概念,这种巧思妙想就和金箔一样,**只有在失去坚固性时才能获得光芒**,没有比这种巧思妙想的追求更违反真正雄辩的了。因此,作者在文章里把这种浅薄的、浮华的才调放得愈多,则文章就愈少筋骨,愈少光明,愈少热力,也愈没有风格;除非这种才调本身就是主题内容,作者本意只在谐滤,没有其他目标:这样说来,谈论小事物的艺术也许比谈论大事物的更困难了。
>
> 又有些人,呕尽心血,要把平常的或普通的事物,用独特的或铺张的方式表达出来,没有比这个更违反**自然美**的了;也没有比这个更降低作家品格的了。读者不仅不赞赏他,反而要可怜他:他竟花了这样多的工夫锤炼字句的新的音调,其目的无非讲一些人云亦云的话。这个毛病是那些富于学识修养然而精神贫瘠的人的毛病;这种人有的是字眼儿,却毫无思想;因此他们在字面上做工夫,他们排比了词句就自以为是组织了意思,他们歪曲了字义,因而败坏了语言,却自以为是纯化了语言。这种作家毫无风格,或者也可以说,只有风格的幻影。风格是应该**刻画**^[法文Style(风格)一词,源出拉丁语stilus(刻字刀),正如中国的“笔”是从“刀”演变而来的一样,所以“刻画”一词在这里用得非常恰当而有力。]思想的,而他们只晓得涂抹空言。
> 又有些人,呕尽心血,要把平常的或普通的事物,用独特的或铺张的方式表达出来,没有比这个更违反**自然美**的了;也没有比这个更降低作家品格的了。读者不仅不赞赏他,反而要可怜他:他竟花了这样多的工夫锤炼字句的新的音调,其目的无非讲一些人云亦云的话。这个毛病是那些富于学识修养然而精神贫瘠的人的毛病;这种人有的是字眼儿,却毫无思想;因此他们在字面上做工夫,他们排比了词句就自以为是组织了意思,他们歪曲了字义,因而败坏了语言,却自以为是纯化了语言。这种作家毫无风格,或者也可以说,只有风格的幻影。风格是应该**刻画**[^2]思想的,而他们只晓得涂抹空言。
>
> 所以,为了写得好,必须充分地掌握题材;必须对题材加以充分的思索,以便清楚地看出**思想的层次**,把思想构成一个连贯体,一根绵续不断的链条,每一个环节代表一个概念;并且,拿起了笔,还要使它遵循着这最初的链条,陆续前进,不使它离开线索,不使它忽轻忽重,笔的运行以它**所应到的范围**为度,不许它有其他的动作。风格的谨严在此,构成风格一致性的、调节风格徐疾速度的也在此;同时,这一点,也只要这一点,就够使风格确切而简练、匀整而明快、活泼而井然了。这是天才所制定的第一条规律,如果在遵守这一条规律之外,作者更能鉴别精微,审美正确,征词选字不惜**推敲**,时时留心只用最一般的^[“一般的”,原文是General;布封用这个字,是指平易近人,没有专门学识的人也能懂的辞语,同时也指最能表达事物的全部基本特性的辞语,下文所说的“一般性generalite”,“最一般的概念”,就是说“能概括而又深入浅出”。]词语来称呼事物,那么,风格就典雅了。如果作者再能不对他灵机初动的结果轻易信从,对一切华而不实的炫赫概予鄙弃,对模棱语、谐渡语经常加以嫌恶,那么,他的风格就庄重了,甚至就尊严了。最后,如果作者能怎样想就怎样写,如果他要说服人家的,他自己先深信不疑,则这种**不自欺的真诚**,就构成对别人的正确态度,就构成风格的真实性,这就能使文章产生它的全部效果了;不过,这也还需要不把内心深信的事物用过度的兴奋表示出来,还需要处处显得纯朴多于自信,理智多于热情。
> 所以,为了写得好,必须充分地掌握题材;必须对题材加以充分的思索,以便清楚地看出**思想的层次**,把思想构成一个连贯体,一根绵续不断的链条,每一个环节代表一个概念;并且,拿起了笔,还要使它遵循着这最初的链条,陆续前进,不使它离开线索,不使它忽轻忽重,笔的运行以它**所应到的范围**为度,不许它有其他的动作。风格的谨严在此,构成风格一致性的、调节风格徐疾速度的也在此;同时,这一点,也只要这一点,就够使风格确切而简练、匀整而明快、活泼而井然了。这是天才所制定的第一条规律,如果在遵守这一条规律之外,作者更能鉴别精微,审美正确,征词选字不惜**推敲**,时时留心只用最一般的[^3]词语来称呼事物,那么,风格就典雅了。如果作者再能不对他灵机初动的结果轻易信从,对一切华而不实的炫赫概予鄙弃,对模棱语、谐渡语经常加以嫌恶,那么,他的风格就庄重了,甚至就尊严了。最后,如果作者能怎样想就怎样写,如果他要说服人家的,他自己先深信不疑,则这种**不自欺的真诚**,就构成对别人的正确态度,就构成风格的真实性,这就能使文章产生它的全部效果了;不过,这也还需要不把内心深信的事物用过度的兴奋表示出来,还需要处处显得纯朴多于自信,理智多于热情。
>
> 上述各点,诸位先生,我读着你们的作品,仿佛你们就是这样对我说的,就是这样教导我的。我的心灵,它如饥如渴地吸取着你们这些至理名言,很想飞腾起来,达到你们的高度。然而,枉然!你们又告许我,规则不能代替天才;如果没有天才,规则是无用的。所谓写得好,就是同时又想得好,又感觉得好,又表达得好;同时又有智慧,又有心灵,又有审美力。风格必须有全部智力机能的配合与活动;只有意思能构成风格的内容,至于词语的和谐,它只是风格的附件,它只依赖着官能的感觉:只要耳朵灵敏一点就能避免字音的失调,只要多读诗人和演说家的作品,耳朵有了训练,精于审音,就会机械地趋向于摹仿诗的节奏和演说的语调。然而,摹仿从来也不能创造出什么;所以这种字句的和谐不能构成风格的内容,也不能构成风格的笔调,有些言之无物的作品,字句倒往往是铿锵动听的哩。
>
> 笔调不过是风格对题材性质的切合,一点也勉强不得;它是由内容的本质里自然而然地产生出来的,要看作者能否使他的**思想达到一般性的程度**来决定。如果作者能上升到最一般的概念,而对象本身又是伟大的,则笔调也就仿佛提到了同样的高度;并且,如果天才能一面把笔调维持在这高度上,一面又有足够的力量给予每一对象以强烈的光彩,如果作者能在素描的刚健上再加上色彩的绚丽,总之,如果作者能把每一概念都用活泼而又十分明确的形象表现出来,把每一套概念都构成一幅和谐而生动的图画,则笔调不仅是高超的,甚且是壮丽的。
>
> 说到这里,诸位先生,讲规则也许不如讲实际应用那样易于使人明了,举出实例来也许比空讲箴言更易使人获益;但是,我读着你们的著作时常使我眉飞色舞的那些壮丽的篇章,现在既不容许我——征引,我只好限于说出一些感想。只有写得好的作品才是能够传世的:作品里面所包含的知识之多,事实之奇,乃至发现之新颖,都不能成为不朽的确实保证;如果包含这些知识、事实与发现的作品只谈论些琐屑对象,如果他们写得无风致,无天才,毫不高雅,那么,它们就会是湮没无闻的,因为,知识、事实与发现都很容易脱离作品而转入别人手里,它们经更巧妙的手笔一写,甚至于会比原作还要出色些哩。这些东西都是身外物,**风格却就是本人**^[这是布纣的一句名言,在法国常被引用,也常被误解,因此有许多人把它释为“文如其人”。]。因此,风格既不能脱离作品,又不能转借,也不能变换;如果它是高超的,典雅的,壮丽的,则作者在任何时代都将被赞美;因为,只有真理是持久的,甚至是永恒的。我们知道,<FONT color=#f70909>一个优美的风格之所以优美,完全由于它所呈献出来的那些无量数的真理。它所包含的全部精神美,它所赖以组成的全部情节,都是真理,对于人类智慧来说,这些真理比起那些可以构成题材内容的真理,是同样有用,而且也许是更为宝贵。</FONT>
> 说到这里,诸位先生,讲规则也许不如讲实际应用那样易于使人明了,举出实例来也许比空讲箴言更易使人获益;但是,我读着你们的著作时常使我眉飞色舞的那些壮丽的篇章,现在既不容许我——征引,我只好限于说出一些感想。只有写得好的作品才是能够传世的:作品里面所包含的知识之多,事实之奇,乃至发现之新颖,都不能成为不朽的确实保证;如果包含这些知识、事实与发现的作品只谈论些琐屑对象,如果他们写得无风致,无天才,毫不高雅,那么,它们就会是湮没无闻的,因为,知识、事实与发现都很容易脱离作品而转入别人手里,它们经更巧妙的手笔一写,甚至于会比原作还要出色些哩。这些东西都是身外物,**风格却就是本人**[^4]。因此,风格既不能脱离作品,又不能转借,也不能变换;如果它是高超的,典雅的,壮丽的,则作者在任何时代都将被赞美;因为,只有真理是持久的,甚至是永恒的。我们知道,<FONT color=#f70909>一个优美的风格之所以优美,完全由于它所呈献出来的那些无量数的真理。它所包含的全部精神美,它所赖以组成的全部情节,都是真理,对于人类智慧来说,这些真理比起那些可以构成题材内容的真理,是同样有用,而且也许是更为宝贵。</FONT>
>
> 壮丽之美只有在伟大的题材里才能有。诗、历史和哲学都有同样的对象,并且是一个极伟大的对象,那就是**人与自然**。哲学讲述并描写自然;诗则绘画自然,并且加以美化:它也画人,加以放大,加以夸张,它创造出许多英雄和神抵。历史只画人,并且只画本来面目;因此,历史家只有在给最伟大的人物画像的时候,在叙述最伟大的行为、最伟大的运动、最伟大的革命的时候,笔调才变得壮丽;而在其他的一切场合,他的笔调只要尊严、庄重就够了。哲学家每逢讲自然规律、泛论万物的时候,述说空间、物质、运动与时间的时候,讲心灵、人类精神、情感、热情的时候,他的笔调是可以变得壮丽的。在其他场合,他的笔调但求能典雅、高超就够了。但是演说家与诗人,只要题材是伟大的,笔调就应该经常是壮丽的,因为他们是大师,他们能结合着题材的伟大性,恣意地加上许多色彩、许多波澜、许多幻象;并且也因为他们既然要经常渲染对象,放大对象,他们也就应该处处使用天才的全部力量,展开天才的全部幅度。
>
> --- (范希衡 译)
[^1]: 布封于1753年6月23日当选为法兰西学士院院士,补已故院士桑思总主教兰格·碍·热尔日的遗缺;8月25日举行入院式。因演说内容是谈风格,所以后人称之为“论风格的演说”。

[^2]: 法文Style(风格)一词,源出拉丁语stilus(刻字刀),正如中国的“笔”是从“刀”演变而来的一样,所以“刻画”一词在这里用得非常恰当而有力。

[^3]: “一般的”,原文是General;布封用这个字,是指平易近人,没有专门学识的人也能懂的辞语,同时也指最能表达事物的全部基本特性的辞语,下文所说的“一般性generalite”,“最一般的概念”,就是说“能概括而又深入浅出”。

[^4]: 这是布纣的一句名言,在法国常被引用,也常被误解,因此有许多人把它释为“文如其人”。

0 comments on commit f518a9a

Please sign in to comment.