<buttonid="sidebar-toggle"class="icon-button"type="button"title="Toggle Table of Contents"aria-label="Toggle Table of Contents"aria-controls="sidebar">
<ahref="print.html"title="Print this book"aria-label="Print this book">
<iid="print-button"class="fa fa-print"></i>
</a>
</div>
</div>
<divid="search-wrapper"class="hidden">
<formid="searchbar-outer"class="searchbar-outer">
<inputtype="search"id="searchbar"name="searchbar"placeholder="Search this book ..."aria-controls="searchresults-outer"aria-describedby="searchresults-header">
<p>The easiest way to get both Rust and Cargo's latest versions is by using the <code>rustup</code> script, which also means that you have to use the <code>curl</code> command.</p>
<h3id="3-rust-and-cargo-installation"><aclass="header"href="#3-rust-and-cargo-installation">3. Rust and Cargo Installation.</a></h3>
<p>To install Rust and Cargo on your Unix System you have to download the <code>rustup installer script</code> using the following command on the terminal:</p>
<pre><codeclass="language-shell">$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
</code></pre>
<p>By using the previous command you will get the latest Rust and Cargo's versions. </p>
<blockquote>
<p>Suggestion: You can make sure the installation was succesfull by using the following command:</p>
<pre><codeclass="language-sh">$ rustc --version
</code></pre>
<p>It tells you the version of Rust that was installed.</p>
</blockquote>
<blockquote>
<p>NOTE: Some important considerations when installing Rust:</p>
<ul>
<li>
<p>When you install Rust, it will be installed only for the current user, in other words, the installation is not system-wide.</p>
</li>
<li>
<p>It is not required to be root or sudo to be able to install Rust.</p>
</li>
</ul>
</blockquote>
<p>Once you have completed your Rust and Cargo installations, you can now continue with the <code>mdBook</code> installation.</p>
<p>DECA Docs uses <code>mdBook</code> as a way to create books with Markdown. Since <code>mdBook</code> is a command line tool, it is ideal for creating tutorials, API documentations, course materials, amongst other useful things.</p>
<p>You can follow the instructions bellow to download <code>mdBook</code>. </p>
<p>First, you have to use the following command to build and install <code>mdBook</code>:</p>
<p>The command will automatically download <code>mdBook</code>, build it and install it in Cargo's global binary directory.</p>
<p>Once installed, the next step is to get the DECA Docs repository. Follow the instructions below to get it.</p>
<h3id="clone-the-deca-documentation-repository"><aclass="header"href="#clone-the-deca-documentation-repository">Clone the DECA Documentation repository.</a></h3>
<p>After you have succesfully compleated all installations, you can now access the docummentation repository and contribute to the resources.
<li>This command lets you copy the DECA Docs repository to your local machine.</li>
<li>It also means that you can pull down a full copy of all the repository data that it has at that point in time, including all versions of every file and folder for the project.</li>
</ul>
</blockquote>
<p>Once the repository has been cloned, you can have access to it by entering the following command on your terminal:</p>
<pre><codeclass="language-shell">$ cd docs/
</code></pre>
<p>This command will lead you to the directory where you can find the DECA Docs README.md.</p>
<p>The last step is to run the server using the following command:</p>
<pre><codeclass="language-shell">$ mdbook serve
</code></pre>
<p>You can view the page on any browser using the following link <ahref="http://127.0.0.1:3000">http://127.0.0.1:3000</a></p>
<blockquote>
<p>NOTE: If you want to access remotely use the <code>mdbook serve -n 0.0.0.0</code> which means any IP address can access the DECA Docs project.</p>
<p>A.Prakash, "How to install Rust and Cargo", <ahref="https://itsfoss.com/install-rust-cargo-ubuntu-linux/">https://itsfoss.com/install-rust-cargo-ubuntu-linux/</a>, 2023-03-26.</p>
