Skip to content

README.md

Latest commit

 

History

History
103 lines (68 loc) · 8.9 KB

README.md

File metadata and controls

103 lines (68 loc) · 8.9 KB
Raw

Artwork and terminal demos

The README and getting-started guide use local images, established project logos, and a terminal Easter egg. The source files and credits are kept here so the page can be maintained alongside the notes.

Cover and journey

Asset Purpose
linux-lab-hero.svg Wide cover with classic Tux and a dark terminal.
linux-lab-hero-mobile.svg Compact cover for narrow screens.
linux-lab-journey.svg The purple learning route, with current and future topics.

The covers embed the original Tux PNG. These are layouts built for the repository, not screenshots of a personal desktop. The SVG text and geometry are editable; the embedded Tux artwork retains its creator credit and original terms.

The repository-specific layout code uses the MIT license. The third-party artwork and logos below retain their own terms.

Lesson covers

The Linux command chapters use explanatory covers with a palette chosen for each topic. Chapter 07 pairs dark cherry with amber and rose to separate output streams; chapter 08 uses pale pistachio and green to break down permission modes. The Bash covers use aubergine, peach, and green. Each has a compact version for narrow screens. The original Tux, Bash, and Ubuntu artwork are embedded unchanged, with Larry Ewing's credit and the project logo credits.

Chapter Wide cover Compact cover What the diagram shows
Files and Directories SVG SVG A notes folder containing two empty files, matching the chapter's commands.
Viewing File Content SVG SVG The first and last three lines of the supplied 12-line session. Excerpts omit timestamps and log levels for space.
Copying, Moving, and Deleting SVG SVG Copying keeps the original note and adds a backup; moving renames the backup. Directory prefixes are omitted for space.
Searching and Finding SVG SVG Finding a file, then selecting its two error lines. The path is shortened; timestamps and log levels are omitted.
Text Processing SVG SVG The six supplied labels become three frequency counts. Bar lengths show the counts.
Redirection and Pipes SVG SVG cat sends the note's contents and a missing-file diagnostic through separate stdout and stderr routes to two files.
Permissions and Ownership SVG SVG The actual chmod 640 note.txt example: owner read/write, group read, and no access for others.
Bash 01: Shell and Script Basics SVG SVG The complete hello.sh source, the command that runs it, and its actual greeting.
Bash 02: Variables and Expansion SVG SVG The two greetings from quoting.sh, showing expansion inside double quotes and literal text inside single quotes.
Bash 03: Input and Output SVG SVG One answer travels from read through a variable to printf. The course prompt and summary heading from input.sh are omitted.
Bash 04: Operators and Expressions SVG SVG Integer division produces the value 3; a true arithmetic comparison leaves exit status 0.

These are diagrams, not terminal screenshots. Their meaning is also explained in the lessons and image descriptions. The layout code uses the repository's MIT license; the third-party artwork retains its original terms.

To rebuild the covers, using Python's standard library:

python3 assets/source/lesson-covers.py

The source keeps the colours, labels, and layouts together. It reads the existing Tux image, Bash logo, and Ubuntu logo locally and needs no downloads or image-generation service.

Project logos

Downloaded logos are stored unmodified. Their presence identifies the tools discussed in the notes.

Local file Creator and original source Terms
ubuntu.svg Canonical Ltd., official Circle of Friends SVG from Ubuntu design resources. Ubuntu and the Circle of Friends are Canonical trademarks. See Canonical's usage policy.
bash.svg, bash-dark.svg Designed by Prospect One, copyright 2016 Free Software Foundation. Original logo project, designer's downloads. Free Art License 1.3. The two official variants suit light and dark backgrounds.
git.svg Jason Long, official Git logo downloads. Original SVG. CC BY 3.0.
vscode.svg Microsoft Corporation. Extracted from the official icon archive. Microsoft retains its trademark rights. The brand guidelines cover use in documentation and tutorials.

The Bash source files are the dark-outline variant and the light-outline variant, respectively.

Tux

tux.png is Tux, by Larry Ewing, created using The GIMP.

The PNG is unmodified, including where it is embedded in the cover SVGs. Its original reuse terms and creator credit apply.

Illustrated avatar

shaikh-mahad-avatar.png uses the hooded character illustration supplied for this README. The built-in imagegen tool was used to create a transparent cutout, replacing the real profile photograph. This supplied artwork is separate from the repository's MIT-licensed code.

The edit instructions record the requested transformation and tool used.

Terminal Easter egg

terminal-playground.gif loops actual sl character output followed by cowsay "mahad is dumb". terminal-playground.svg is the static version used for reduced motion. It is a styled replay of captured output with illustrative typing and timing.

The renderer captures the train in a temporary tmux session and reads the cow's output. It does not access an existing tmux session.

Credits:

To rebuild the Easter egg on Ubuntu:

sudo apt install sl cowsay tmux librsvg2-2 libcairo2 fonts-dejavu-core
python3 assets/source/terminal-playground.py

These are asset-maintenance commands. Readers do not need these packages for the lessons.

Command replay source

terminal-demo.py contains the shared SVG and GIF rendering utilities. It can also regenerate terminal-demo.gif and terminal-demo.svg, which show the existing hello.sh example, remainder arithmetic, and an exit status.

python3 assets/source/terminal-demo.py

This uses Python 3, Bash, native librsvg and Cairo, and DejaVu fonts on Linux. It needs no Python packages or network access. The main README uses the train-and-cow Easter egg.