fix tables and use @repl

Author: Rratic

docs/advanced/ccall.md

@@ -7,11 +7,9 @@
 原型是 `ccall((function_name, library), returntype, (argtype1, ...), argvalue1, ...)` 或 `ccall(function_name, returntype, (argtype1, ...), argvalue1, ...)` 或 `ccall(function_pointer, returntype, (argtype1, ...), argvalue1, ...)`，其中 library 是库的路径；每个 `argvalue` 会通过 `unsafe_convert(argtype, cconvert(argtype, argvalue))` 转化为 `argtype` 类型实例。
 
 调用 C 标准库的示例（需注意，这些函数大多在 `Libc` 模块中已有，无需自己 ccall）
-```julia-repl
-julia> ccall(:srand, Cvoid, (Cint,), 0)
-
-julia> ccall(:rand, Cint, ())
-38
+```@repl
+ccall(:srand, Cvoid, (Cint,), 0)
+ccall(:rand, Cint, ())
 ```
 
 一个调用 [windows api](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getcursorpos) 获取鼠标指针位置的示例：
@@ -33,11 +31,9 @@ Point(681, 404)
 
 ## @ccall
 原型是 `@ccall library.function_name(argvalue1::argtype1, ...)::returntype` 或 `@ccall function_name(argvalue1::argtype1, ...)::returntype` 或 `@ccall $function_pointer(argvalue1::argtype1, ...)::returntype`
-```julia-repl
-julia> @ccall srand(0::Cint)::Cvoid
-
-julia> @ccall rand()::Cint
-38
+```@repl
+@ccall srand(0::Cint)::Cvoid
+@ccall rand()::Cint
 ```
 
 ## 参阅

docs/advanced/expr.md

