Installation instructions for the Breccia Web imager
initial set-up
1+ Ensure the following projects are installed.
• Makeshift
: see http://reluk.ca/project/Makeshift/
• Breccia to X-Breccia
: see http://reluk.ca/project/Breccia/XML/translator/
• The plain Breccia parser
: see http://reluk.ca/project/Breccia/parser/plain/
2+ Install the files of the present project.
>+ cd <command directory>/
/ The command directory is where project installations are accessible by their
proper paths. The present project, for example, will shortly be accessible
at `Breccia/Web/imager`.
: see `^*command directory$` @ http://reluk.ca/project/glossary.brec
>+ git clone http://reluk.ca/var/repo/git/Breccia.Web.imager.git Breccia/Web/imager
3+ Build the software.
: join @ http://reluk.ca/project/Java/project_installation.brec
>+ build Breccia/Web/imager class-files
4+ Test your access to the `breccia-web-image` command.
>+ Breccia/Web/imager/bin/breccia-web-image -help
/
⇒ Usage: breccia-web-image [<options>] <boundary path>
⋮
5+ Test your access to the runtime event log.
>+ test-logging Breccia.Web.imager
/
⇒ Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand execute
OFF: Logging at levels `OFF`, `SEVERE`, `WARNING`, `INFO`, `CONFIG`, `FINE`, `FINER`, `FINEST` and `ALL`:
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
OFF: Testing at level OFF
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
SEVERE: Testing at level SEVERE
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
WARNING: Testing at level WARNING
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
INFO: Testing at level INFO
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
CONFIG: Testing at level CONFIG
Nov. 07, 2020 9:46:47 P.M. Java.LoggingTestCommand test
FINE: Testing at level FINE
- Where the log output appears (e.g. in which file) depends on your logger configuration,
as does the number of levels that appear.
: see e.g. http://reluk.ca/sys/computer/workstation/opt/_/java-logging.properties
+ Ensure the test messages extend down to level `CONFIG` at least.
rebuild script
- If you expect to modify the source code of dependencies (direct or indirect),
then a rebuild script may be useful.
: re `dependencies` see `^*.\+ Ensure the following projects are installed`
: re `rebuild script` e.g. http://reluk.ca/project/Breccia/Web/imager/build-all
Web publication
• Breccian files
: join @ http://reluk.ca/project/Breccia/project_installation.brec
\ Copyright © 2020-2022 Michael Allan. Licence MIT.