main local/partial build setup

[djencks]

This works now although there are some spurious errors from camel-spring-boot branches we don't want.

Once I upgrade the camel-website dependencies (apache/camel-website#727) the errors will be gone.

[djencks]

It now works with the following problem for me. I'd like feedback from others on both linux and macOS whether they have the same problem: it's a bug in Antora AFAICT.

I get an error like this:

[17:36:35.262] ERROR (@djencks/antora-source-watch): EEXIST: file already exists, mkdir '/Users/david/projects/camel/camel-website/documentation/components/next/eips/_attachments/Hohpe_EIP_camel_20150622.zip'
Cause: Error (no stacktrace)

Deleting the source zips "solves" the problem. I haven't been able to make a small example project, but it occurs when I modify the playbook to use my local camel clone (just like source-map does, but hardcoded).

To delete the files,

rm ../core/camel-core-engine/src/main/docs/modules/eips/attachments/Hohpe_EIP_camel_*

in the docs directory where you are running local-build.sh.

[djencks]

For the versions relying on symlinks rather than copying (main, 3.14.x, 3.13.x, and 3.12.x), the file watcher will not detect changes to the original files under components, but at least in Intellij IDEA you can edit the symlinked "copy" under docs/components and the file watcher will detect a change. I don't know how this works :-)

[davsclaus]

That is fine David, we really only work on "main" for new doc content, and for released versions its only smaller backports of bugs etc so often very limited doc changes there.

About the .zip file, then maybe we can drop it - we can instead just put it somewhere else in a git repo and point people there. Its a zip file with the EIP icons in Visio (a digram tool).

[djencks]

The zip error seems to be intermittent now, and it never occurs with the main build using the git repo. If it turns out to be unfixable and a big nuisance we could put the zips in the camel-website static dir, but I'd rather not.

I'd like to merge the changes for the other branches as well, I work on all the branches :-) and having them all work the same way makes it much easier for me.