Show Bootstrap examples inline

[tdoerrich]

Hello!
I've love DevDocs, especially the speed of it! However, there is one thing I feel is lacking. When I use for example the bootstrap documentation the images are quite a big help to find what I'm looking for and in DevDocs I can't see any images. Is there any chance we could see this added?
Thanks!

[j-f1]

It seems like the scraper removes the examples (I’m assuming that that’s what you’re talking about):

devdocs/lib/docs/filters/bootstrap/clean_html_v4.rb

Lines 19 to 33 in 58c44bf

	css('.bd-example', '.responsive-utilities-test').each do |node|
	next unless node.previous_element
	if node.previous_element['class'].try(:include?, 'bd-example')
	node.remove
	else
	node.content = ''
	node.name = 'p'
	node['class'] = 'bd-example'
	node.remove_attribute('data-example-id')
	prev = node.previous_element
	prev = prev.previous_element until prev['id']
	node.inner_html = %(<a href="#{current_url}##{prev['id']}">Open example on getbootstrap.com</a>)
	end
	end

I think this is intentional, because DevDocs doesn’t include Bootstrap’s stylesheet. One way to fix this without messing up the styles of DevDocs itself would be to embed the examples in iframes:

<style>
  iframe {
    border: none;
    width: 100%;
  }
</style>
<iframe srcdoc='
  <link href="https://getbootstrap.com/docs/4.4/dist/css/bootstrap.min.css" rel="stylesheet">
  [example code goes here]
'></iframe>

The only downside to this would be that it would require Internet access for the demos to look correct since the Bootstrap CSS has to be loaded over the network.

If you wanted to submit a PR that either uses my suggested approach or another one that avoids leaking Bootstrap’s styles into the main DevDocs app, I’d probably accept it.

Sorry for the delay in replying!

[mandrasch]

Mh, offline usage would be the main goal, right?

I did a quick research, it seems possible to isolate the boostrap styles to certain div areas:

a) https://formden.com/blog/isolate-bootstrap (tutorial for v3, v4 uses scss instead of less)
b) https://github.com/toert/Isolated-Bootstrap

Thanks for providing devdocs!

[tdoerrich]

Sorry! I've been gone for a long time! Yeah, offline usage would really be the main goal for me if possible. :)

[koraysels]

any prgress on this ?

[koraysels]

there is this repo: https://github.com/libracoder/bootstrap-offline-docs
It runs offline aswell. Maybe helpfull ? I don't know