Skip to content
This repository was archived by the owner on Aug 24, 2024. It is now read-only.

Commit ab9f47c

Browse files
committed
docs: Update config examples to v3
1 parent 10c3416 commit ab9f47c

File tree

3 files changed

+60
-38
lines changed

3 files changed

+60
-38
lines changed

docs/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# After-Effects
1+
# Ubuntu Post Installation Script
22

33
An Effortless & Simple post-installation script for Ubuntu, Linux Mint, Elementary OS, Debian and their derivatives.
44

@@ -20,15 +20,15 @@ This script is built for one purpose only. Automating post installation tasks on
2020

2121
### Latest Stable Release (Recommended)
2222

23-
```bash
23+
```console
2424
wget https://github.com/tprasadtp/ubuntu-post-install/releases/latest/download/after-effects -O after-effects
2525
wget https://github.com/tprasadtp/ubuntu-post-install/releases/latest/download/sha256sums.txt -O sha256sums.txt
2626
sha256sum -c sha256sums.txt
2727
```
2828

2929
### Master Branch
3030

31-
```bash
31+
```console
3232
wget https://raw.githubusercontent.com/tprasadtp/ubuntu-post-install/master/after-effects -O after-effects
3333
```
3434

docs/tasks.md

Lines changed: 32 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -105,12 +105,21 @@ Podman repository(provided by Kubic project) also provides golang package for so
105105
106106
## Add personal package archives (PPA)
107107
108-
- List of PPAs
109-
- Logs will show entry in the format `[date and time] [ PPA-Logs ] <log>`
108+
List of PPAs `config.ppa`
109+
110+
```yaml
111+
api: 3
112+
config:
113+
ppa:
114+
# With prefix ppa:
115+
- ppa:yubico/stable
116+
# Without prefix ppa:
117+
- kicad/kicad-5.1-releases
118+
```
110119

111120
## Install apt packages
112121

113-
There are seven list of packages under key config.install.apt.< category >
122+
There are seven list of packages under key `config.install.apt.<category>`
114123

115124
1. administration - Contains Administrative packages
116125
2. security - Contains Security related tools and packages
@@ -136,28 +145,35 @@ This classification is only for ease of use and need not be strictly followed. Y
136145
There is a special package list `config.purge` containing list of packages to be
137146
purged from the system. This only applies if purge flag is set and purge task is enabled (when autopilot is active)
138147

148+
```yaml
149+
api: 3
150+
config:
151+
purge:
152+
- gnome-mines
153+
- gnome-sudoku
154+
- aisleriot
155+
- gnome-mahjongg
156+
```
157+
139158
## Install Debian package archives (.deb files)
140159

141160
This will install deb files specified in the YAML config under `config.install.debs`.
142161

143-
- Each entry is URL to the deb file. URL MUST be `http` or `https`, ftp UTLs are not supported!
162+
- Each entry is URL to the deb file. URL MUST be `http` or `https`, ftp URLs are not supported!
144163

145164
```yaml
146165
api: 3
147166
config:
148167
install:
149168
debs:
150-
- https://atom-installer.github.com/v1.21.1/atom-amd64.deb,ATOM-Editor.deb
151-
169+
- https://atom-installer.github.com/v1.21.1/atom-amd64.deb
152170
```
153171

154-
- First part is the URL to the deb file separated by `,` name of the file.
155-
156172
## Install Static binaries to /usr/local/bin
157173

158174
This will install binaries in YAML config under `config.install.binaries`.
159175

160-
- **Simulate** option **will** download the package but not install it.
176+
- **Simulate** option **will** download the binary but not install it.
161177
- Configuration is of format `binary-name::URL`. Binary name **MUST** mach regex `^([a-zA-z0-9_-]+)$`.
162178
- For example, to install `kubectl`, the entry should look like below.
163179

