Website build process

[Xeverous]

This issue is to discuss how the website is build. I'm interested in opinions.

1. Project output

Should the output be a website only? Can we write pages so that they can also be compiled to a different format (e.g. PDF book)? What if pages contain rich media content (e.g. videos or any interactive page element)?

2. custom syntax highlight

I have created a plugin to colorize code in a more detailed semi-automatic way. I'm a bit of a perfectionist when it comes to the content formatting and code display. Is it worth the effort?

Pros:

• It allows much higher control of displayed code snippets:
  • Existing automatic code highlight solutions are not fully correct (e.g. if in 2.0if is colored as a keyword, not as a literal suffix).
  • Finer control allows to post code from C++ proposals with proper highlight.
• It allows extra build steps like verifying code samples by compiling them.

Cons:

• It complicates build process
• It adds some overhead to writing code examples

I'm also thinking of how to make colorized compiler error snippets. If GCC documentation can, we should surely too.

3. other plugins

Ideally I would also like to have some automated diagram generation, that is, writing diagrams as code using specific syntax and having them embedded in pages as image elements.

[Xeverous]

closing as outdated, there is already a mirror and clangd-based highlight