install-web-dev-software/index.html at master · code-warrior/install-web-dev-software · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!DOCTYPE html>
<html lang="en">
<head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Web Development Software Installation</title>
   <style>
@import url('https://fonts.googleapis.com/css?family=Source+Code+Pro|Thasadith:400,400i,700,700i');

:root {
   font-family: 'Thasadith', sans-serif;
   font-size: 22px;
}

body {
   margin: auto;
   width: 960px;
}

ol {
   margin-left: -40px;
}

code,
kbd {
   font-size: 16px;
   font-family: 'Source Code Pro', monospace;
}

kbd {
   padding: 0 4px;
   border: 2px solid #eee;
   border-radius: 4px;
}

h1 {
   width: 540px;
   margin: 24px auto 0;
   text-align: center;
   letter-spacing: 2px;
   word-spacing: 8px;
}

h2,
h3,
ul {
   margin: 0;
}

li {
   margin: 4px 0;
}
   </style>
</head>
<body>
   <header>
      <h1>WEB DEVELOPMENT SOFTWARE INSTALLATION</h1>
      <p>v1.0.5</p>
   </header>
   <main>
      <p>The script included in this repo installs Mac-related configuration files and software required for any web development course you take with me. Before continuing, open a GitHub account at <a href="https://github.com/" target="_blank" rel="noopener">https://github.com/</a>, regardless of whether you use Windows, Mac OS, or Linux.</p>
      <h2>Mac OS Users</h2>
      <h3>What This Script Does to Your Mac</h3>
      <ol>
         <li>Runs Software Update</li>
         <li>Installs the Command Line Tools</li>
         <li>Enables Mac OS’s ability to cycle through IP address, hostname, and OS version when clicking the clock in the login window</li>
         <li>Enables UTF-8 input into The Terminal</li>
         <li>Installs the Homebrew package manager</li>
         <li>Installs the IBM Plex Mono typeface</li>
         <li>Installs the Ubuntu Mono typeface</li>
         <li>Installs <code>.editorconfig</code></li>
         <li>Installs <code>.stylelintrc.json</code></li>
         <li>Installs <code>.git-prompt.sh</code></li>
         <li>Installs <code>.git-completion.sh</code></li>
         <li>Installs <code>.bash_aliases</code></li>
         <li>Installs <code>.bashrc</code></li>
         <li>Installs <code>.bash_profile</code></li>
         <li>Optionally installs <code>.sass-lint.yml</code></li>
         <li>Optionally installs <code>.eslintrc.json</code></li>
         <li>Installs the <i>Tomorrow Night</i> theme for The Terminal</li>
         <li>Installs Rectangle</li>
         <li>Installs VS Code</li>
         <li>Installs GitHub Desktop</li>
      </ol>

      <h3>Installation</h3>
      <p>The enclosed script installs Mac-based HTML-, CSS-, Sass-, and JavaScript-related software and configuration files for any web development course you take with me. If you’re using macOS Catalina, Big Sur, or Monterey, then you’ll first need to grant The Terminal access to your disk. Follow <a href="https://osxdaily.com/2018/10/09/fix-operation-not-permitted-terminal-error-macos/" target="_blank" rel="noopener">this tutorial</a>, then proceed below.</p>
      <h4>1 / Open The Terminal</h4>
      <p>The Terminal is called <code>Terminal.app</code> and is in <code>/Applications/Utilities</code>. Alternatively, you can perform a Spotlight search for “Terminal”.</p>
      <h4>2 / Navigate to The Root of This Repo</h4>
      <p>In The Terminal, type <kbd>cd</kbd> followed by a space. Locate the <code>install-web-dev-software</code> folder (this repo). Click the folder icon in the top of the tab bar and drag it into The Terminal’s window. Hit <kbd>return</kbd>.</p>
      <h4>3 / Grant the Script Access</h4>
      <p>Give the script executable access to your file system by typing the following: <code>chmod 755 install.sh</code></p>
      <h4>4 / Run The Installer</h4>
      <p>Type <kbd>./install.sh</kbd> and then hit <kbd>return</kbd>.</p>

      <h3>Update bash to v5</h3>
      <p>Source: <a href="https://itnext.io/upgrading-bash-on-macos-7138bd1066ba" target="_blank" rel="noopener">Upgrading Bash on macOS</a> by Daniel Weibel</p>

      <ol>
        <li>Launch The Terminal</li>
        <li>Run <code>brew install bash</code></li>
        <li>Edit the shells file using Atom: <code>sudo atom /etc/shells</code></li>
        <li>Add <code>/usr/local/bin/bash</code> to the tail of the <code>shells</code> file</li>
        <li>Set the default shell for the current user: <code>chsh -s /usr/local/bin/bash</code></li>
      </ol>

      <h2>Windows and Linux Users</h2>
      <p>All the software you need must be downloaded/installed manually. Visit the <b>Software Requirements</b> section of the syllabus to the course you’re taking with me for more.</p>
   </main>
</body>
</html>