docs: refactor: create a seprte README for scripts
This commit is contained in:
@@ -32,9 +32,7 @@ If you want to execute custom shell scripts or commands in the image build, you
|
||||
|
||||
Instead, you can create shell scripts in the `scripts/` directory (look at the `example.sh`). After creating your scripts, enable them in the `scripts:` section of your `recipe.yml`, within the specific "build stage" category where the scripts are intended to be executed.
|
||||
|
||||
Your scripts will be given exactly one argument when they are executed, which specifies its precise execution phase and corresponds to the name of the `scripts:` category that it was assigned to. The primary purpose of this argument is to streamline the reuse of scripts for multiple stages.
|
||||
|
||||
If you're looking for a fully automated script runner, you should read the code of the included `scripts/autorun.sh` to see how it works, and then simply specify that as your script in `recipe.yml`. You can also add manually listed scripts in addition to the auto-runner, which can be very useful when managing multiple recipes.
|
||||
Read [the README in the `scripts/` directory](https://github.com/ublue-os/startingpoint/blob/main/scripts/README.md) for more information.
|
||||
|
||||
### Custom package repositories
|
||||
|
||||
|
||||
9
scripts/README.md
Normal file
9
scripts/README.md
Normal file
@@ -0,0 +1,9 @@
|
||||
# Custom scripts
|
||||
|
||||
You can add custom scripts to this directory and declare them to be run at build time in the `scripts:` section of `recipe.yml`. Custom scripts can be run at either the `pre:` execution phase right after the custom repositories are added, or at the `post:` phase after all of the automatic build steps.
|
||||
|
||||
Your scripts will be given exactly one argument when they are executed, which specifies its precise execution phase (`pre` or `post`). The primary purpose of this argument is to streamline the reuse of scripts for multiple stages.
|
||||
|
||||
## `autorun.sh`
|
||||
|
||||
`autorun.sh` is enabled by default and automatically runs all scripts in the folders `scripts/pre/` and `scripts/post/` at the correct execution phases.
|
||||
Reference in New Issue
Block a user