@@ -170,16 +186,11 @@ config:
170186
171187
```
172188

173-
!!! note "Note on file names in configuration"
174-
Please note that file will be saved with the name mentioned in the file and will be in your path.
175-
176189
## Purge Unwanted Packages
177190

178191
This will purge Unwanted packages from the system.
179192

180-
- The packages mentioned in `config.purge` in yaml.
181-
- The format is similar to that of packages, one package per line
182-
193+
- The packages mentioned in list `config.purge` in yaml.
183194
!!! warning
184195
It is necessary to pass command line argument `-d` or set `config.flags.purge_enabled: true` in config.
185196

@@ -245,22 +256,22 @@ config:
245256

246257
| Name | Key |
247258
| ------------------------------------------------------------------------------------------ | ------------- |
248-
| [Add Repositories](#add-repositories) | `repo` |
259+
| Update APT Metadata(Same as running `apt-get update`) | `update` |
260+
| Upgrade packages | `upgrade` |
261+
| [Add Repositories](#add-repositories) | `add_repo` |
249262
| [Add personal package archives (PPA)](#add-personal-package-archives-ppa) | `ppa` |
250263
| [Install apt packages](#install-apt-packages) | `apt` |
251-
| [Install Debian package archives (.deb files)](#install-debian-package-archives-deb-files) | `dev` |
264+
| [Install Debian package archives (.deb files)](#install-debian-package-archives-deb-files) | `debs` |
252265
| [Install Static binaries to /usr/local/bin](#install-static-binaries-to-usrlocalbin) | `binaries` |
253266
| [Purge Unwanted Packages](#purge-unwanted-packages) | `purge` |
254267
| [Installing Snap packages](#installing-snap-packages) | `snaps` |
255-
| [All In one](#all-in-one) | `all` |
256268

257269
## Delete logs
258270

259271
A log file is generated containing all the output generated by the apt and other commands
260272

261-
- This task will delete the log file `after-effects.log`.
262-
- Log file is located in the directory `logs` in folder which you ran thin script.
263-
- Sometimes errors might not be written to log file but displayed on screen and vice-versa.
273+
- This task will delete the log file `after-effects.log` in logs folder
274+
264275

265276
[Miniconda]: https://www.anaconda.com/blog/rpm-and-debian-repositories-for-miniconda
266277
[Brave Browser]: https://brave.com/linux/

docs/yaml.md

Lines changed: 25 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ config:
1515
upgrade: false
1616
# Add Repos
1717
# individual repos flags are mentioned under config.add_repo key
18-
repo: true
18+
add_repo: true
1919
# Add PPAs
2020
ppa: true
2121
# APT Packages
@@ -27,28 +27,40 @@ config:
2727
snaps: true
2828
# Repository Flags
2929
add_repo:
30-
brave_browser: true
3130
azurecli: true
3231
bazel: true
32+
brave_browser: true
3333
chrome: true
3434
docker: true
3535
edge: true
36-
gcsfuse: true
36+
gcsfuse: false
3737
github: true
3838
googlecloud: true
3939
gvisor: true
4040
hashicorp: true
4141
mendeley: false
42+
miniconda: true
43+
neurodebian: true
4244
podman: true
45+
protonvpn: true
4346
ros: true
4447
ros2: true
4548
signal: true
4649
skype: true
4750
spotify: true
51+
slack: true
4852
sublimetext: true
4953
teams: true
54+
vivaldi: true
5055
vscode: true
5156
winehq: true
57+
# Debian
58+
debian_nonfree: true
59+
debian_contrib: true
60+
# Ubuntu
61+
ubuntu_universe: true
62+
ubuntu_multiverse: true
63+
ubuntu_restricted: true
5264

5365
# Flags
5466
flags:
@@ -64,33 +76,31 @@ config:
6476
# PPA List
6577
ppa:
6678
- ppa:yubico/stable
79+
- kicad/kicad-5.1-releases
6780
# Install components
6881
# APT Packages, Python Modules, Debian packages
6982
install:
70-
# Debian packages: .deb files
71-
# CSV format similar to lists
72-
debian_packages:
73-
- https://download.teamviewer.com/download/teamviewer_i386.deb,TeamViewer.deb
83+
# Debian packages: .deb files
84+
debs:
85+
- https://download.teamviewer.com/download/teamviewer_i386.deb
86+
- https://github.com/sharkdp/bat/releases/download/v0.17.1/bat_0.17.1_amd64.deb
7487
# Static Binaries which will be placed in /usr/local/bin
75-
# minikube, docker-compose, etc.
76-
# Follows same pattern as Debian packages
77-
# Name to be saved is second field
88+
# <binary-name-as-available-in-path>::<URL>
7889
binaries:
79-
- https://github.com/kubernetes/minikube/releases/download/v0.28.2/minikube-linux-amd64,minikube
80-
- https://github.com/kubernetes/kompose/releases/download/v1.19.0/kompose-linux-amd64,kompose
90+
- minikube::https://github.com/kubernetes/minikube/releases/download/v0.28.2/minikube-linux-amd64
91+
- kompose::https://github.com/kubernetes/kompose/releases/download/v1.19.0/kompose-linux-amd64
8192
apt:
8293
# Admin related Stuff
8394
administration:
8495
- dconf-editor
8596
- htop
8697
- apt-xapian-index
87-
- gdebi
8898
- gparted
8999
- synaptic
90100
- bleachbit
91101
# Security Related Stuff
92102
security:
93-
- gufw
103+
- firewalld
94104
# Productivity & Office Tools.
95105
productivity:
96106
- pandoc
@@ -132,6 +142,7 @@ config:
132142
- google-chrome-stable
133143
- spotify-client
134144
- code
145+
- conda
135146
- google-cloud-sdk
136147
- docker-ce
137148
- runsc

0 commit comments

Comments
 (0)