updated the instructions readme file

This commit is contained in:
Tio TROM 2022-06-16 14:36:24 +02:00
parent 7874b83431
commit fa9b26acaa
1 changed files with 11 additions and 57 deletions

View File

@ -2,80 +2,33 @@
Configuration to build latest TROMjaro ISO
**See adding packages to custom repo**: [Adding/Removing-Packages](https://gitlab.com/tromsite/tromjaro/iso-profiles/wikis/TROMjaro-Repository---Adding/Removing-Packages)
## Prerequisites
Install Manjaro Tools
To get started you need to the following meta-package:
Install the following packages
```
pamac install manjaro-tools-iso git
manjaro-tools-base-git
manjaro-tools-iso-git
```
Download the latest TROMjaro Profile:
```
git clone https://gitlab.com/tromsite/tromjaro/iso-profiles.git ~/iso-profiles
git clone https://git.trom.tf/TROMjaro/iso-profiles-settings
```
Choose where to clone/copy it. Let's name that `path`.
## Getting Started
The ISO profile for TROMjaro can now be found at:
# Build it
```
~/iso-profiles/tromjaro/gnome
```
Let's take a closer look at the gnome profile folder (marked above):
Before building it, we have to copy the `/etc/manjaro-tools/` folder to the `.config` folder in the Home directory. So it will look like `.config/manjaro-tools/`
```
**desktop-overlay**
live-overlay -> ../../shared/manjaro/live-overlay
**Packages-Desktop**
Packages-Live -> ../../shared/Packages-Live
Packages-Mhwd -> ../../shared/Packages-Mhwd
Packages-Root -> ../../shared/Packages-Root
**profile.conf**
```
- **desktop-overlay**: After every successful installation of your ISO the files and folders in here will get copied over.
- live-overlay: Similar to desktop-overlay. Files and folders in here will only get copied over to the LiveCD of your ISO.
- **Packages-Desktop**: This file contains packages for the ISO installation. All packages will also get installed on LiveCDs.
- Packages-Live: This file contains packages, which will only get installed on the LiveCD.
- Packages-Mhwd: This file contains Mhwd packages important to all Manjaro installations and LiveCDs.
- Packages-Root: This file contains base packages important to all Manjaro installations and LiveCDs.
- **profile.conf** contains basic settings for your ISO installation and LiveCD.
In that folder we have the file `iso-profiles.conf`. Make sure you add this to the file, to basically tell the ISO Tools where to get the profile files from: `run_dir=path/iso-profiles/iso-profiles-settings`
As you have probably noticed, several are only symlinks to the shared ISO profile. It is good practice to never change files or folders in the shared ISO profile. If you ever want to change them, first copy them to your ISO profile folder and delete the symlink.
Replace `path` with the path where you have cloned our ISO Profile.
All folders and files specific to your ISO are in bold. You can change them to your liking.
## Live boot hack
First backup:
```
mkdir ~/mysafespace && cp /etc/lsb-release ~/mysafespace/lsb-release
```
Then copy the following:
```
sudo cp ~/iso-profiles/tromjaro/lsb-release /etc/lsb-release
```
**IMPORTANT**
When build is complete please ensure to restore your lsb-release file:
```
sudo cp ~/mysafespace/lsb-release /etc/lsb-release
```
### Build your ISO
Build TROMjaro with the following command:
```
buildiso -p gnome
```
**Attention**: The build process needs at least 10 minutes to complete or much longer when you are using HDDs, slow CPUs, or large ISOs.
Lastly, open the terminal and do `buildiso -p xfce`
When the build process finishes successfully, the ISO file and the package list will appear in this folder:
@ -83,6 +36,7 @@ When the build process finishes successfully, the ISO file and the package list
/var/cache/manjaro-tools/iso/
```
## Cleaning your hard drive
After a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder: