Skip to content

Commit 3fdb778

Browse files
committed
docs: fix strange words
1 parent e47716c commit 3fdb778

10 files changed

Lines changed: 26 additions & 25 deletions

File tree

docs/advanced/typesystem.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -151,10 +151,13 @@ primitive type «名称» <: «上级抽象类型» «位数» end
151151
`Bool``Int8``UInt8` 类型都具有相同的表现形式:它们都是 8 位内存块。然而,由于 Julia 的类型系统是主格的,它们尽管具有相同的结构,但不是通用的。它们之间的一个根本区别是它们具有不同的超类型。
152152

153153
## 复合类型
154-
复合类型在各种语言中被称为 `record``struct``object``class`等等。复合类型是命名字段的集合,其实例可以视为单个值。复合类型在许多语言中是唯一一种用户可定义的类型,也是 Julia 中最常用的用户定义类型。\
155-
在主流的面向对象语言中,比如 C++、Java、Python 和 Ruby,复合类型也具有与它们相关的命名函数,并且该组合称为「对象」。在纯粹的面向对象语言中,例如 Ruby 或 Smalltalk,所有值都是对象,无论它们是否为复合类型。在不太纯粹的面向对象语言中,包括 C++ 和 Java,一些值,比如整数和浮点值,不是对象,而用户定义的复合类型是具有相关方法的真实对象。\
156-
在 Julia 中,所有值都是对象,但函数不与它们操作的对象捆绑在一起。这是必要的,因为 Julia 通过多重派发选择函数使用的方法,这意味着在选择方法时考虑*所有*函数参数的类型,而不仅仅是第一个(有关方法和派发的更多信息,请参阅[方法](method.md))。因此,函数仅仅「属于」它们的第一个参数是不合适的。将方法组织到函数对象中而不是在每个对象「内部」命名方法最终成为语言设计中一个非常有益的方面\
157-
复合类型可以是`可变(mutable)``不可变(immutable)`的,相关详细信息在[一个单独章节](struct.md)
154+
复合类型在各种语言中被称为 `record``struct``object``class` 等等。复合类型是命名字段的集合,其实例可以视为单个值。复合类型在许多语言中是唯一一种用户可定义的类型,也是 Julia 中最常用的用户定义类型。
155+
156+
在主流的面向对象语言(如 C++、Java、Python、Ruby 中)复合类型也具有与它们相关的命名函数,并且该组合称为「对象」。在纯粹的面向对象语言(如 Ruby、Smalltalk)中所有值都是对象,无论它们是否为复合类型。在不太纯粹的面向对象语言中,包括 C++ 和 Java,一些值,比如整数和浮点值,不是对象,而用户定义的复合类型是具有相关方法的真实对象。
157+
158+
在 Julia 中,所有值都是对象,但函数不与它们操作的对象捆绑在一起。这是必要的,因为 Julia 通过多重派发选择函数使用的方法,这意味着在选择方法时考虑*所有*函数参数的类型,而不仅仅是第一个(有关方法和派发的更多信息,请参阅[方法](method.md))。因此,函数仅仅「属于」它们的第一个参数是不合适的。将方法组织到函数对象中而不是在每个对象「内部」命名方法最终成为语言设计中一个非常有益的方面。
159+
160+
复合类型可以是**可变**(mutable)或**不可变**(immutable)的,相关详细信息在[一个单独章节](struct.md)
158161

159162
## 已声明的类型
160163
前面章节中讨论的三种类型(抽象、原始、复合)实际上都是密切相关的。它们共有相同的关键属性:

