JuliaRoadmap

Rratic · 2022 年5 月 3 日 16:05

~~我一直以为MATLAB没文档~~

先说受众问题
我一开始的设想，是希望它适合任何人（按照julia现在的发展状况，也许抓些下沉市场是有必要的；对于当前情况来看，这个目标也许太大了）类似教程的部分……主要解决官方文档不符合认知规律的问题，也许没有刻意去教程化的必要吧（我之前也提到过，如果让用户到处链来链去就不太友善，因此放了些较为概括性的文字）这个应该是最符合（我的）想法的例子，可以看看
“而是快速将用户导向他关注的功能”
这一点也许注重的是packages部分，那么我会提出一个疑问：如果是获取需要的东西的话，那么只是提供搜索工具不应该是足够的吗，看包的文档不就能解决吗，那么如果这里有问题，首先应该是各个包开发者的文档没有写清楚，在工作量上显然无法解决；又或者所说的是类似于隔壁 [视频课程] 搬运和翻译 julia-gpu-course (help wanted) 的方向，这一点上我给不了太大的帮助，用包我一直是用自己需要的东西，并没有去了解其它的话题。那么这边的框架我会尽快搭；又或者是之后会在tips那边给出的搜索页面？之后我给点打tag例子；
如果a是名本科生，正在学习微积分，那么a拿到roadmap后我希望他做的是看完basic部分，（后期）酌情看advanced部分，看packages部分，至少提供了包搜索工具链接，然后凭借理应具备的英语能力阅读相关专业文档，这条路的优化空间不大
“是一个真正的地图，找到起点终点，然后自己走过去就好了”
那么这里的问题在于，不同人起点不同、终点不同，适合的路也不同，所以我的想法是节点化。也许之后需要添加一些页面进行串联，进行路径化

这是我放在meta目录下的如何学习章节，大家或许可以看看这篇如何修改？

JuliaRoadmap/zh/blob/master/docs/meta/how_to_learn.md

