Skip to content

Commit 56ef8de

Browse files
committed
Update before transferring ownership.
1 parent 1a7a836 commit 56ef8de

19 files changed

+739
-115
lines changed

docs/_images/test.gif

60.4 KB
Loading
+47
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
移除标准库依赖
2+
===========================
3+
4+
.. toctree::
5+
:hidden:
6+
:maxdepth: 3
7+
8+
让我们从零开始创建内核项目。一开始,它就和一个普通的 Cargo 项目没有什么不同:
9+
10+
.. code-block:: console
11+
12+
$ cargo new os --bin
13+
14+
我们加上了 ``--bin`` 选项来告诉 Cargo 我们创建一个可执行项目而不是库项目。此时,项目的文件结构如下:
15+
16+
.. code-block:: console
17+
18+
$ tree os
19+
os
20+
├── Cargo.toml
21+
└── src
22+
└── main.rs
23+
24+
1 directory, 2 files
25+
26+
其中 ``Cargo.toml`` 中保存着项目的配置,包括作者的信息、联系方式以及库依赖等等。显而易见源代码保存在 ``src`` 目录下,目前为止只有 ``main.rs``
27+
一个文件,让我们看一下里面的内容:
28+
29+
.. code-block:: rust
30+
:linenos:
31+
:caption: 最简单的 Rust 应用
32+
33+
fn main() {
34+
println!("Hello, world!");
35+
}
36+
37+
利用 Cargo 工具即可一条命令实现构建并运行项目:
38+
39+
.. code-block:: console
40+
41+
$ cargo run
42+
Compiling os v0.1.0 (/home/shinbokuow/workspace/v3/rCore-Tutorial-v3/os)
43+
Finished dev [unoptimized + debuginfo] target(s) in 1.15s
44+
Running `target/debug/os`
45+
Hello, world!
46+
47+

docs/_sources/chapter0/index.rst.txt

+7-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
第零章:Rust 独立可执行程序
1+
第零章:编译运行 RV64 裸机程序
22
==============================================
33

4-
本章我们将完成一个 Rust 独立可执行程序。
4+
5+
.. toctree::
6+
:hidden:
7+
:maxdepth: 3
8+
9+
1remove-std

docs/_sources/index.rst.txt

+11-33
Original file line numberDiff line numberDiff line change
@@ -8,47 +8,25 @@ rCore-Tutorial-Book 第三版
88

99
.. toctree::
1010
:maxdepth: 2
11-
:caption: 章节列表
11+
:caption: 正文
1212
:hidden:
1313

1414
quickstart
1515
chapter0/index
1616

17-
欢迎来到 rCore-Tutorial-Book 第三版!
18-
19-
reStructuredText 基本语法
20-
----------------------------------------------
21-
22-
.. note::
23-
下面是一个注记。
24-
25-
`这里 <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#hyperlinks>`_ 给出了在 Sphinx 中
26-
外部链接的引入方法。注意,链接的名字和用一对尖括号包裹起来的链接地址之间必须有一个空格。链接最后的下划线和片段的后续内容之间也需要
27-
有一个空格。
28-
29-
接下来是一个文档内部引用的例子。比如,戳 :doc:`quickstart` 可以进入快速上手环节。
30-
31-
.. warning::
32-
33-
下面是一个警告。
34-
35-
.. code-block:: rust
36-
:linenos:
37-
:caption: 一段示例 Rust 代码
38-
39-
// 我们甚至可以插入一段 Rust 代码!
40-
fn add(a: i32, b: i32) -> i32 { a + b }
41-
42-
下面继续我们的警告。
17+
.. toctree::
18+
:maxdepth: 2
19+
:caption: 附录
20+
:hidden:
4321

44-
.. error::
4522

46-
下面是一个错误。
23+
.. toctree::
24+
:maxdepth: 2
25+
:caption: 开发注记
26+
:hidden:
4727

28+
rest-example
4829

49-
这里是一行数学公式 :math:`\sin(\alpha+\beta)=\sin\alpha\cos\beta+\cos\alpha\sin\beta`。
5030

51-
基本的文本样式:这是 *斜体* ,这是 **加粗** ,接下来的则是行间公式 ``a0`` 。它们的前后都需要有一个空格隔开其他内容,这个让人挺不爽的...
31+
欢迎来到 rCore-Tutorial-Book 第三版!
5232

53-
`这是 <https://docs.readthedocs.io/en/stable/guides/cross-referencing-with-sphinx.html#the-doc-role>`_ 一个全面展示
54-
章节分布的例子,来自于 ReadTheDocs 的官方文档。事实上,现在我们也采用 ReadTheDocs 主题了,它非常美观大方。

docs/_sources/rest-example.rst.txt

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
reStructuredText 基本语法
2+
=====================================================
3+
4+
.. note::
5+
下面是一个注记。
6+
7+
`这里 <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#hyperlinks>`_ 给出了在 Sphinx 中
8+
外部链接的引入方法。注意,链接的名字和用一对尖括号包裹起来的链接地址之间必须有一个空格。链接最后的下划线和片段的后续内容之间也需要
9+
有一个空格。
10+
11+
接下来是一个文档内部引用的例子。比如,戳 :doc:`/quickstart` 可以进入快速上手环节。
12+
13+
.. warning::
14+
15+
下面是一个警告。
16+
17+
.. code-block:: rust
18+
:linenos:
19+
:caption: 一段示例 Rust 代码
20+
21+
// 我们甚至可以插入一段 Rust 代码!
22+
fn add(a: i32, b: i32) -> i32 { a + b }
23+
24+
下面继续我们的警告。
25+
26+
.. error::
27+
28+
下面是一个错误。
29+
30+
31+
这里是一行数学公式 :math:`\sin(\alpha+\beta)=\sin\alpha\cos\beta+\cos\alpha\sin\beta`。
32+
33+
基本的文本样式:这是 *斜体* ,这是 **加粗** ,接下来的则是行间公式 ``a0`` 。它们的前后都需要有一个空格隔开其他内容,这个让人挺不爽的...
34+
35+
`这是 <https://docs.readthedocs.io/en/stable/guides/cross-referencing-with-sphinx.html#the-doc-role>`_ 一个全面展示
36+
章节分布的例子,来自于 ReadTheDocs 的官方文档。事实上,现在我们也采用 ReadTheDocs 主题了,它非常美观大方。
37+
38+
下面是一个测试 gif。
39+
40+
.. image:: test.gif

0 commit comments

Comments
 (0)