do sources better

This commit is contained in:
askiiart 2024-11-12 15:37:32 -06:00
parent ae7cd493cb
commit 6a7dc115dd
Signed by untrusted user who does not match committer: askiiart
GPG key ID: EA85979611654C30
6 changed files with 55 additions and 47 deletions

View file

@ -108,11 +108,11 @@
<span id="cb3-37"><a href="#cb3-37" aria-hidden="true" tabindex="-1"></a> | |</span> <span id="cb3-37"><a href="#cb3-37" aria-hidden="true" tabindex="-1"></a> | |</span>
<span id="cb3-38"><a href="#cb3-38" aria-hidden="true" tabindex="-1"></a> |-------------------------|</span></code></pre></div> <span id="cb3-38"><a href="#cb3-38" aria-hidden="true" tabindex="-1"></a> |-------------------------|</span></code></pre></div>
<h2 id="citations">Citations</h2> <h2 id="citations">Citations</h2>
<p>Saraswat, Rudra, et al. “blendOS · GitLab.” <em>GitLab</em>, <p>- Saraswat, Rudra, et al. “blendOS · GitLab.”
<a <em>GitLab</em>, <a
href="https://git.blendos.co/blendOS">git.blendos.co/blendOS</a>. href="https://git.blendos.co/blendOS">git.blendos.co/blendOS</a>.
Accessed 2 Oct. 2024.<br /> Accessed 2 Oct. 2024.<br />
Saraswat, Rudra, and Asterisk. “blendOS / image-builder · - Saraswat, Rudra, and Asterisk. “blendOS / image-builder ·
GitLab.” <em>GitLab</em>, <a GitLab.” <em>GitLab</em>, <a
href="https://git.blendos.co/blendOS/image-builder">git.blendos.co/blendOS/image-builder</a>. href="https://git.blendos.co/blendOS/image-builder">git.blendos.co/blendOS/image-builder</a>.
Accessed 3 Oct. 2024.</p> Accessed 3 Oct. 2024.</p>

View file

