From 6a7dc115dd4ead54db7bb763193dda123a45187a Mon Sep 17 00:00:00 2001 From: askiiart Date: Tue, 12 Nov 2024 15:37:32 -0600 Subject: [PATCH] do sources better --- blog/building-blendos.html | 6 ++-- blog/building-blendos.md | 4 +-- blog/using-clap.html | 60 +++++++++++++++++++++----------------- blog/using-clap.md | 16 +++++----- blog/vanilla-os.html | 8 ++--- blog/vanilla-os.md | 8 ++--- 6 files changed, 55 insertions(+), 47 deletions(-) diff --git a/blog/building-blendos.html b/blog/building-blendos.html index ad5678a..963422f 100644 --- a/blog/building-blendos.html +++ b/blog/building-blendos.html @@ -108,11 +108,11 @@ | | |-------------------------|

Citations

-

 Saraswat, Rudra, et al. “blendOS · GitLab.” GitLab, -  - Saraswat, Rudra, et al. “blendOS · GitLab.” + GitLab, git.blendos.co/blendOS. Accessed 2 Oct. 2024.
-  Saraswat, Rudra, and Asterisk. “blendOS / image-builder · +  - Saraswat, Rudra, and Asterisk. “blendOS / image-builder · GitLab.” GitLab, git.blendos.co/blendOS/image-builder. Accessed 3 Oct. 2024.

diff --git a/blog/building-blendos.md b/blog/building-blendos.md index e9d284d..56caa57 100644 --- a/blog/building-blendos.md +++ b/blog/building-blendos.md @@ -82,5 +82,5 @@ From the buid log: ## Citations - Saraswat, Rudra, et al. “blendOS · GitLab.” *GitLab*, [git.blendos.co/blendOS](https://git.blendos.co/blendOS). Accessed 2 Oct. 2024.\ - 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. + - Saraswat, Rudra, et al. “blendOS · GitLab.” *GitLab*, [git.blendos.co/blendOS](https://git.blendos.co/blendOS). Accessed 2 Oct. 2024.\ + - 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. diff --git a/blog/using-clap.html b/blog/using-clap.html index ab3f202..cca8205 100644 --- a/blog/using-clap.html +++ b/blog/using-clap.html @@ -10,8 +10,10 @@

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].

+ 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.

@@ -63,16 +65,19 @@ } }

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.

+ 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

-

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:

generate-fish-completions  (Generate fish completions)  prep-dirs  (Prepares the directories so other programs can prepare their datasets)
 generate-zsh-completions    (Generate zsh completions)  run                                                                  (Runs it all)

Sources

-
    -
  1. https://docs.rs/clap/latest/clap/
    2. -
  2. https://docs.rs/clap_complete/latest/clap_complete/
    3. -
  3. https://github.com/clap-rs/clap/blob/master/clap_complete/examples/completion-derive.rs
    4. -
  4. https://github.com/rust-lang/cargo/blob/master/Cargo.toml
    5. -
  5. https://crates.io/crates/clap
    6. -
+

 - clap contributors. “clap Documentation.” Clap - Rust, docs.rs/clap/latest/clap/. + Accessed 12 Nov. 2024.
+  - clap_complete contributors. “Clap_complete Documentation.” + Clap_complete - Rust, docs.rs/clap_complete/latest/clap_complete. + Accessed 12 Nov. 2024.
+  - 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. + Accessed 12 Nov. 2024.
+  - cargo contributors. “cargo/Cargo.Toml at master · + rust-lang/cargo.” GitHub, github.com/rust-lang/cargo/blob/master/Cargo.toml. + Accessed 12 Nov. 2024.
+  - “Clap - Crates.io: Rust Package Registry.” crates.io, + crates.io/crates/clap. Accessed 12 Nov. 2024.

diff --git a/blog/using-clap.md b/blog/using-clap.md index d029366..ae7148e 100644 --- a/blog/using-clap.md +++ b/blog/using-clap.md @@ -1,6 +1,6 @@ # 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. @@ -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` -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: @@ -163,8 +163,8 @@ generate-zsh-completions (Generate zsh completions) run ## Sources -1. -2. -3. -4. -5. + - clap contributors. “clap Documentation.” Clap - Rust, [docs.rs/clap/latest/clap/](https://docs.rs/clap/latest/clap/). Accessed 12 Nov. 2024.\ + - 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.\ + - 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.\ + - 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.\ + - “Clap - Crates.io: Rust Package Registry.” crates.io, crates.io/crates/clap. Accessed 12 Nov. 2024. diff --git a/blog/vanilla-os.html b/blog/vanilla-os.html index 4a7708e..ea6678a 100644 --- a/blog/vanilla-os.html +++ b/blog/vanilla-os.html @@ -97,17 +97,17 @@ guides you through the already extremely simple installation.

Sources

-

“Install Additional Drivers and Libraries in Vanilla OS.” +

 - “Install Additional Drivers and Libraries in Vanilla OS.” Vanilla OS Docs, Vanilla OS, docs.vanillaos.org/handbook/en/install-additional-drivers. Accessed 19 Sept. 2024.
- “Vanilla OS Docs.” Vanilla OS, Vanilla OS, Vanilla OS, Vanilla OS, docs.vanillaos.org/collections/docs. Accessed 19 Sept. 2024.
- Vanilla OS, Vanilla OS, vanillaos.org. Accessed 19 Sept. 2024.
- Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” GitHub, GitHub, github.com/Vanilla-OS/ABRoot. Accessed 19 Sept. 2024.

diff --git a/blog/vanilla-os.md b/blog/vanilla-os.md index 256fce0..8541b8d 100644 --- a/blog/vanilla-os.md +++ b/blog/vanilla-os.md @@ -54,7 +54,7 @@ P.S. I can't get it across while keeping this post decent quality and on-topic, ## 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.\ -“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.\ -Vanilla-OS. “GitHub: Vanilla-Os/Abroot.” *GitHub*, [github.com/Vanilla-OS/ABRoot](github.com/Vanilla-OS/ABRoot). Accessed 19 Sept. 2024. + - “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.\ + - *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.