add new docs

tyrchen · Dec 2, 2014 · 5153002 · 5153002
1 parent d09f1d2
commit 5153002
Show file tree

Hide file tree

Showing 20 changed files with 187 additions and 4 deletions.
diff --git a/assets/custom.css b/assets/custom.css
@@ -1,4 +1,4 @@
-img {
+img.cover {
 	width: 700px;
 }
 

diff --git a/docs/begin.scrbl → docs/01-begin.scrbl b/docs/begin.scrbl → docs/01-begin.scrbl
diff --git a/docs/02-basics.scrbl b/docs/02-basics.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "basics"]{Racket语言概要}
+
+Hello world!
diff --git a/docs/03-practical-program.scrbl b/docs/03-practical-program.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "practical-program"]{写点有意义的代码}
+
+Hello world!
diff --git a/docs/04-advanced-racket.scrbl b/docs/04-advanced-racket.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "advanced-racket"]{Racket语言进阶}
+
+Hello world!
diff --git a/docs/05-plotting.scrbl b/docs/05-plotting.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "plotting"]{用Racket作图}
+
+Hello world!
diff --git a/docs/06-scribble.scrbl b/docs/06-scribble.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "scribble"]{用Racket写作}
+
+Hello world!
diff --git a/docs/07-package-system.scrbl b/docs/07-package-system.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "package-system"]{Racket包管理}
+
+Hello world!
diff --git a/docs/08-macro.scrbl b/docs/08-macro.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "macro"]{可爱的宏}
+
+Hello world!
diff --git a/docs/09-advanced-macro.scrbl b/docs/09-advanced-macro.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "advanced-macro"]{用宏来设计你的语言}
+
+Hello world!
diff --git a/docs/10-continuation.scrbl b/docs/10-continuation.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "continuation"]{延迟计算}
+
+Hello world!
diff --git a/docs/11-server.scrbl b/docs/11-server.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "server"]{用Racket编写服务器程序}
+
+Hello world!
diff --git a/docs/12-web.scrbl b/docs/12-web.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "web"]{用Racket做Web开发}
+
+Hello world!
diff --git a/docs/13-real-world.scrbl b/docs/13-real-world.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "real-world"]{使用Racket撰写复杂的系统}
+
+Hello world!
diff --git a/docs/14-misc.scrbl b/docs/14-misc.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "misc"]{Racket的其它特性}
+
+本章讲述slideshow
diff --git a/docs/15-typed-racket.scrbl b/docs/15-typed-racket.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "typed-racket"]{下一站：Typed Racket}
+
+Hello world!
diff --git a/docs/16-further-readings.scrbl b/docs/16-further-readings.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "further-readings"]{下一步该学什么？}
+
+Hello world!
diff --git a/docs/postscript.scrbl b/docs/postscript.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "postscript"]{结语 - goodbye my friend}
+
+Hello world!
diff --git a/docs/preface.scrbl b/docs/preface.scrbl
@@ -0,0 +1,9 @@
+#lang scribble/doc
+
+@(require (for-label racket)
+          scribble/manual
+          "../util/common.rkt")
+
+@title[#:tag "preface"]{前言 - hello world!}
+
+Hello world!
diff --git a/index.scrbl b/index.scrbl
@@ -12,13 +12,43 @@
 @author[@(book-author racket-book)]
 
 
-@image[@(book-cover racket-book)]
+@image[@(book-cover racket-book) #:style "cover"]
 @para[@smaller{@(book-copyright racket-book)}]
 @para[@smaller[@(book-last-update racket-book)]]
 @para{如果您发现本书的任何问题，请在 @hyperlink["https://github.com/tyrchen/racket-book/issues" "该书的github项目上提交问题单，多谢！"].}
 
+这是一本关于racket的入门书。程序君在学习racket的过程中，发现racket的中文资料几乎为零，于是萌生了撰写这本书的想法。写这本书，某种程度上是出于私利，因为我一直认为最好的学习方法就是将自己学到的东西教授出去。在教授的过程中，自己能够学得更扎实。
 
-@table-of-contents[]
+于是，在学了racket也就一个周末之后，我开了这个repo，来记录和传授我学习racket的心得。撰写这本书，并不意味着我对racket的掌握有什么过人之处，恰恰相反，我和打算起步的你一样，不断挣扎于对这门语言的理解。
+
+由于racket提供了 @hyperlink["http://docs.racket-lang.org/scribble/" "scribble"]这门专门用于撰写文档的语言，所以这本书也一反我的习惯，没用 markdown 或 asciidoc 撰写，而是全部用 scribble 完成。使用scribble的体验很好，在这个过程中，它也激励我使用racket去解决一些实际的问题。是的，如果你浏览这个repo的源码，你会发现，racket并非一个「花瓶」语言，只能用于去理解一些高深的宏编程或者函数式编程的思想，而是一门很实用的工具，可以做几乎任何通用语言（如python）能做的事情。
+
+由于本书面向初学者，所以，如果你顺着读下来发现有些概念或者知识没有解释清楚，请向我提出，以便我修订。文中出现的任何问题，也欢迎大家提bug。
+
+你可以通过 http://racket.tchen.me/ 访问本书的最新版本。
+
+如果你觉得这本书对你有帮助，你可以扫描下面的二维码「打赏」程序君 ^_^
+
+@image["assets/images/weixin10.jpg"]
+
+@; table-of-contents[]
 
 @; -------------------------------------------------
-@include-section[ "docs/begin.scrbl"]
+@; include-section["docs/preface.scrbl"]
+@include-section["docs/01-begin.scrbl"]
+@include-section["docs/02-basics.scrbl"]
+@include-section["docs/03-practical-program.scrbl"]
+@include-section["docs/04-advanced-racket.scrbl"]
+@include-section["docs/05-plotting.scrbl"]
+@include-section["docs/06-scribble.scrbl"]
+@include-section["docs/07-package-system.scrbl"]
+@include-section["docs/08-macro.scrbl"]
+@include-section["docs/09-advanced-macro.scrbl"]
+@include-section["docs/10-continuation.scrbl"]
+@include-section["docs/11-server.scrbl"]
+@include-section["docs/12-web.scrbl"]
+@include-section["docs/13-real-world.scrbl"]
+@include-section["docs/14-misc.scrbl"]
+@include-section["docs/15-typed-racket.scrbl"]
+@include-section["docs/16-further-readings.scrbl"]
+@include-section["docs/postscript.scrbl"]