@ -82,5 +82,5 @@ From the buid log:
## Citations ## Citations
&emsp;Saraswat, Rudra, et al. “blendOS · GitLab.” *GitLab*, [git.blendos.co/blendOS](https://git.blendos.co/blendOS). Accessed 2 Oct. 2024.\ &emsp;- Saraswat, Rudra, et al. “blendOS · GitLab.” *GitLab*, [git.blendos.co/blendOS](https://git.blendos.co/blendOS). Accessed 2 Oct. 2024.\
&emsp;Saraswat, Rudra, and Asterisk. “blendOS / image-builder · GitLab.” *GitLab*, [git.blendos.co/blendOS/image-builder](https://git.blendos.co/blendOS/image-builder). Accessed 3 Oct. 2024. &emsp;- Saraswat, Rudra, and Asterisk. “blendOS / image-builder · GitLab.” *GitLab*, [git.blendos.co/blendOS/image-builder](https://git.blendos.co/blendOS/image-builder). Accessed 3 Oct. 2024.

View file

@ -10,8 +10,10 @@
<h1 id="using-clap">Using <code>clap</code></h1> <h1 id="using-clap">Using <code>clap</code></h1>
<p>Clap stands for Command Line Argument Parser, and put simply, <p>Clap stands for Command Line Argument Parser, and put simply,
it's a great library for making command-line stuff with Rust. it's a great library for making command-line stuff with Rust.
Even Cargo, Rust's package manager, depends on it [4], and it's Even Cargo, Rust's package manager, depends on it
been downloaded over 300 million times [5].</p> (<em>Cargo/cargo.toml at master</em>), and it's been downloaded
over 300 million times (<em>Clap - Crates.io: Rust package
registry</em>).</p>
<p>Rather than going over everything clap can do, I'll go over <p>Rather than going over everything clap can do, I'll go over
how I've used it in my <code>disk-read-benchmark</code> program how I've used it in my <code>disk-read-benchmark</code> program
I'll be using in my next blog post.</p> I'll be using in my next blog post.</p>
@ -63,16 +65,19 @@
<span id="cb4-11"><a href="#cb4-11" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span> <span id="cb4-11"><a href="#cb4-11" aria-hidden="true" tabindex="-1"></a> <span class="op">}</span></span>
<span id="cb4-12"><a href="#cb4-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div> <span id="cb4-12"><a href="#cb4-12" aria-hidden="true" tabindex="-1"></a><span class="op">}</span></span></code></pre></div>
<p>That's all you need to know to use <code>clap</code> at a <p>That's all you need to know to use <code>clap</code> at a
very basic level; for more details, check out the docs [1]. But, very basic level; for more details, check out the docs (<em>clap
you probably don't want to have to type in the entire command Documentation</em>). But, you probably don't want to have to
automatically, autocomplete would be nice. So I'll also go over type in the entire command automatically, autocomplete would be
how to use <code>clap_complete</code> as well.</p> nice. So I'll also go over how to use <code>clap_complete</code>
as well.</p>
<h2 id="clap_complete"><code>clap_complete</code></h2> <h2 id="clap_complete"><code>clap_complete</code></h2>
<p>Searching through the documentation [2], you'll notice that <p>Searching through the documentation (<em>Clap_complete
the docs don't cover how to use it with clap's derive at all. Documentation</em>), you'll notice that the docs don't cover how
Instead, after some Googling, I found an example script in to use it with clap's derive at all. Instead, after some
<em>clap</em>'s repository [3], which I then adapted and played Googling, I found an example script in <em>clap</em>'s
around with a bit until I got it figured out.</p> repository (<em>completion-derive.rs at master</em>), which I
then adapted and played around with a bit until I got it figured
out.</p>
<p>Anyways, again, we need to install <code>clap_complete</code> <p>Anyways, again, we need to install <code>clap_complete</code>
first:</p> first:</p>
<div class="sourceCode" id="cb5"><pre <div class="sourceCode" id="cb5"><pre
@ -170,21 +175,24 @@
<span id="cb10-4"><a href="#cb10-4" aria-hidden="true" tabindex="-1"></a>generate-fish-completions (Generate fish completions) prep-dirs (Prepares the directories so other programs can prepare their datasets)</span> <span id="cb10-4"><a href="#cb10-4" aria-hidden="true" tabindex="-1"></a>generate-fish-completions (Generate fish completions) prep-dirs (Prepares the directories so other programs can prepare their datasets)</span>
<span id="cb10-5"><a href="#cb10-5" aria-hidden="true" tabindex="-1"></a>generate-zsh-completions (Generate zsh completions) run (Runs it all)</span></code></pre></div> <span id="cb10-5"><a href="#cb10-5" aria-hidden="true" tabindex="-1"></a>generate-zsh-completions (Generate zsh completions) run (Runs it all)</span></code></pre></div>
<h2 id="sources">Sources</h2> <h2 id="sources">Sources</h2>
<ol type="1"> <p>- clap contributors. “clap Documentation.” Clap - Rust, <a
<li><a href="https://docs.rs/clap/latest/clap/" href="https://docs.rs/clap/latest/clap/">docs.rs/clap/latest/clap/</a>.
class="uri">https://docs.rs/clap/latest/clap/</a></li> Accessed 12 Nov. 2024.<br />
<li><a - clap_complete contributors. “Clap_complete Documentation.”
href="https://docs.rs/clap_complete/latest/clap_complete/" Clap_complete - Rust, <a
class="uri">https://docs.rs/clap_complete/latest/clap_complete/</a></li> href="https://docs.rs/clap_complete/latest/clap_complete">docs.rs/clap_complete/latest/clap_complete</a>.
<li><a Accessed 12 Nov. 2024.<br />
href="https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs" - clap contributors.
class="uri">https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs</a></li> “clap/clap_complete/examples/completion-derive.rs at master ·
<li><a Clap-Rs/Clap.” GitHub, <a
href="https://github.com/rust-lang/cargo/blob/master/Cargo.toml" href="https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs">github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs</a>.
class="uri">https://github.com/rust-lang/cargo/blob/master/Cargo.toml</a></li> Accessed 12 Nov. 2024.<br />
<li><a href="https://crates.io/crates/clap" - cargo contributors. “cargo/Cargo.Toml at master ·
class="uri">https://crates.io/crates/clap</a></li> rust-lang/cargo.” GitHub, <a
</ol> href="https://github.com/rust-lang/cargo/blob/master/Cargo.toml">github.com/rust-lang/cargo/blob/master/Cargo.toml</a>.
Accessed 12 Nov. 2024.<br />
- “Clap - Crates.io: Rust Package Registry.” crates.io,
crates.io/crates/clap. Accessed 12 Nov. 2024.</p>
<iframe src="https://john.citrons.xyz/embed?ref=askiiart.net" style="margin-left:auto;display:block;margin-right:auto;max-width:732px;width:100%;height:94px;border:none;"></iframe> <iframe src="https://john.citrons.xyz/embed?ref=askiiart.net" style="margin-left:auto;display:block;margin-right:auto;max-width:732px;width:100%;height:94px;border:none;"></iframe>
<script src="/prism.js"></script> <script src="/prism.js"></script>
</body> </body>

View file

@ -1,6 +1,6 @@
# Using `clap` # Using `clap`
Clap stands for Command Line Argument Parser, and put simply, it's a great library for making command-line stuff with Rust. Even Cargo, Rust's package manager, depends on it [4], and it's been downloaded over 300 million times [5]. Clap stands for Command Line Argument Parser, and put simply, it's a great library for making command-line stuff with Rust. Even Cargo, Rust's package manager, depends on it (*Cargo/cargo.toml at master*), and it's been downloaded over 300 million times (*Clap - Crates.io: Rust package registry*).
Rather than going over everything clap can do, I'll go over how I've used it in my `disk-read-benchmark` program I'll be using in my next blog post. Rather than going over everything clap can do, I'll go over how I've used it in my `disk-read-benchmark` program I'll be using in my next blog post.
@ -58,11 +58,11 @@ fn main() {
} }
``` ```
That's all you need to know to use `clap` at a very basic level; for more details, check out the docs [1]. But, you probably don't want to have to type in the entire command automatically, autocomplete would be nice. So I'll also go over how to use `clap_complete` as well. That's all you need to know to use `clap` at a very basic level; for more details, check out the docs (*clap Documentation*). But, you probably don't want to have to type in the entire command automatically, autocomplete would be nice. So I'll also go over how to use `clap_complete` as well.
## `clap_complete` ## `clap_complete`
Searching through the documentation [2], you'll notice that the docs don't cover how to use it with clap's derive at all. Instead, after some Googling, I found an example script in *clap*'s repository [3], which I then adapted and played around with a bit until I got it figured out. Searching through the documentation (*Clap_complete Documentation*), you'll notice that the docs don't cover how to use it with clap's derive at all. Instead, after some Googling, I found an example script in *clap*'s repository (*completion-derive.rs at master*), which I then adapted and played around with a bit until I got it figured out.
Anyways, again, we need to install `clap_complete` first: Anyways, again, we need to install `clap_complete` first:
@ -163,8 +163,8 @@ generate-zsh-completions (Generate zsh completions) run
## Sources ## Sources
1. <https://docs.rs/clap/latest/clap/> &emsp;- clap contributors. “clap Documentation.” Clap - Rust, [docs.rs/clap/latest/clap/](https://docs.rs/clap/latest/clap/). Accessed 12 Nov. 2024.\
2. <https://docs.rs/clap_complete/latest/clap_complete/> &emsp;- clap_complete contributors. “Clap_complete Documentation.” Clap_complete - Rust, [docs.rs/clap_complete/latest/clap_complete](https://docs.rs/clap_complete/latest/clap_complete). Accessed 12 Nov. 2024.\
3. <https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs> &emsp;- clap contributors. “clap/clap_complete/examples/completion-derive.rs at master · Clap-Rs/Clap.” GitHub, [github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs](https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs). Accessed 12 Nov. 2024.\
4. <https://github.com/rust-lang/cargo/blob/master/Cargo.toml> &emsp;- cargo contributors. “cargo/Cargo.Toml at master · rust-lang/cargo.” GitHub, [github.com/rust-lang/cargo/blob/master/Cargo.toml](https://github.com/rust-lang/cargo/blob/master/Cargo.toml). Accessed 12 Nov. 2024.\
5. <https://crates.io/crates/clap> &emsp;- “Clap - Crates.io: Rust Package Registry.” crates.io, crates.io/crates/clap. Accessed 12 Nov. 2024.

