add --html-style option

[MartinNowak]

• allow to pretty-print HTML output (useful for tests and development)
• quite suboptimal due to support runtime diet traits rejectedsoftware/diet-ng#33

[s-ludwig]

I guess the compact setting implicitly became the default when switching to diet-ng. The question is, is this actually the best default? One one hand, compact documentation makes sense, but on the other hand when that is not a priority, the pretty setting is much nicer. What was your use case for adding the setting?

[MartinNowak]

I guess the compact setting implicitly became the default when switching to diet-ng. The question is, is this actually the best default? One one hand, compact documentation makes sense, but on the other hand when that is not a priority, the pretty setting is much nicer. What was your use case for adding the setting?

Diffing the test cases for ddox ;). In particular being able to check-in and diff the generated HTML would be useful. I might just change the default for generate-html, but some ppl. might want to statically serve those files.
We also might resort to some external tool to prettify HTML for the testing.

[wilzbach]

Being able to temporarily switch back to pretty-print output would be really nice to have for dlang/dlang.org#1891 (upgrading dpl-docs to ddox 0.16)

[s-ludwig]

Okay, should be good to go then. There are only a few templates, so that compiling them twice shouldn't matter much in terms of compile time and memory usage.

[wilzbach]

Thanks a lot!
Do you by chance also plan to move this repo to the vibe-d org?
It would be nice if I don't need to bother you for minor things like tagging a new alpha release ;-)

[s-ludwig]

I'll have to think about the satellite projects, but my idea for the vibe-d org was to keep it focused on the core components, basically as a replacement for the monolithic "vibe.d" repository. But in the meantime I sent you an invitation to the DDOX developers team (and tagged 0.16.5 ;).

[wilzbach]

but my idea for the vibe-d org was to keep it focused on the core components, basically as a replacement for the monolithic "vibe.d" repository

Okay, but then at least diet-ng~ and maybe vibed.org` would fit the description ;-)

But in the meantime I sent you an invitation to the DDOX developers team (and tagged 0.16.5 ;).

Thanks a lot! FWIW as we plan to replace Ddoc with Ddox over the next months, we could probably even move it to the dlang namespace if that's something you are interested in.

[s-ludwig]

vibed.org I'd agree, diet-ng I'm not sure yet, because in the process of separating it out, it was also made fully independent of any other vibe.d components and I was thinking about giving it its own brand to broaden the scope (I already registered diet-lang.org for that purpose).

As to moving Ddox to the dlang org, that would make sense, but I'd postpone that to when it is deemed "finished" (i.e. no big changes are planned anymore). The major change that I have in mind is fully switching to the libdparse based parser to avoid all the issues with DMD's JSON output.