# 如何学习
!!! note
	请根据[环境配置](../basic/setup_environment.md)的指示准备 Julia 环境，并可以选用一个[下方工具部分](#工具)的编辑器。

> 最好设定一个明确的、可评价目标。先把小目标实现了，再去学习细节，而不是陷入其中。[^3]
>
> 例如，您可以利用这个语言去做一些你想做的事，把它作为目标。

## 文档结构
* `basic` 目录下包含这个语言的基础内容，能够保证使用此语言的基本开发能力
* `advanced` 目录下包含较为独特性的语法、特性、功能等内容
* 你可以根据[包简介](../blog/packages/introduction.md)的指示学会寻找、使用与制作你专业所需的包。例如数据科学可能需要阅读 `Dates`，`DataFrames`，`Makie` 的相关内容。[^4]

## 其它文档
推荐程度基本按照顺序，但是你可能有特定的需求；部分内容即由它们中的一些整合而来

| 名称 & 链接 | 主题 | 内容 |
| :-: | :-: | :-: |
| [中文文档](https://docs.juliacn.com/latest/) | 标准文档 | 语法、标准库、指导、开发 |
| [Julia DataScience 中文版](https://cn.julialang.org/JuliaDataScience) | 数据科学 | 语法基础、包 |

This file has been truncated. show original

johnnychen94 · 2022 年5 月 3 日 16:43

关于文档这一部分，我看到的国内一些其他试图覆盖 Julia 相关文档的组织有：

菜鸟教程
同元软控 Syslab 的文档… (仿 MATLAB）

这个其实是写的挺好的，如果能把内容凑成一个体系的话，Julia 界廖雪峰是你没跑了

只是说，从 Roadmap 的角度来说的话，我想大家应该期待的是一个像思维导图一样的东西，来帮助学习者能够快速地进入到 Julia 或者某些具体领域。对于 Julia 来说，举个例子，很多人想必会很困惑 “多重派发” 究竟是一个进阶内容还是基础内容，也会有人很困惑元编程是不是需要去学习，如果学的话，又应该以一个大概什么样的方式去学习，以及想要深入学习的话，有哪些相关的参考材料和博客链接。

如果说你对于你想要做的事情的定位是一个 “对学习者更友好的 Julia 快速入门教程”，照着你的思路去做肯定是没问题的，只是这里面的工作量其实还是蛮大的。然后确实这个教程已经偏离了最初要不要写一个Julia学习的Roadmap? 提出 roadmap 的定位了…

Rratic · 2022 年5 月 3 日 16:56

好了我现在基本知道当前需要什么了
一些回答

关于文档这一部分，我看到的国内一些其他试图覆盖 Julia 相关文档的组织有
已收到，之后会进行处理
期待的是一个像思维导图一样的东西
不得不说的是，思维导图式的东西其实只需要一个文件就能解决（其实可以归入how-to-learn）
很多人想必会很困惑 “多重派发” 究竟是一个进阶内容还是基础内容
在这个仓库中，个人认为是：多重派发知识影响你正常使用微积分包（即之前例子）吗？没必要知道那么详细，是进阶内容，包括struct、task我也是这么安排的
然后确实这个教程已经偏离了最初要不要写一个Julia学习的Roadmap? 提出 roadmap 的定位了…
其实从原帖中，就能看到大家对方向各执一词了……
需要再次声明的是，我现在的主要工作对象，即即将填满的basic/部分，不是也从不会是项目的主体，这个项目是泛化而有细节的

P.S. 其实现在最接近于思维导图的反倒是https://github.com/JuliaRoadmap/zh/blob/master/docs/setting.json

woclass · 2022 年5 月 4 日 13:41

这个帖子新开一个项目替代吧。
帖子的编辑权限不好放开。
引述外部资源的版权页不好标识。

Ailuj · 2022 年5 月 6 日 23:31

这是绘制路线图的一个具体项目吗？感谢楼主的贡献。但我觉得还为时过早。因为先要明确受众定位目的，然后明确思路方法蓝图，最后才开始写内容。

适用于每一个人，我认为是不正确的，比如我看过了ThinkJulia，我就直接看文档了，其他入门之类的教程我扫一眼目录和序言就不看了，比如julia bit by bit，即使它说它适用于每一个人
如果定位是原始楼主的rust圣经那样的，目的是填补入门语言与上手真实项目之间的沟壑，我大概扫了一眼，就是习题化的文档呀，我认为julia可能不需要，因为我刚看了笑傲江湖，无招胜有招，简单招数无穷变化，这才是最高级的功法开个玩笑…
如果涉及到最佳实践，原贴已经有人提到了缺乏资源，不好写…
如果涉及到文档学习，比如外部程序的IO的东西，我是看了linux fu相关linux入门的资源才逐渐明白，仅看文档我感觉不够，但这也许不是julia的任务了，而且这里有个关键问题，不是julia的任务时，可以给出相关资源的链接，然而一堆油管和维基，都在墙外，这就只能算半个资源了，因为需要梯子…
最后我想问julia的markdown怎么用？文档中没说怎么用，只讲了语法。我调用这个包，然后写了个字符串，打印到终端，发现没有用…

Rratic · 2022 年5 月 6 日 23:41

能否说明你要用markdown干什么？

julia> using Markdown

julia> md"""
       # a
       b
       """
  a
  ≡≡≡

  b

Ailuj · 2022 年5 月 7 日 01:41

用julia写和预览markdown，其实这个用哪个编辑器都行了，不用非得julia…
在终端里直接预览markdown，这个可能不太行了，markdown得转译成html才能看吧…
为路线图做贡献时的markdown，看了看社区的那个帖子和julia之月，给字符串加个md前缀就行了…

谢谢你让我发现了julia之月这个资源它就是路线图一个小型实例吧，就是有点老旧了，窃以为本楼的这个项目可以引用其的一部分…

话说我想到一个关键问题，就是能不能在Gitee上同步一个？git 推拉 github的速度还行，但仅查看github有时候就会特别卡，建议同步到Gitee上，工信部钦点的，值得信赖…

Rratic · 2022 年5 月 7 日 04:06

终端display出来效果还是可以的，能不用html就没必要用
gitee我一会弄下
~~gitee mirror按钮找不到~~

Rratic · 2022 年5 月 9 日 09:15

knowledge示例

github.com

JuliaRoadmap/zh/blob/master/docs/knowledge/filesystem.md

# 文件系统基础
文件系统是由**文件**和**目录**组成的关于文件的系统，具有树状结构，实现了数据的存储、分级组织、访问获取等操作
!!! note
	在 linux 等系统的底层实现中，目录被认为是“特殊文件”，文件系统中也可能存在一些特殊数据，此处不涉及

## 命名
为了区分，文件和目录可以命名，同一目录下命名不可相同。
文件名最后一个 `.` 后的称为文件后缀。
有一些字符不可用于命名（如 `/`）且名字长度是有限的。

## 根目录
根目录处在文件系统最*根源*的位置，文件系统中任何资源均直接或间接处在根目录中，根目录没有上一级目录
!!! note
	部分系统存在 `root-jail` 机制，用于把非管理员用户限制在一定区域内防止潜在的破坏

## 路径
路径分为**相对路径**和**绝对路径**，通常通过目录名和最后的文件名进行索引。
* 路径各层使用 `/` 分隔
	* 在 Windows 中，也可以使用 `\` 分隔（注意字符串中需用 `\\` 转义），且部分命令可能不兼容 `/`
* 绝对路径以 `/` 开头

This file has been truncated. show original

packages示例

github.com

JuliaRoadmap/zh/blob/master/docs/packages/random.md

# Random
`Random` 提供了一些随机数相关的基本物品

## 生成器
- `AbstractRNG` 是随机数生成器的抽象类型
- `MersenneTwister(seed)` 生成一个梅森旋转随机数生成器，`seed` 可以是非负整数或 `Vector{UInt32}`
- `RandomDevice()` 是操作系统提供的随机数生成器

## rand
`rand([rng=GLOBAL_RNG],[S],[dims...])` 使用生成器 `rng`，从 `S` 中选择随机元素，使用维度参数 `dims...`，其中 S 可以是： 
- 可索引集合
- 抽象字典/集合类型
- 字符串
- 存在 `typemin` 和 `typemax` 的类型（默认 `Float64`）
- 元组（1.1及以后）

有一些非基本的随机数生成函数
- `randn([rng=GLOBAL_RNG],[T=Float64],[dims...])` 生成 T 类型的均匀分布随机数（平均数 0，标准差 1）
- `randperm([rng=GLOBAL_RNG,] n::Integer)` 生成长度为 n 的「排列（permutation）」
- `randcycle([rng=GLOBAL_RNG,] n::Integer)` 生成长度为 n 的「循环排列（cyclic permutation）」

This file has been truncated. show original

Ailuj · 2022 年5 月 9 日 22:25

这个路线图项目不是要解决官方文档不符合认知规律的问题嘛？像“文件系统”这个词条的这种写法，感觉哪里不太对，用bing搜索wikipedia，说的很清楚，文件系统就是用来存取数据的，否则存了以后不知道存哪了就尴尬了。但在这里被解释为树状结构？文件系统是一种数据结构？根据林奈命名法(越靠后的越本质)，这样解释也许更好点: 文件系统是一个关于文件的系统，具有树状结构。
我也不清楚什么样的写法才合适，但如果写的角度是初次接触的、非专业的，可能会更易理解一些？白居易写诗要广场舞大妈都能看懂，费曼学习新知识要讲给小学生…

Rratic · 2022 年5 月 9 日 23:43

维基上写的是

严格地说，文件系统是一套实现了数据的存储、分级组织、访问和获取等操作的抽象数据类型（Abstract data type）。

抽象数据类型此处有误导性，前面的似乎可以借鉴

Ailuj · 2022 年5 月 10 日 23:54

抱歉昨天轻率了，现在我顿悟了！原来我们平时存文件，其实是将“文件系统”这个类进行实例化，就是New方法！原来《数据结构》不仅存在于编程语言中，还在操作系统中！

Rratic · 2022 年5 月 19 日 15:34

刚刚发布了LightLearn v2.1.0，请确保获取最新版本

仓库地址 GitHub - Rratic/LightLearn.jl: a visual tool for julialang learning with level-installing and sandbox 使用说明见README

P.S.
1. 欢迎创作自己的LLP(LightLearn Package)，欢迎在自己的仓库上折腾
2. 如果发现任何相关问题请立即联系我/在issue提出
3. 有生之年竟然能用到Base.invokelatest
4. 该项目可能会作为“项目实践”二次利用

wenzee · 2022 年5 月 21 日 00:18

微积分的内容还是多项式。

Rratic · 2022 年5 月 21 日 02:05

收到
是我瞎了，一会放上去

johnnychen94 · 2022 年5 月 22 日 04:42

Downloads 应该是 1.6 的标准库，不清楚你说的坑是指什么

Rratic · 2022 年5 月 23 日 11:46

发布了HTML渲染结果
https://juliaroadmap.github.io/docs/

需注意

仅包含了一部分文档
部分文档不在侧边显示，需在索引处寻找
不会定时更新，之后会移步 learn.juliacn.com （链接不可用，待商榷）

johnnychen94 · 2022 年5 月 23 日 14:33

Julia 官方文档对于初学者不太友好的一点在于它过于正式和冗长了，有一个轻量级的快速入门用的小教程（或者说，笔记）我倒是觉得是一个好的工作。只是有点担心随着后期内容逐渐填充不再轻量之后，和官方文档的边界会慢慢模糊最终导致不如直接去读官方文档。

也许在整理的时候可以划分成：基础，进阶两个大的板块？这两个板块中的内容可以允许一部分重叠，但基础就针对那些初学 Julia 30天的人或者试图2小时上手 Julia 的人去构建内容，其他进阶性以及不常用的话题可以留到进阶板块中通过思维导图或者 awesome julia collection 的方式去整理。你觉得这样如何呢？

Rratic · 2022 年5 月 23 日 14:46

也许在整理的时候可以划分成：基础，进阶两个大的板块

我寻思我不是就这么划分的吗

有一个轻量级的快速入门用的小教程

有cheatsheet这类的东西，链接我放“如何学习”版块了

随着后期内容逐渐填充不再轻量之后，和官方文档的边界会慢慢模糊最终导致不如直接去读官方文档

现在我是靠拆；较繁杂的放在文档靠后

通过思维导图

有些东西不适合，例如类型系统文件系统并行计算完全是独立的话题

awesome julia collection

~~awesome julia collection是啥？~~

johnnychen94 · 2022 年5 月 23 日 16:04

原来… 是我眼瞎了…