View file

@ -97,17 +97,17 @@
guides you through the already extremely simple guides you through the already extremely simple
installation.</p> installation.</p>
<h2 id="sources">Sources</h2> <h2 id="sources">Sources</h2>
<p>“Install Additional Drivers and Libraries in Vanilla OS.” <p>- “Install Additional Drivers and Libraries in Vanilla OS.”
<em>Vanilla OS Docs</em>, Vanilla OS, <a <em>Vanilla OS Docs</em>, Vanilla OS, <a
href="https://docs.vanillaos.org/handbook/en/install-additional-drivers">docs.vanillaos.org/handbook/en/install-additional-drivers</a>. href="https://docs.vanillaos.org/handbook/en/install-additional-drivers">docs.vanillaos.org/handbook/en/install-additional-drivers</a>.
Accessed 19 Sept. 2024.<br /> Accessed 19 Sept. 2024.<br />
“Vanilla OS Docs.” <em>Vanilla OS</em>, Vanilla OS, <a - “Vanilla OS Docs.” <em>Vanilla OS</em>, Vanilla OS, <a
href="https://docs.vanillaos.org/collections/docs">docs.vanillaos.org/collections/docs</a>. href="https://docs.vanillaos.org/collections/docs">docs.vanillaos.org/collections/docs</a>.
Accessed 19 Sept. 2024.<br /> Accessed 19 Sept. 2024.<br />
<em>Vanilla OS</em>, <a - <em>Vanilla OS</em>, <a
href="https://vanillaos.org">vanillaos.org</a>. Accessed 19 href="https://vanillaos.org">vanillaos.org</a>. Accessed 19
Sept. 2024.<br /> Sept. 2024.<br />
Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” <em>GitHub</em>, <a - Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” <em>GitHub</em>, <a
href="github.com/Vanilla-OS/ABRoot">github.com/Vanilla-OS/ABRoot</a>. href="github.com/Vanilla-OS/ABRoot">github.com/Vanilla-OS/ABRoot</a>.
Accessed 19 Sept. 2024.</p> Accessed 19 Sept. 2024.</p>
<iframe src="https://john.citrons.xyz/embed?ref=askiiart.net" style="margin-left:auto;display:block;margin-right:auto;max-width:732px;width:100%;height:94px;border:none;"></iframe> <iframe src="https://john.citrons.xyz/embed?ref=askiiart.net" style="margin-left:auto;display:block;margin-right:auto;max-width:732px;width:100%;height:94px;border:none;"></iframe>