@@ -3,15 +3,10 @@
 
 第一：一个标识表达式类型的 `head` 类型为 `Symbol`，是一个 [interned string](https://en.wikipedia.org/wiki/String_interning) 标识符（下面会有更多讨论）
 
-```julia-repl
-julia> ex1 = Meta.parse("1 + 1")
-:(1 + 1)
-
-julia> typeof(ex1)
-Expr
-
-julia> ex1.head
-:call
+```@repl
+ex1 = Meta.parse("1 + 1")
+typeof(ex1)
+ex1.head
 ```
 
 第二：参数 `args`，可能是符号、其他表达式或字面量：
@@ -25,9 +20,8 @@ julia> ex1.args
 ```
 
 表达式也可能直接用前置表达式形式构造：
-```julia-repl
-julia> ex2 = Expr(:call, :+, 1, 1)
-:(1 + 1)
+```@repl
+ex2 = Expr(:call, :+, 1, 1)
 ```
 
 上面构造的两个表达式————一个通过解析构造一个通过直接构造————是等价的：
@@ -48,9 +42,8 @@ Expr
 ```
 
 `Expr` 对象也可以嵌套：
-```julia-repl
-julia> ex3 = Meta.parse("(4 + 4) / 2")
-:((4 + 4) / 2)
+```@repl
+ex3 = Meta.parse("(4 + 4) / 2")
 ```
 
 另外一个查看表达式的方法是使用 `Meta.show_sexpr`，它能显示给定 `Expr` 的 [S-expression](https://en.wikipedia.org/wiki/S-expression)，对 Lisp 用户来说，这看着很熟悉。下面是一个示例，阐释了如何显示嵌套的 `Expr`：
@@ -219,33 +212,19 @@ end
 
 ### QuoteNode
 `quote` 形式在 AST 中通常表示为一个 head 为 `:quote` 的 `Expr`
-```julia-repl
-julia> dump(Meta.parse(":(1+2)"))
-Expr
-  head: Symbol quote
-  args: Array{Any}((1,))
-    1: Expr
-      head: Symbol call
-      args: Array{Any}((3,))
-        1: Symbol +
-        2: Int64 1
-        3: Int64 2
+```@repl
+dump(Meta.parse(":(1+2)"))
 ```
 
 正如我们所看到的，这些表达式支持插值符号 `$`。但是，在某些情况下，需要在*不执行*插值的情况下引用代码。这种引用还没有语法，但在内部表示为 `QuoteNode` 类型的对象：
-```julia-repl
-julia> eval(Meta.quot(Expr(:$, :(1+2))))
-3
-
-julia> eval(QuoteNode(Expr(:$, :(1+2))))
-:($(Expr(:$, :(1 + 2))))
+```@repl
+eval(Meta.quot(Expr(:$, :(1+2))))
+eval(QuoteNode(Expr(:$, :(1+2))))
 ```
 
 解析器为简单的引用项（如符号）生成 `QuoteNode`：
-```julia-repl
-julia> dump(Meta.parse(":x"))
-QuoteNode
-  value: Symbol x
+```@repl
+dump(Meta.parse(":x"))
 ```
 
-`QuoteNode` 也可用于某些高级的元编程任务
+`QuoteNode` 也可用于某些高级的元编程任务。

docs/advanced/function.md

@@ -15,7 +15,7 @@ julia> f = +; f(1, 2, 3)
 ## 具有特殊名称的操作符
 有一些特殊的表达式对应的函数调用没有显示的函数名称
 | 表达式 | 函数调用 |
-| --- | --- |
+| :-: | :-: |
 | `[A B C ...]` | `hcat` |
 | `[A; B; C; ...]` | `vcat` |
 | `[A B; C D; ...]` | `hvcat` |

docs/advanced/io.md

@@ -18,15 +18,10 @@
 ## IO缓冲区
 `Base.GenericIOBuffer` 可以将数组作为缓冲区进行包裹。
 `IOBuffer` 可以用于快速生成一个 `Base.GenericIOBuffer{Vector{UInt8}}` 实例，这可以方便地将常用数据包裹成 I/O
-```julia-repl
-julia> buf = IOBuffer()
-IOBuffer(data=UInt8[...], readable=true, writable=true, seekable=true, append=false, size=0, maxsize=Inf, ptr=1, mark=-1)
-
-julia> write(buf, "foo")
-3
-
-julia> String(take!(buf))
-"foo"
+```@repl
+buf = IOBuffer()
+write(buf, "foo")
+String(take!(buf))
 ```
 
 ## 管道
@@ -40,7 +35,7 @@ julia> String(take!(buf))
 
 ## 通用函数
 | 名称 | 描述 |
-| --- | --- |
+| :-: | :-: |
 | `read(io::IO, T)` | 从 `io` 中读取 `T` 类型的单个值，使用标准二进制表示，需手动使用 `ntoh`，`ltoh` 调整[大小端](https://www.ruanyifeng.com/blog/2022/06/endianness-analysis.html) |
 | `read(io::IO, String)` | 将整个 `io` 作为字符串读入 |
 | ` read(s::IO, nb=typemax(Int))` | 从 `s` 中读入最多 `nb` 个字符，返回 `Vector{UInt8}` 实例 |

docs/advanced/iteration.md

@@ -4,68 +4,40 @@
 
 `eachindex` 通常用于得到数组索引的合适遍历工具。它比使用 `1:length(A)` 兼容性更强，因为 `1:length(A)` 不适用于多维数组、数组 `view` 及其它包可能出现的数组（如索引不从 1 开始的数组）。
 
-```julia-repl
-julia> A = [10 20; 30 40];
-
-julia> for i in eachindex(A)
-           println("A[", i, "] == ", A[i])
-       end
-A[1] == 10
-A[2] == 30
-A[3] == 20
-A[4] == 40
+```@repl
+A = [10 20; 30 40];
+
+for i in eachindex(A)
+    println("A[", i, "] == ", A[i])
+end
 ```
 
 使用 `enumerate` 遍历物品时，得到的值是一对 `(i, v)`，其中 `i` 是从 1 开始的计数器，`v` 是正常遍历物品得到的值。
 
-```julia-repl
-julia> a = ["a", "b", "c"];
-
-julia> for (index, balue) in enumerate(a)
-           println("a[$index] = $value")
-       end
-ERROR: UndefVarError: `value` not defined in `Main`
-Suggestion: check for spelling errors or missing imports.
-Stacktrace:
- [1] top-level scope
-   @ .\REPL[30]:2
-
-julia> for (index, value) in enumerate(a)
-           println("a[$index] = $value")
-       end
-a[1] = a
-a[2] = b
-a[3] = c
-```
-
-`zip` 可用于合并多个可遍历的物品，一直遍历直到其中一个到达末尾。
-```julia-repl
-julia> z = zip(1:3, "abcde")
-zip(1:3, "abcde")
+```@repl
+a = ["a", "b", "c"];
 
-julia> length(z)
-3
+for (index, balue) in enumerate(a)
+    println("a[$index] = $value")
+end
 
-julia> first(z)
-(1, 'a')
+for (index, value) in enumerate(a)
+    println("a[$index] = $value")
+end
+```
 
-julia> collect(z)
-3-element Vector{Tuple{Int64, Char}}:
- (1, 'a')
- (2, 'b')
- (3, 'c')
+`zip` 可用于合并多个可遍历的物品，一直遍历直到其中一个到达末尾。
+```@repl
+z = zip(1:3, "abcde")
+length(z)
+first(z)
+collect(z)
 ```
 
 `filter` 用于生成满足特定要求的迭代器，需注意在使用时不与导出的另一个 `filter` 混淆
-```julia-repl
-julia> f = Iterators.filter(isodd, [1, 2, 3, 4, 5])
-Base.Iterators.Filter{typeof(isodd), Vector{Int64}}(isodd, [1, 2, 3, 4, 5])
-
-julia> collect(f)
-3-element Vector{Int64}:
- 1
- 3
- 5
+```@repl
+f = Iterators.filter(isodd, [1, 2, 3, 4, 5])
+collect(f)
 ```
 
 ## 自定义
@@ -91,57 +63,24 @@ end
 ```
 
 这是一个自定义的样例：
-```julia
+```@repl
 struct n3
-	v::Int
+    v::Int
 end
 
 function Base.iterate(i::n3, n::Int=i.v) # 第一次调用时不会有第二个参数
-	if n==1
-		return nothing # 表示结束
-	end
-	v= n&1==0 ? n>>1 : n*3+1
-	return (v, v) # (返回值,下一个状态（作为第二个参数）)
+    if n == 1
+        return nothing # 表示结束
+    end
+    v= n&1==0 ? n>>1 : n*3+1
+    return (v, v) # (返回值, 下一个状态)
+end
+
+for i in n3(10)
+    println(i, ' ')
 end
 
-julia> for i in n3(10)
-           println(i, ' ')
-       end
-5
-16
-8
-4
-2
-1
-
-julia> [n3(27)...]
-111-element Vector{Int64}:
-  82
-  41
- 124
-  62
-  31
-  94
-  47
- 142
-  71
- 214
- 107
- 322
- 161
-   ⋮
-  53
- 160
-  80
-  40
-  20
-  10
-   5
-  16
-   8
-   4
-   2
-   1
+[n3(27)...]
 ```
 
 [^1]: https://docs.juliacn.com/latest/manual/interfaces

docs/advanced/mime.md

@@ -12,29 +12,19 @@ MIME 的通用格式是 `type/subtype`
 
 ## 类型
 Julia 中有两种方式分别创建 MIME 类型和 MIME 类型的值。
-```julia-repl
-julia> type = MIME"text/plain"
-MIME{Symbol("text/plain")}
-
-julia> value = MIME("text/plain")
-MIME type text/plain
-
-julia> isa(value, type)
-true
+```@repl
+type = MIME"text/plain"
+value = MIME("text/plain")
+isa(value, type)
 ```
 
 ## 多媒体显示
 MIME 被允许作为 [`show`](typesystem.md#自定义显示) 的第二个参数，用于控制输出格式。
 
 例如，在纯文本环境下可以选择不同的文本格式类型
-```julia-repl
-julia> show(stdout, MIME("text/plain"), [1 2;3 4])
-2×2 Matrix{Int64}:
- 1  2
- 3  4
-julia> show(stdout, MIME("text/csv"), [1 2;3 4])
-1,2
-3,4
+```@repl
+show(stdout, MIME("text/plain"), [1 2;3 4])
+show(stdout, MIME("text/csv"), [1 2;3 4])
 ```
 
 ## 参阅