revise index

DreamAndDead · DreamAndDead · commit 203cc20b5393 · 2021-05-25T21:55:48.000+08:00
diff --git a/Makefile b/Makefile
@@ -35,11 +35,9 @@ lex:
 	gdb -batch -x lex.gdb --args ./lua-5.1.5/src/luac $(source)
 	rm luac.out
 
-publish:
-	emacs -u "$(id -un)" --batch --eval '(load user-init-file)' --load publish.el --funcall org-publish-all
-
-server:
-	python -m http.server -d docs 8000
+serve:
+	xdg-open http://localhost:1313/lua-5.1-source-guide/
+	(cd site; hugo server -D; cd ..)
 
 draw:
 	asy -f pdf -pdfviewer="okular" -batchView -tex xelatex
diff --git a/book/.dir-locals.el b/book/.dir-locals.el
@@ -0,0 +1 @@
+((org-mode . ((eval . (org-hugo-auto-export-mode)))))
diff --git a/book/index/index.org b/book/index/index.org
@@ -1,3 +1,6 @@
+# don't export TODO section
+#+options: tasks:nil
+
 #+hugo_base_dir: ~/project/lua51/site/
 #+hugo_section: .
 #+hugo_front_matter_format: yaml
@@ -8,19 +11,52 @@
 #+title: lua 5.1 source guide
 #+date: <2020-12-21 一 09:35>
 
-| subject   | desc         | progress |
-|-----------+--------------+----------|
-| overview  | 全书总览     |      70% |
-| object    | 关键数据结构 |      90% |
-| memory    | 内存分配     |     100% |
-| string    | 字符串       |     100% |
-| table     | 表           |      80% |
-| lexer     | 词法分析     |     100% |
-| opcode    | 字节码       |     100% |
-| parser    | 语法分析     |     100% |
-| generator | 字节码生成   |      80% |
-| vm        | 虚拟机       |      80% |
-| c api     | 外部 api     |      70% |
-| stdlib    | 标准库       |     100% |
-| gc        | gc 模块      |      70% |
+这是一本关于 lua 5.1 源代码的小书。
+主要探索 lua 源代码，从中研究 lua 语言的内部实现。
+
+起因是出于好奇和乐趣，同时希望对其它 source reader 有所启发。
+
+
+lua 本身虽然只有几万行代码，但是将其所有细节都描述清楚还是要花费不少篇幅。
+而且我也不自信自己的文字能力能将其含义描述清楚。
+
+所以在本书中，
+- 根据 2/8 原则，关注重点部分
+- 一图胜千言，尽量使用图解
+- 其余相关源代码，作为读者的练习
+
+
+每一本书都有适合的读者，本书也是如此。
+
+希望读者你
+- 使用过 lua 语言，了解 lua
+- 了解 Linux 基础使用
+- 熟悉 C 语言
+
+因为本书就是建立在相应的前提下书写的。
+
+* TODO progress
+
+  修订原则
+  - 保留重点
+  - 去除不重要的部分
+
+| subject   | desc         | progress | revise |
+|-----------+--------------+----------+--------|
+| index     | 首页         |      10% | - 补充   |
+|-----------+--------------+----------+--------|
+| overview  | 全书总览     |      70% |        |
+|-----------+--------------+----------+--------|
+| object    | 关键数据结构 |      90% |        |
+| memory    | 内存分配     |     100% |        |
+| string    | 字符串       |     100% |        |
+| table     | 表           |      80% |        |
+| lexer     | 词法分析     |     100% |        |
+| opcode    | 字节码       |     100% |        |
+| parser    | 语法分析     |     100% |        |
+| generator | 字节码生成   |      80% |        |
+| vm        | 虚拟机       |      80% |        |
+| c api     | 外部 api     |      70% |        |
+| stdlib    | 标准库       |     100% |        |
+| gc        | gc 模块      |      70% |        |
 