View file

@ -54,7 +54,7 @@ P.S. I can't get it across while keeping this post decent quality and on-topic,
## Sources ## Sources
“Install Additional Drivers and Libraries in Vanilla OS.” *Vanilla OS Docs*, Vanilla OS, [docs.vanillaos.org/handbook/en/install-additional-drivers](https://docs.vanillaos.org/handbook/en/install-additional-drivers). Accessed 19 Sept. 2024.\ &emsp;- “Install Additional Drivers and Libraries in Vanilla OS.” *Vanilla OS Docs*, Vanilla OS, [docs.vanillaos.org/handbook/en/install-additional-drivers](https://docs.vanillaos.org/handbook/en/install-additional-drivers). Accessed 19 Sept. 2024.\
“Vanilla OS Docs.” *Vanilla OS*, Vanilla OS, [docs.vanillaos.org/collections/docs](https://docs.vanillaos.org/collections/docs). Accessed 19 Sept. 2024.\ &emsp;- “Vanilla OS Docs.” *Vanilla OS*, Vanilla OS, [docs.vanillaos.org/collections/docs](https://docs.vanillaos.org/collections/docs). Accessed 19 Sept. 2024.\
*Vanilla OS*, [vanillaos.org](https://vanillaos.org). Accessed 19 Sept. 2024.\ &emsp;- *Vanilla OS*, [vanillaos.org](https://vanillaos.org). Accessed 19 Sept. 2024.\
Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” *GitHub*, [github.com/Vanilla-OS/ABRoot](github.com/Vanilla-OS/ABRoot). Accessed 19 Sept. 2024. &emsp;- Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” *GitHub*, [github.com/Vanilla-OS/ABRoot](github.com/Vanilla-OS/ABRoot). Accessed 19 Sept. 2024.