research how we can use embedded godbolt support for beman website

[mguludag]

Issue: #55

PR to how to embed godbolt links into pages, the newly added page content, path may change.

Usage of Godbolt embedding:

```cpp { "compilers": ["compiler compiler_flags",...], "libs": ["lib@version",...], "filters": {"execute":true} }
// some cpp code

then build process of website automatically creates godbolt link on top of code block like this:

[netlify]

✅ Deploy Preview for bemanproject ready!

Name	Link
🔨 Latest commit	72b3e8d
🔍 Latest deploy log	https://app.netlify.com/projects/bemanproject/deploys/68c54375a777f800085684b4
😎 Deploy Preview	https://deploy-preview-56--bemanproject.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[JeffGarland]

So @mguludag I think I see what you're trying to do here -- but I don't see that optional page in the preview site. Is that because it's not linked from anywhere?

[mguludag]

So @mguludag I think I see what you're trying to do here -- but I don't see that optional page in the preview site. Is that because it's not linked from anywhere?

It's under Docs > Beman Libraries (experimental page copy of the Libraries page) > beman.optional:
https://deploy-preview-56--bemanproject.netlify.app/docs/libs/beman.optional/

[JeffGarland]

So @mguludag I think I see what you're trying to do here -- but I don't see that optional page in the preview site. Is that because it's not linked from anywhere?

It's under Docs > Beman Libraries (experimental page copy of the Libraries page) > beman.optional: https://deploy-preview-56--bemanproject.netlify.app/docs/libs/beman.optional/

oh cool. That looks like a resonable start. Have a look at cppreference though to see what they're doing (recently I noted they starting using godbolt). For example:

https://www.cppreference.com/w/cpp/utility/basic_stacktrace.html

The nice thing about theirs is you don't get the godbolt terms of service in your face. The downside I can see here is that the 'link to edit on godbolt' is less clear.

Side note -- I like how docusarus is generating a right side quick link for the .md. That's a good omen for when we start generating library docs.

[neatudarius]

LGTM for POC phase. Looks like a good lead.

[mguludag]

So @mguludag I think I see what you're trying to do here -- but I don't see that optional page in the preview site. Is that because it's not linked from anywhere?

It's under Docs > Beman Libraries (experimental page copy of the Libraries page) > beman.optional: https://deploy-preview-56--bemanproject.netlify.app/docs/libs/beman.optional/

oh cool. That looks like a resonable start. Have a look at cppreference though to see what they're doing (recently I noted they starting using godbolt). For example:

https://www.cppreference.com/w/cpp/utility/basic_stacktrace.html

The nice thing about theirs is you don't get the godbolt terms of service in your face. The downside I can see here is that the 'link to edit on godbolt' is less clear.

Side note -- I like how docusarus is generating a right side quick link for the .md. That's a good omen for when we start generating library docs.

I found an example for hugo that using Compiler Explorer API also nice idea to generate godbolt links from the code snippet in the md page.

[mguludag]

Hi @JeffGarland I think this feature is finalized from my side and now we have flexible options for embedding godbolt links/generating godbolt links from the markdown codeblock. I also checked the markdown rendering on github and there is no problem (link generation only works for website).

[JeffGarland]

Ok, thanks for all the effort on this. I wonder what to do next -- put this into some sort of guidance?

[mguludag]

Yes, I need to update the README.md to how to embed the code or godbolt links in the pages.