diff --git a/book/overview/overview.org b/book/overview/overview.org
@@ -5,32 +5,6 @@
 #+title: overview
 #+date: <2020-12-21 一 10:40>
 
-* goal
-
-这是一本关于 lua 5.1 源代码的小书。
-主要探索 lua 源代码，从中研究 lua 语言的内部实现。
-
-起因是出于好奇和乐趣，同时希望对其它 source reader 有所启发。
-
-
-lua 本身虽然只有几万行代码，但是将其所有细节都描述清楚还是要花费不少篇幅。
-而且我也不自信自己的文字能力能将其含义描述清楚。
-
-所以在本书中，
-- 根据 2/8 原则，关注重点部分
-- 一图胜千言，尽量使用图解
-- 其余相关源代码，作为读者的练习
-
-
-每一本书都有适合的读者，本书也是如此。
-
-希望读者你
-- 使用过 lua 语言，了解 lua
-- 了解 Linux 基础使用
-- 熟悉 C 语言
-
-因为本书就是建立在相应的前提下书写的。
-
 * project
 
 ** file structure
@@ -156,7 +130,6 @@ diff -ur /home/manjaro/temp/ChunkSpy-0.9.8/5.1/ChunkSpy.lua ../tool/ChunkSpy-0.9
 在进行本书编写过程中，借鉴了其中的思想，使用 gdb 提供的 python api，
 编写了 =helper.py= 来辅助显示数据结构。
 
-
 ** usage
 
  在分析代码的过程，经常使用一些分析过程，全部整理在 =Makefile= 中。
@@ -214,7 +187,6 @@ diff -ur /home/manjaro/temp/ChunkSpy-0.9.8/5.1/ChunkSpy.lua ../tool/ChunkSpy-0.9
 
  使用 ChunkSpy 分析文件
 
-
 *** debug
 
  #+begin_example
