I Posted My WrapBootstrap Ace Renderkit

Sep 30, 2014, 7:49 PM

Tags: bootstrap

Since I realized there was no reason not to and it could be potentially useful to others, I tossed the renderkit I use for the WrapBootstrap Ace theme up on GitHub:

https://github.com/jesse-gallagher/Miscellany

As implied by the fact that it's not even a top-level project in my own GitHub profile, there are caveats:

  • The theme itself is not actually included. That's licensed stuff and you'd have to buy it yourself if you want to use it. Fortunately, it's dirt cheap for normal use.
  • It's just a pair of Eclipse projects, the plugin and a feature. To use it, you'll have to import them into Eclipse (or Designer, probably) with an appropriate plugin development environment, copy in the files from the Ace theme to the right place, export the feature project, and add it to Designer and Domino, presumably through update sites
  • Since it's not currently actually extending Bootstrap4XPages (though I did "borrow" a ton of the code, where attributed), it may not cover all of the same components that that project does.
  • I make no guarantees about maintaining this forked version, since the "real" one with the assets included is in a private repository.
  • I haven't added the theme to the xsp.properties editor via the handy new ability IBM added to the ExtLib yet. You'll have to name it manually, as "wrapbootstrap-ace-1.3" with "-skin1", "-skin2", and "-skin3" suffix variants.

Still, I figured it may be worthwhile both as a plugin directly and as an educational endeavor. I believe I cover a couple bases that Bootstrap4XPages doesn't and, since I'm writing for a predefined theme with a specific set of plugins and for my own needs, I was able to make more assumptions about how things should work. Some of those are a bit counter-intuitive (for example, a "bare word" image property on the layout linksbar (like image="dashboard") actually causes the theme to render a Font Awesome icon with that name), but mostly things should work like you'd expect. The theme contains no controls of its own.

So... have fun with it!

Commenter Photo

palmi - Oct 1, 2014, 10:14 AM

This is great , i have bought this theme and was going to enable it in nsf soon,  am using 3.0 is that going to be a issue ?

thanks for shearing

Commenter Photo

Jesse Gallagher - Oct 1, 2014, 10:32 AM

As in Bootstrap 3.0, as opposed to 3.2? The version I posted is targeted at Ace 1.3 specifically (I imagine 1.3.1 would likely work, but I haven't upgraded), and that uses Bootstrap 3.2.something. For normal use, in any event, using this theme generally papers over the difference - your app's code shouldn't be Bootstrap/jQuery-specific except when the renderers don't cover it yet. My blog's code is a reasonable example of how to use it: https://github.com/jesse-gallagher/frostillic.us-Blog

New Comment