Skip to content

Commit caa43fe

Browse files
committed
fix warnings and inconsistent nehaviour
1 parent 5326001 commit caa43fe

13 files changed

Lines changed: 39 additions & 51 deletions

File tree

docs/advanced/macro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ julia> macro assert(ex, msgs...)
170170
@assert (macro with 1 method)
171171
```
172172

173-
现在`@assert` 有两种操作模式,这取决于它接收到的参数数量!如果只有一个参数,`msgs` 捕获的表达式元组将为空,并且其行为与上面更简单的定义相同。 但是现在如果用户指定了第二个参数,它会打印在消息正文中而不是不相等的表达式中。你可以使用恰当命名的 [`@macroexpand`](@ref) 宏检查宏展开的结果:
173+
现在 `@assert` 有两种操作模式,这取决于它接收到的参数数量!如果只有一个参数,`msgs` 捕获的表达式元组将为空,并且其行为与上面更简单的定义相同。 但是现在如果用户指定了第二个参数,它会打印在消息正文中而不是不相等的表达式中。你可以使用恰当命名的 `@macroexpand` 宏检查宏展开的结果:
174174
```julia-repl
175175
julia> @macroexpand @assert a == b
176176
:(if Main.a == Main.b

docs/basic/bool.md

Lines changed: 6 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,16 @@
99
| :-: | :-: |
1010
| `!x` | 否定 |
1111
| `x && y` | 短路与 |
12-
| `x || y` | 短路或 |
12+
| `x \|\| y` | 短路或 |
1313
| `x ⊻ y` | 异或 |
1414
| `x ⊼ y` | 非与 |
1515
| `x ⊽ y` | 非或 |
1616

17-
```julia-repl
18-
julia> !true
19-
false
20-
21-
julia> true && "foo"
22-
"foo"
23-
24-
julia> false || "foo"
25-
"foo"
26-
27-
julia> true || "foo"
28-
true
17+
```@repl
18+
!true
19+
true && "foo"
20+
false || "foo"
21+
true || "foo"
2922
```
3023

3124
后三者的使用与[整数的位运算](int.md#位运算)情况类似。

docs/basic/function.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ ERROR: MethodError: no method matching foo(::Bool)
3939
```
4040

4141
参数类型声明**通常对性能没有影响**,在 Julia 中声明参数类型的最常见原因是
42-
* **派发**[方法](method.md) 中所述,对于不同的参数类型,你可以有实现不同的函数(称为“方法”),在这种情况下,参数类型用于确定调用哪个版本的函数
42+
* **派发**[方法](../advanced/method.md) 中所述,对于不同的参数类型,你可以有实现不同的函数(称为“方法”),在这种情况下,参数类型用于确定调用哪个版本的函数
4343
* **正确性** 函数只为某些参数类型返回正确的结果
4444
* **清晰性**
4545

docs/basic/hello.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,24 +26,27 @@ julia> # 如果你发现除了新的一行以外什么都没显示,说明你
2626

2727
## 输出
2828
现在可以引入经典的 Hello World 程序:
29-
```julia-repl
30-
julia> print("Hello, world!")
31-
Hello, world!
29+
```@repl
30+
print("Hello, world!")
3231
```
3332

3433
使用形如 `print("text")` 的代码输出你想要输出的文本。在一对双引号中放置想要输出的内容,运行结果是将这段内容显示在屏幕上。
3534

3635
如果出现一串以红色 `ERROR:` 开头的文字,说明 REPL 向你报告了错误。可能是因为:
3736
* 漏掉双引号 `""` 或使用了中文输入法中的中文引号 `“”` 等,括号也是同理
37+
```@repl
38+
print(Hello, world!)
39+
```
3840
* `print` 的拼写不正确
41+
```@repl
42+
prlnt("Hello, world!")
43+
```
3944

4045
请仔细检查,如果无法检查出问题,可向其他人求助。
4146

4247
如果想在输出后换行,将 `print` 改为 `println` 即可。
43-
```julia-repl
44-
julia> println("Hello, world!")
45-
Hello, world!
46-
48+
```@repl
49+
println("Hello, world!")
4750
```
4851

4952
Julia 的自带 REPL 中没有高级文件功能。因此,如果想要一次运行多行代码,你可以:

docs/basic/variable_basic.md

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -64,10 +64,10 @@ ERROR: UndefVarError: `new_var` not defined in `Main`
6464
## 变量命名
6565
变量名是区分大小写的。
6666
```julia-repl
67-
julia> a=0
67+
julia> a = 0
6868
0
6969
70-
julia> A=1
70+
julia> A = 1
7171
1
7272
```
7373

@@ -83,14 +83,14 @@ julia> a, A
8383
可以使用 [Unicode](../knowledge/unicode.md) 字符作为变量名(允许大部分 Unicode 字符,包括大部分中文字符),但不允许变量名与[关键字](../blog/keywords.md)相同。
8484

8585
```julia-repl
86-
julia> for=1
86+
julia> for = 1
8787
ERROR: syntax: unexpected "="
8888
```
8989

9090
在 REPL 和一些其它的环境中,很多 Unicode 数学符号可以通过键入 `\`[`LaTeX`](../knowledge/latex.md) 符号名,再按 `tab` 打出。
9191

9292
```julia-repl
93-
julia> α=1 # \alpha<tab>
93+
julia> α = 1 # \alpha<tab>
9494
1
9595
9696
help?> α̂₂ # 你从别的地方复制过来一个字符,不知道怎么打可以用help模式
@@ -100,30 +100,21 @@ help?> α̂₂ # 你从别的地方复制过来一个字符,不知道怎么打
100100

101101
如果有需要,Julia 甚至允许你重定义内置的常量和函数(这样做可能引发潜在的混淆,所以并**不推荐**),但不允许重定义一个已经在使用中的内置常量或函数。
102102
```julia-repl
103-
julia> sin=0
103+
julia> sin = 0
104104
0
105105
106106
julia> cos(0)
107107
1.0
108108
109-
julia> cos=0
109+
julia> cos = 0
110110
ERROR: cannot assign a value to variable Base.cos from module Main
111111
```
112112

113113
## 命名规范
114-
应尽量遵循以下官方提供的命名规范:
115-
* 对于变量
116-
117-
* 若用英文,变量名应首字母小写,用下划线分隔名字中的单词,但是不鼓励使用,除非不使用下划线时名字非常难读
118-
119-
* 对于[类型](../advanced/struct.md)[模块](../advanced/module.md)
120-
121-
* 若用英文,名字应以大写字母开头,并且用大写字母而不是用下划线分隔单词
122-
123-
* 对于[函数](function.md)[](../advanced/macro.md)
124-
125-
* 若用英文,名字用小写,不使用下划线
126-
* 会对参数进行更改的函数使用`!`结尾
114+
使用英文命名时,应尽量遵循以下官方提供的命名规范:
115+
* 对于变量,变量名应首字母小写,用下划线分隔名字中的单词,但是不鼓励使用,除非不使用下划线时名字非常难读
116+
* 对于[类型](../advanced/struct.md)[模块](../advanced/module.md),名字应以大写字母开头,并且用大写字母而不是用下划线分隔单词
117+
* 对于[函数](function.md)[](../advanced/macro.md),名字用小写,不使用下划线;会对参数进行更改的函数使用`!`结尾
127118

128119
## 常量
129120
**常量**(constant)是程序中原则上值不能被改变的量。这可能包括:
@@ -135,7 +126,7 @@ ERROR: cannot assign a value to variable Base.cos from module Main
135126
julia> const c = 0
136127
0
137128
138-
julia> c=1
129+
julia> c = 1
139130
WARNING: redefinition of constant c. This may fail, cause incorrect answers, or produce other errors.
140131
```
141132

docs/blog/data_and_ai/data.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -461,9 +461,10 @@ julia> w = MLJ.transform(mach, df)
461461

462462
### 数据标准化 `Standardizer`
463463
**文档**
464+
464465
`Standardizer(; features=Symbol[], ignore=false, ordered_factor=false, count=false)`
465466

466-
$$ newX = \frac{X' - mean(X)} {Std(X)} $$
467+
$$newX = \frac{X' - mean(X)} {Std(X)}$$
467468

468469
**注意**
469470
其中
@@ -472,7 +473,7 @@ $$ newX = \frac{X' - mean(X)} {Std(X)} $$
472473
- newX 转换X' 后的新数组
473474

474475
另外
475-
`Standardizer`只对`Continuous`科学类型的数据有效,如果在数据集中有科学类型为`OrderedFactor``Count``nums`,可以在`Standardizer`中指定`ordered_factor=true``count=true`
476+
`Standardizer` 只对 `Continuous` 科学类型的数据有效,如果在数据集中有科学类型为 `OrderedFactor``Count``nums`,可以在 `Standardizer` 中指定`ordered_factor=true``count=true`
476477

477478
**示例**
478479
```julia-repl

docs/blog/data_and_ai/regressor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Type: Int64
9696

9797
通过上面的结果可以知道 **SalePrice** 没有无效或者其他非数值的数据,下面通过图示化来进一步展示 **SalePrice**
9898

99-
![](../../assets/images/实例_波士顿房价预测/2022-05-05_19-56-37_screenshot.png)
99+
![](../../assets/images/regressor/2022-05-05_19-56-37_screenshot.png)
100100

101101
这里需要一个 `distplot` 函数来绘制图像
102102

docs/knowledge/cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,6 @@ $ ./my_code < input > output
6262
- 通常在输入完后使用回车提交
6363

6464
## 参阅
65-
- 操作系统中[常见文件系统命令](filesystem.md#常见命令)
65+
- 操作系统中[常见文件系统命令](../advanced/filesystem.md#文件系统命令)
6666

6767
[^1]: https://oi-wiki.org/tools/cmd/

docs/knowledge/spider.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
- [Web 如何运作](https://developer.mozilla.org/zh-CN/docs/Learn/Getting_started_with_the_web/How_the_Web_works)
55

66
##
7-
爬虫可以使用方便的 [Downloads](../packages/downloads.md) 包或选项多的 [HTTP](../packages/http.md) 包。
7+
爬虫可以使用方便的 [Downloads](../packages/downloads.md) 包或选项多的 [HTTP](https://juliaweb.github.io/HTTP.jl/stable/) 包。
88

99
## 注意事项
1010
1. 大多数网站的根目录存在 `robots.txt`,标注了管理者允许爬虫访问的范围,原则上应该履行。

docs/packages/dataframes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ julia> select(df, :x2, :x2=>ByRow(sqrt)) # 对列 x2 中所有行数据求平方
235235
2 │ 4 2.0
236236
```
237237

238-
默认 select 会拷贝原始数据返回一个新的 DataFrame 变量,若要使用[引用机制](varref.md),传递关键字 `copycols=false` 或使用 `select!`\
238+
默认 select 会拷贝原始数据返回一个新的 DataFrame 变量,若要使用[引用机制](../advanced/varref.md),传递关键字 `copycols=false` 或使用 `select!`\
239239
`transform``transform!``select``select!` 的功能类似,但前两者会将源数据中的所有列显示在新的 DataFrame 变量中
240240
```julia-repl
241241
julia> transform(df, All() => +) # All() 对每行的所有数据执行函数: +

0 commit comments

Comments
 (0)