mirror of
https://github.com/digarok/install-cadius-action.git
synced 2024-10-31 18:04:28 +00:00
update README.md
This commit is contained in:
parent
15604e6ca6
commit
1bdfbcd09b
14
README.md
14
README.md
@ -19,7 +19,19 @@ A Github Action for installing Cadius and allowing you to manipulate ProDOS disk
|
|||||||
|
|
||||||
# Arguments/Inputs
|
# Arguments/Inputs
|
||||||
|
|
||||||
This action has one input: `include_prodos`. By setting this to true, it will download the latest release of ProDOS (2.4.2) and extract all of the files to a directory called `PRODOS.2.4.2`. This allows you to use those files, if needed, in subsequent steps. So you can create a bootable disk or even add `BASIC.SYSTEM` to launch into AppleSoft BASIC.
|
This action has one input: `include_prodos`. It defaults to true, it will download the latest release of ProDOS (2.4.2) and extract all of the files to a directory called `PRODOS.2.4.2`. This allows you to use those files, if needed, in subsequent steps. So you can create a bootable disk or even add `BASIC.SYSTEM` to launch into AppleSoft BASIC. If you don't need any of the ProDOS files, you can skip this by setting it to false and save a second or two.
|
||||||
|
|
||||||
|
# Usage Recommendations
|
||||||
|
|
||||||
|
1. While you can call Cadius directly from [`run`](https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun) commands as shown above, it makes sense to put your packaging command(s) in a script which can be run locally with the same results.
|
||||||
|
2. Cadius uses a specific file, `_FileInformation.txt` for inferring ProDOS filetype and access information. That is not covered here, see the [Cadius Documentation](http://brutaldeluxe.fr/products/crossdevtools/cadius/).
|
||||||
|
3. This action is intended to pair really well with my [`install-merlin32-action`](https://github.com/digarok/install-merlin32-action) which let's you assembled the 65xx source code to build your object/system files that can then packaged inside a ProDOS image file using this action for immediate use in your emulator or flash drive. I use this workflow to handle build and release all via Github Actions.
|
||||||
|
|
||||||
# About CADIUS
|
# About CADIUS
|
||||||
|
|
||||||
Cadius is a disk image program originally by the amazing French team, Brutal Deluxe. They are not involved with this Open Source version, but I do recommend you view [their site](http://brutaldeluxe.fr/products/crossdevtools/cadius/) for more information on Cadius and their other incredible tools and releases.
|
Cadius is a disk image program originally by the amazing French team, Brutal Deluxe. They are not involved with this Open Source version, but I do recommend you view [their site](http://brutaldeluxe.fr/products/crossdevtools/cadius/) for more information on Cadius and their other incredible tools and releases.
|
||||||
|
|
||||||
|
|
||||||
|
# Further Examples
|
||||||
|
|
||||||
|
For a fully-integrated pipeline, see my example Apple II project here (https://github.com/digarok/apple2-assembly-github-actions-ci-example).
|
||||||
|
Loading…
Reference in New Issue
Block a user