A repository of scripts used to launch the publisher, manage the local publishing environment and ensure both scripts and publisher are 'current'
the _updatePublisher.bat
and _updatePublisher.sh
scripts do the following:
- Check if we're online
- Actually the check is to see if the FHIR terminology server is up. If you know you're online and you get a message "we're offline", just try later or manually download the IG Publisher jar file.
- Checks if the IG Publisher jar is in the folder
input-cache
, and asks whether to download or update it from its permanent location - Check if the publisher is in the folder
..
. If there is no publisher jar ininput-cache
but there is such a jar in the parent of the current folder, the script considers that as the target destination of the jar. This is because some authors don't want to have a 100MB+ jar file for each implementationGuide, having to update all of those when there is a new release. - Update these scripts including itself.
If the argument /f
is passed to the script, it skips all prompts and downloads the jar. This is used in automated updates and build processes.
the _genonce.bat
and _genonce.sh
scripts
- Check if we're online (i.e. if tx.fhir.org is reachable)
- Runs the publisher to build the IG from the current folder and exits when done.
the _gencontinuous.bat
and _gencontinuous.sh
scripts
- Check if we're online (i.e. if tx.fhir.org is reachable)
- Runs the publisher to build the IG from the current folder and monitors for file changes, in which case it will build again, until the user exits.
Security note
These scripts are intended to download executables, and can easily trigger antivirus software; In addition, security settings on the machine or domain may block some of these actions. If you encounter such issues and you can't get around them, then you may: a) download the jar manually from its permanent location into theinput-cache
or parent folder, instead of usingupdatePublisher
and/or
b) run the command line yourself instead of usinggenonce
:
input-cache\publisher.jar" -ig .
or
..\publisher.jar" -ig .