@@ -237,7 +209,6 @@ diff -ur /home/manjaro/temp/ChunkSpy-0.9.8/5.1/ChunkSpy.lua ../tool/ChunkSpy-0.9
 
  在本地开启 [[http://localhost:8000][http server]]，阅读生成的 html 文件
 
-
 * big picture
 
 ** source file
diff --git a/book/todo/todo.org b/book/todo/todo.org
@@ -1,4 +1,4 @@
-#+SETUPFILE: setup.org
+#+SETUPFILE: ../setup.org
 
 #+TITLE: todo
 #+DATE: <2021-01-22 五 10:52>
@@ -12,14 +12,9 @@
 gdb script helper.py 的功能，未介绍
 
 
-缺少整体的阅读版面设计
-
-
 源代码引用，文件名部分依然是 listing n 格式
 
 
-
-单独的 publish.el 配置，不依赖 .emacs.d
 依赖的其它图片工具
 
 
@@ -32,3 +27,6 @@ userdata 未讲解
 weaktable newproxy 未讲解
 
 
+** how ~RE = NFA = DFA~
+
+** how scanner generator works (table driven / if else driven)
diff --git a/site/config.toml b/site/config.toml
@@ -14,6 +14,16 @@ defaultContentLanguage = 'zh'
   unsafe = true
 [markup.tableOfContents]
   startLevel = 1
+[markup.highlight]
+    codeFences = true
+    guessSyntax = false
+    hl_Lines = ""
+    lineNoStart = 1
+    lineNos = false
+    lineNumbersInTable = true
+    noClasses = true
+    style = "perldoc"
+    tabWidth = 4
 
 # Multi-lingual mode config
 # There are different options to translate files
diff --git a/site/content/_index.md b/site/content/_index.md
@@ -2,22 +2,30 @@
 title: "lua 5.1 source guide"
 author: ["DreamAndDead"]
 date: 2020-12-21T09:35:00+08:00
-lastmod: 2021-02-23T10:44:45+08:00
+lastmod: 2021-05-25T21:50:03+08:00
 draft: false
 ---
 
-| subject   | desc   | progress |
-|-----------|--------|----------|
-| overview  | 全书总览 | 70%      |
-| object    | 关键数据结构 | 90%      |
-| memory    | 内存分配 | 100%     |
-| string    | 字符串 | 100%     |
-| table     | 表     | 80%      |
-| lexer     | 词法分析 | 100%     |
-| opcode    | 字节码 | 100%     |
-| parser    | 语法分析 | 100%     |
-| generator | 字节码生成 | 80%      |
-| vm        | 虚拟机 | 80%      |
-| c api     | 外部 api | 70%      |
-| stdlib    | 标准库 | 100%     |
-| gc        | gc 模块 | 70%      |
+这是一本关于 lua 5.1 源代码的小书。
+主要探索 lua 源代码，从中研究 lua 语言的内部实现。
+
+起因是出于好奇和乐趣，同时希望对其它 source reader 有所启发。
+
+lua 本身虽然只有几万行代码，但是将其所有细节都描述清楚还是要花费不少篇幅。
+而且我也不自信自己的文字能力能将其含义描述清楚。
+
+所以在本书中，
+
+-   根据 2/8 原则，关注重点部分
+-   一图胜千言，尽量使用图解
+-   其余相关源代码，作为读者的练习
+
+每一本书都有适合的读者，本书也是如此。
+
+希望读者你
+
+-   使用过 lua 语言，了解 lua
+-   了解 Linux 基础使用
+-   熟悉 C 语言
+
+因为本书就是建立在相应的前提下书写的。
diff --git a/site/content/docs/overview/index.md b/site/content/docs/overview/index.md
@@ -2,37 +2,10 @@
 title: "overview"
 author: ["DreamAndDead"]
 date: 2020-12-21T10:40:00+08:00
-lastmod: 2021-02-23T10:50:45+08:00
+lastmod: 2021-05-25T21:50:41+08:00
 draft: false
 ---
 
-## goal {#goal}
-
-这是一本关于 lua 5.1 源代码的小书。
-主要探索 lua 源代码，从中研究 lua 语言的内部实现。
-
-起因是出于好奇和乐趣，同时希望对其它 source reader 有所启发。
-
-lua 本身虽然只有几万行代码，但是将其所有细节都描述清楚还是要花费不少篇幅。
-而且我也不自信自己的文字能力能将其含义描述清楚。
-
-所以在本书中，
-
--   根据 2/8 原则，关注重点部分
--   一图胜千言，尽量使用图解
--   其余相关源代码，作为读者的练习
-
-每一本书都有适合的读者，本书也是如此。
-
-希望读者你
-
--   使用过 lua 语言，了解 lua
--   了解 Linux 基础使用
--   熟悉 C 语言
-
-因为本书就是建立在相应的前提下书写的。
-
-
 ## project {#project}
 
 
@@ -373,14 +346,6 @@ lua 源代码 make 之后，生成两个可执行文件
 这即是上文中两个程序分别称为编译器 和 解释器 的命名来源，以后的行文中也使用这种约定。
 
 
-### <span class="org-todo todo TODO">TODO</span> a little tour {#a-little-tour}
-
-chain all subject
-
--   big picture of internal
--   talk about lua state and global state, state scope
-
-
 ## practice {#practice}
 
 -   按照 [source file](#source-file) 章节中提到的文件顺序，粗略浏览所有代码
diff --git a/site/resources/_gen/assets/scss/lua-5.1-source-guide/book.scss_50fc8c04e12a2f59027287995557ceff.content b/site/resources/_gen/assets/scss/lua-5.1-source-guide/book.scss_50fc8c04e12a2f59027287995557ceff.content
diff --git a/site/resources/_gen/assets/scss/lua-5.1-source-guide/book.scss_50fc8c04e12a2f59027287995557ceff.json b/site/resources/_gen/assets/scss/lua-5.1-source-guide/book.scss_50fc8c04e12a2f59027287995557ceff.json

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+((org-mode . ((eval . (org-hugo-auto-export-mode)))))`