feat(managing-files): first cut of the chapter

dwmkerr · May 20, 2020 · beb3d94 · beb3d94
1 parent ee34f42
commit beb3d94
Show file tree

Hide file tree

Showing 27 changed files with 374 additions and 1 deletion.
diff --git a/effective-shell-playground/pictures/.notes b/effective-shell-playground/pictures/.notes
@@ -0,0 +1 @@
+Don't forget to watermark these images before we share them!
diff --git a/...playground/pictures/nepal-mardi-himal.JPG → ...layground/pictures/nepal-mardi-himal.jpeg b/...playground/pictures/nepal-mardi-himal.JPG → ...layground/pictures/nepal-mardi-himal.jpeg
diff --git a/effective-shell-playground/quotes/iain-banks.txt b/effective-shell-playground/quotes/iain-banks.txt
@@ -0,0 +1,3 @@
+“The trouble with writing fiction is that it has to make sense, whereas real life doesn't.”
+
+― Iain M. Banks
diff --git a/effective-shell-playground/quotes/ursula-le-guin.txt b/effective-shell-playground/quotes/ursula-le-guin.txt
@@ -0,0 +1,2 @@
+“What sane person could live in this world and not be crazy?”
+― Ursula K. LeGuin
diff --git a/structure.md b/structure.md
@@ -47,6 +47,7 @@ This document contains the proposed structure of the book. It is still work in p
     * [Chapter 28 - The Multiplexer](#chapter-28---the-multiplexer)
     * [Chapter 29 - Writing Tools that Follow The Unix Philosophy](#chapter-29---writing-tools-that-follow-the-unix-philosophy)
 * [Interlude - The Future](#interlude---the-future)
+    * [Missing Pieces](#missing-pieces)
 
 <!-- vim-markdown-toc -->
 
@@ -83,7 +84,7 @@ These are the key skills which everyone should know. Without them, you might str
 
 Switching from a graphical user interface to the shell can take some getting used to. First we'll take a look at how to navigate your system using the shell, and get information on files and folders in the system.
 
-This section will touch on the `pwd`, `cd`, `ls`, `pushd` and `popd` commands, as well as introducing the concept of the "working directory" and "environment variables".
+This chapter will introduce the `wget`, `unzip`, `cp`, `mv`, `rm`, `mkdir`, and `rmdir` commands. We'll also briefly look at `cat`, _wildcards_ and _redirection_.
 
 #### Chapter 3 - Managing Your Files
 
@@ -254,3 +255,13 @@ To finish the book, we'll look at how you can write tools which integrate seamle
 ### Interlude - The Future
 
 The shell, in particular the Bourne-Again Shell has been popular for many years. But what does the future hold? With the advent of the Linux Subsystem for Windows, new shells like Nushell, and the latest version of MacOS switching from Bash to Z-Shell, we finish off by looking at some of the trends which might shape how we use shells in the future.
+
+#### Missing Pieces
+
+This section contains the things which have been pulled out of chapters as they made them too big, or don't fit in a chapter yet:
+
+- `find` was in 'managing files
+- `globs` was in 'managing files
+- `curl` was in managing files
+- `df` to find out free space, or also how to find out how much space a folder takes up
+- `$IFS` to avoid easily avoidable errors
diff --git a/.../content/docs/part-1-transitioning-to-the-shell/2-managing-your-files/_index.md b/.../content/docs/part-1-transitioning-to-the-shell/2-managing-your-files/_index.md
diff --git a/...part-1-transitioning-to-the-shell/2-managing-your-files/images/cat-redirect.png b/...part-1-transitioning-to-the-shell/2-managing-your-files/images/cat-redirect.png
diff --git a/...part-1-transitioning-to-the-shell/2-managing-your-files/images/cat-wildcard.png b/...part-1-transitioning-to-the-shell/2-managing-your-files/images/cat-wildcard.png
diff --git a/...ent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/cat.png b/...ent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/cat.png
diff --git a/.../part-1-transitioning-to-the-shell/2-managing-your-files/images/cp-wildcard.png b/.../part-1-transitioning-to-the-shell/2-managing-your-files/images/cp-wildcard.png
diff --git a/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/cp.png b/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/cp.png
diff --git a/...rt-1-transitioning-to-the-shell/2-managing-your-files/images/file-jpeg-info.png b/...rt-1-transitioning-to-the-shell/2-managing-your-files/images/file-jpeg-info.png
diff --git a/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/file.png b/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/file.png
diff --git a/...docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/ls-home.png b/...docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/ls-home.png
diff --git a/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mkdir.png b/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mkdir.png
diff --git a/.../docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mkdirp.png b/.../docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mkdirp.png
diff --git a/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mv.png b/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/mv.png
diff --git a/...-transitioning-to-the-shell/2-managing-your-files/images/rm-error-directory.png b/...-transitioning-to-the-shell/2-managing-your-files/images/rm-error-directory.png
diff --git a/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/rm.png b/...tent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/rm.png
diff --git a/...s/part-1-transitioning-to-the-shell/2-managing-your-files/images/rmdir-fail.png b/...s/part-1-transitioning-to-the-shell/2-managing-your-files/images/rmdir-fail.png
diff --git a/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/rmdir.png b/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/rmdir.png
diff --git a/.../part-1-transitioning-to-the-shell/2-managing-your-files/images/tree-quotes.png b/.../part-1-transitioning-to-the-shell/2-managing-your-files/images/tree-quotes.png
diff --git a/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/tree.png b/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/tree.png
diff --git a/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/unzip.png b/...t/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/unzip.png
diff --git a/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/wget.png b/...nt/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/wget.png
diff --git a/...ent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/zip.png b/...ent/docs/part-1-transitioning-to-the-shell/2-managing-your-files/images/zip.png
diff --git a/website/content/menu/index.md b/website/content/menu/index.md
@@ -7,6 +7,7 @@ bookMenuLevels: 1
  - [**Getting Started**]({{< relref "/docs/1-getting-started" >}})
  - [**Part 1 - Transitioning to the Shell**]({{< relref "/docs/part-1-transitioning-to-the-shell" >}})
    - [Navigating Your System]({{< relref "/docs/part-1-transitioning-to-the-shell/1-navigating-your-system" >}})
+   - [Managing Your Files]({{< relref "/docs/part-1-transitioning-to-the-shell/2-managing-your-files" >}})
    - [Navigating the Command Line]({{< relref "/docs/section1/1-navigating-the-command-line" >}})
    - [Clipboard Gymnastics]({{< relref "/docs/section1/2-clipboard-gymnastics" >}})
    - [Getting Help]({{< relref "/docs/section1/3-getting-help" >}})
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Don't forget to watermark these images before we share them!
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		“The trouble with writing fiction is that it has to make sense, whereas real life doesn't.”

		― Iain M. Banks
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		“What sane person could live in this world and not be crazy?”
		― Ursula K. LeGuin