ci: generate pages at 41547be [ci skip]

Author: bn-e

docs/ch07-00-managing-growing-projects-with-packages-crates-and-modules.html

@@ -149,42 +149,41 @@ <h1 class="menu-title">The Rust Programming Language 日本語版</h1>
 -->
 <h1 id="肥大化していくプロジェクトをパッケージクレートモジュールを利用して管理する"><a class="header" href="#肥大化していくプロジェクトをパッケージクレートモジュールを利用して管理する">肥大化していくプロジェクトをパッケージ、クレート、モジュールを利用して管理する</a></h1>
 <!--
-As you write large programs, organizing your code will be important because
-keeping track of your entire program in your head will become impossible. By
-grouping related functionality and separating code with distinct features,
-you’ll clarify where to find code that implements a particular feature and
-where to go to change how a feature works.
+As you write large programs, organizing your code will become increasingly
+important. By grouping related functionality and separating code with distinct
+features, you’ll clarify where to find code that implements a particular
+feature and where to go to change how a feature works.
 -->
-<p>大きなプログラムを書く時、そのすべてを頭の中に入れておくのは不可能になるため、コードのまとまりを良くすることが重要になります。
+<p>書いているプログラムが大きいときほど、コードを整理しておくことはますます重要になります。
 関係した機能をまとめ、異なる特徴を持つコードを分割することにより、特定の機能を実装しているコードを見つけたり、機能を変更したりするためにどこを探せば良いのかを明確にできます。</p>
 <!--
 The programs we’ve written so far have been in one module in one file. As a
-project grows, you can organize code by splitting it into multiple modules and
-then multiple files. A package can contain multiple binary crates and
+project grows, you should organize code by splitting it into multiple modules
+and then multiple files. A package can contain multiple binary crates and
 optionally one library crate. As a package grows, you can extract parts into
 separate crates that become external dependencies. This chapter covers all
-these techniques. For very large projects of a set of interrelated packages
-that evolve together, Cargo provides workspaces, which we’ll cover in the
-[“Cargo Workspaces”][workspaces] section in Chapter 14.
+these techniques. For very large projects comprising a set of interrelated
+packages that evolve together, Cargo provides *workspaces*, which we’ll cover
+in the [“Cargo Workspaces”][workspaces] section in Chapter 14.
 -->
 <p>私達がこれまでに書いてきたプログラムは、一つのファイル内の一つのモジュール内にありました。
-プロジェクトが大きくなるにつれて、これを複数のモジュールに、ついで複数のファイルに分割することで、プログラムを整理することができます。
+プロジェクトが大きくなるにつれて、これを複数のモジュールに、ついで複数のファイルに分割することで、プログラムを整理するべきです。
 パッケージは複数のバイナリクレートからなり、またライブラリクレートを1つもつこともできます。
 パッケージが大きくなるにつれて、その一部を抜き出して分離したクレートにし、外部依存とするのもよいでしょう。
 この章ではそれらのテクニックすべてを学びます。
 相互に関係し合い、同時に成長するパッケージの集まりからなる巨大なプロジェクトには、
-Cargoがワークスペースという機能を提供します。これは14章の<a href="ch14-03-cargo-workspaces.html">Cargoワークスペース</a><!-- ignore -->で解説します。</p>
+Cargoが<em>ワークスペース</em>という機能を提供します。これは14章の<a href="ch14-03-cargo-workspaces.html">Cargoワークスペース</a>で解説します。</p>
 <!--
-In addition to grouping functionality, encapsulating implementation details
-lets you reuse code at a higher level: once you’ve implemented an operation,
-other code can call that code via the code’s public interface without knowing
-how the implementation works. The way you write code defines which parts are
-public for other code to use and which parts are private implementation details
-that you reserve the right to change. This is another way to limit the amount
-of detail you have to keep in your head.
+We’ll also discuss encapsulating implementation details, which lets you reuse
+code at a higher level: once you’ve implemented an operation, other code can
+call your code via its public interface without having to know how the
+implementation works. The way you write code defines which parts are public for
+other code to use and which parts are private implementation details that you
+reserve the right to change. This is another way to limit the amount of detail
+you have to keep in your head.
 -->
-<p>機能をグループにまとめられることに加え、実装の詳細がカプセル化されることにより、コードをより高いレベルで再利用できるようになります：
-手続きを実装し終えてしまえば、他のコードはそのコードの公開されたインターフェースを通じて、実装の詳細を知ることなくそのコードを呼び出すことができるのです。
+<p>実装の詳細をカプセル化することについても議論します。カプセル化によって、コードをより高いレベルで再利用できるようになります：
+手続きを実装し終えてしまえば、他のコードはその公開されたインターフェースを通じて、実装の詳細を知る必要なくそのコードを呼び出すことができるのです。
 コードをどう書くかによって、どの部分が他のコードにも使える公開のものになるのか、それとも自分だけが変更できる非公開のものになるのかが決定されます。
 これもまた、記憶しておくべき細部を制限してくれる方法のひとつです。</p>
 <!--