docs/algorithms/introduction.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@
44
* [oi-wiki](https://oi-wiki.org/):获得更专业的信息
55
* [DataStructures](https://github.com/JuliaCollections/DataStructures.jl):代码是数据结构类算法的实例
66
* [TheAlgorithms](https://github.com/thealgorithms/julia):有实例,**但代码质量无法保证**
7-
* [nesteiner 发起的组织](https://github.com/Mastering-Algorithms-with-Julia):有实例,**但代码质量无法保证**
87

98
## 本章文档
109
* [交换](basic/swap.md)

docs/basic/array.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
# 多维数组
2-
内置数组的类型名为 `Array`
3-
Julia 中数组的一大特点是,它本身可以是任意维的,这类似于数学中的「张量」。
2+
Julia 内置数组的类型名为 `Array`。不同于一些语言中只定义了类似 `Vector` 的结构,Julia 中的数组可以定义成任意维的。
43

54
## 初始化
65
```julia-repl

docs/basic/io.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
# I/O
2+
我们已在[基础 I/O](basicio.md)中提及 `print``println`,它们是最基础的 I/O 方法。
3+
24
## 预定义值
35
- `stdin` 是标准输入,通常指控制台输入
46
- `stdout` 是标准输出,通常指控制台输出
57
- `stderr` 是错误输出,通常指控制台输出,常用于错误输出
68

79
## 文本相关函数
8-
`print``println` 已在[基础 I/O](basicio.md) 提到
910
```julia-repl
1011
julia> readline() # 默认从 stdin 读入
1112

docs/basic/little_types.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -74,11 +74,10 @@ julia> isa(true, MyType)
7474
true
7575
```
7676

77-
## missing nothing undef 的区分
77+
## 区分
78+
尽管 `missing``nothing``undef` 都表示值的缺失,它们在语义上可以区分。
7879
* `missing` 一般用于三值逻辑或在概率统计中,表明这个值是缺失的
79-
* `undef` 用于数组的初始化,如 `Array{Float64,2}(undef, 4, 4)`,表示直接使用分配的内存里原先的数据
8080
* `nothing` 一般用于表明函数没有返回值或参数不设定默认值
81+
* `undef` 用于数组的初始化,如 `Array{Float64,2}(undef, 4, 4)`,表示直接使用分配的内存里原先的数据。一般不会被混淆。
8182

82-
`nothing``missing` 具体的处理取决于工具箱内部的实现 [^1]
83-
84-
[^1]: https://discourse.juliacn.com/t/topic/6282/3
83+
`nothing``missing` 如何处理取决于[](../blog/packages/introduction.md)的具体实现。

docs/basic/loop.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,12 @@ echo> quit
5151
## for
5252
语法格式为:
5353
```jl
54-
for 变量 in 范围
54+
for 变量 in 循环范围
5555
语句
5656
end
5757
```
5858

59-
其中“范围”可以是[数组](vector.md)[范围](range.md)[字典](dict.md)……
59+
其中循环范围可以是[数组](vector.md)[范围](range.md)[字典](dict.md)等。你将在[之后](../advanced/iterate.md)读到如何自定义此操作。
6060
```jl
6161
for i in 1:10
6262
println(i)

docs/basic/setup_environment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
export JULIA_PKG_SERVER=https://mirrors.cernet.edu.cn/julia
1010
```
1111

12-
``` powershell
12+
``` powershell
1313
# Windows powershell
1414
[System.Environment]::SetEnvironmentVariable('JULIAUP_SERVER','https://mirrors.cernet.edu.cn/julia-releases/',[System.EnvironmentVariableTarget]::User)
1515
[System.Environment]::SetEnvironmentVariable('JULIA_PKG_SERVER','https://mirrors.cernet.edu.cn/julia',[System.EnvironmentVariableTarget]::User)

docs/blog/introduction.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# 介绍
2-
欢迎来到「专题/博客」模块,这里包含了更广泛的内容
2+
欢迎来到「专题/博客」模块,这里包含了与 Julia 有关的更广泛的内容。
33

44
## 列表
55
* [包的一切](packages/introduction.md) by Rratic
@@ -9,13 +9,8 @@
99

1010
## 资源链接
1111
- [Advent of Code](https://adventofcode.com/)
12-
- [blog by nestiner](https://nesteiner.github.io/)
13-
- [esolangs](https://esolangs.org/wiki/Main_Page)
1412
- [open standards](https://www.open-std.org/)
15-
- [pratical cryptography](http://practicalcryptography.com/)
1613
- [Project Euler](http://pe-cn.github.io/) - Challenge
17-
- [The little book about OS development](https://littleosbook.github.io/)
1814
- [Unicode](https://home.unicode.org/)
1915
- [wargames](https://overthewire.org/wargames/)
2016
- [Web GPU](https://gpuweb.github.io/gpuweb/)
21-
- [Yanyan's Wiki](https://jyywiki.cn/index.html)

docs/blog/packages/introduction.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
11
# 包的简介
2-
**包(package)**允许了我们交流成熟的代码。对于使用者,可以借此调用经过别人检查、优化、调试的代码,[避免浪费时间](https://www.zhihu.com/question/407370305)
2+
Julia 中第三方库所对应的名称是 package,常称为****
3+
4+
开源的第三方库使我们可以交流成熟的代码。对于使用者,可以借此调用经过别人检查、优化、调试的代码,[避免浪费时间](https://www.zhihu.com/question/407370305)。对于开发者,可以获得他人的建议与帮助。
5+
36
包被安装后,其内容可以作为[模块](../../advanced/module.md)被调用。
47

5-
在 REPL 中输入 `]`,进入**包管理器(Pkg-REPL)**模式,此时可以输入 `help` 获取帮助。
8+
在 REPL 中输入 `]` 可进入**包管理器**模式,此时可以输入命令。
9+
610
该模式下常用指令包括:
11+
* `help` 获取帮助及命令列表
712
* `add` 下载包(第一次会下载所有注册包的状态,可能比较慢)
813
* `build` 手动构建包
914
* `remove` 移除包

docs/setting.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ outline = [
99
]
1010

1111
[names]
12-
meta = "预知"
12+
meta = "准备"
1313
basic = "语言基础"
1414
advanced = "语言进阶"
1515
packages = "包的使用"

0 commit comments

Comments
 (0)