Switching custom "conf" files per application start-up

[masa300V]

Hi!

I use multiple "conf" file sets so to customize HTML/PDF output format per my projects.
(for example, multiple "conf/docbook-config/fo-pdf.xsl" for the FOP)

Right now, I use a start-up script manually move right configuration files (one by one in the script) before invoking asciidocfx application.
(Mainly because FOP configuration files are loaded at asciidocfx start-up only once, no dynamic loading after that.)

Q: Is there any smarter way doing this, like an asciidocfx command line option or java option?

best regards,
Masashi

[Rafael-Bessa]

Hi @masa300V,

Currently, AsciidocFX does not provide a built-in command-line option to switch configuration files dynamically at start-up. The FOP configuration files are indeed loaded only once when the application starts, so your current approach of moving the correct files before launching is valid.

Some alternatives you could consider:

1 - Script automation: Enhance your start-up script to select the correct configuration set based on an environment variable or project parameter, so you don’t need to manually edit the script each time.

2 - Custom wrapper: Create a small Java or shell wrapper that copies the needed configuration files and then starts AsciidocFX automatically.

3 - Separate installations: Maintain separate copies of AsciidocFX per project, each with its own configuration set, if the projects are largely independent.

These approaches help automate the process without requiring changes to AsciidocFX itself.

If this helps solve your problem, I’d appreciate it if you could mark it as the accepted answer.

[masa300V]

Hi @Rafael-Bessa,

Thanks.
For your option-1, does asciidocfx read any environment variables to decide its config file locations?

---

Per your reply, now, I'm confident that I can invoke multiple asciidocfx instances by using my different "conf file" sets as it reads only one time at its start up...my changing "conf files" won't affect already running instance(s) :-)

best regards,
masashi

[rahmanusta]

Do you guys want the configu

Hi!

I use multiple "conf" file sets so to customize HTML/PDF output format per my projects. (for example, multiple "conf/docbook-config/fo-pdf.xsl" for the FOP)

Right now, I use a start-up script manually move right configuration files (one by one in the script) before invoking asciidocfx application. (Mainly because FOP configuration files are loaded at asciidocfx start-up only once, no dynamic loading after that.)

Q: Is there any smarter way doing this, like an asciidocfx command line option or java option?

best regards, Masashi

Do you use fop for HTML output ? If I'm not mistaken we use fop only for docbook or pdfs

Do you prefer fop configuration directory selectable on AsciidocFX UI ? or environment variables ?