Pier bootstrap recipe (version 2)

First we need to load Pier, and since I also want to export my code, I used the following code:
Gofer new 
smalltalkhubUser: 'Pier'
project: 'Pier3Addons';
configurationOf: 'Pier3AddOns';
load.

((Smalltalk at: #ConfigurationOfPier3AddOns) project version: #'development') load: #( 'Pier-Exporter-Code' 'Pier-Bootstrap' ).

This gives us a clean Pier-site, that we can modify for our use. Since we need bootstrap loaded, we first need to register pier, using bootstrap, and of course start the web server:

PRKernel reset.
PRPierFrame registerAsBootstrapApplication: 'volkstuinen' kernel: (PRKernel named: 'pier').
ZnZincServerAdaptor startOn: 8088

Before we start, we first open the site, and click on “change owner”. Change the owner to admin and toggle the recursive button. This will allow us to set the site up properly, using rights and such. When you do so, you will see that the menu with commands becomes a lot shorter, and you will have to login using “pier”, “admin” to be able to proceed.

Our template is quite simple: in our site we have a navbar, a main page and a footer. But before we can change our template, we have to make sure that we can still edit, after changing everything. This is how I would do it, if I needed to do it again.

We start by modifying the template. We add the stuff we are going to need in the beginning. Since the footer will  be sticky, we want some room at the bottom anyways, so this will work fine.
+Navbar+
+MainPage+
+footer+

Now we start by adding the main page, just by clicking on main page. The main page has an alternative look, when we are logged in, because I do not want the pier navigation shown when we are logged out. This is a new component in Pier. I set it up with default (+contents+) and an alternate:
{{{<div class="jumbotron">
<div class="container">}}}
!!!Logged in
{{{</div></div>}}}
+contents+

+Sidebar+

Now remember to select the main page, because otherwise everything will be added to the template. Now login and modify the contents and the sidebar. The contents and sidebar, are the “normal” contents and sidebar, displaying the contents and the navigation (Children (dynamic)). Change the navigation and set the level to 1 and recursive to true. This will give us better navigation.


Next step will be to edit the footer. Select the footer and click edit and fill out the following:

{{{<div id="footer">
<div class="navbar navbar-default navbar-fixed-bottom" role="navigation">
<div class="container-fluid">}}}
+Collapse+
{{{</div></div></div>}}}

And then the collapse looks like this:
{{{<button type="button" class="navbar-toggle" data-toggle=“.fcollapse" data-target=".footer-collapse">
<span class="se-only">Toggle footer</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>}}}
{{{<div class="footer-collapse fcollapse">}}}
+Menu+
+Commands+
{{{</div>}}}

As you can see, there is still quite a lot of bootstrap code in our pier content, but after we have set up our site, we do not need to bother with this any more. The menu is a component, that displays some static Children. I added here the possibility to add some css class. Fill out:
list class = nav navbar-nav navbar-right)
active class = active. 
It needs to point to the node where you add the children you want displayed in your footer. we leave this to default for now.

Now we change our navbar. This looks a lot like our footer.
{{{<div class="navbar navbar-inverse navbar-fixed-top" role="navigation">
<div class=“container">}}}
+Title+
+Collapse+
{{{</div></div>}}}

With the collapse:
{{{<div class="navbar-collapse collapse">}}}
+Menu+
{{{</div>}}}

And the title
{{{<div class=“navbar-header”>
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="se-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>}}}
{{{<a class="navbar-brand" href="/">}}}Your site{{{</a></div>}}}

The menu is the same as in the footer. It is a static children component with the list class set to "nav navbar-nav navbar-right” and the active class set to “active”, and pointing to the place where we have our content.

We can now remove the unneeded things from our template and modify it into:
+Navbar+
+MainPage+
+footer+

Finally, for our pages, we still have the jumbotron to add, so here is some bootstrap code as well:
{{{<div class="jumbotron">
<div class="container">}}}
+Heading+
{{{</div></div>}}}
{{{<div class="container"><div class="row">
<div class="col-md-4">}}}+Page1+{{{</div>
<div class="col-md-4">}}}+Page2+{{{</div>
<div class="col-md-4">}}}+Page3+{{{</div>
</div></div>}}}

Note that for our static children you can only select nodes, that have children. You probably want to create them in a separate place, then add 1 child, and then go back to the menu to point it to the right place.

So this is still quite the manual, so maybe we should make some bootstrap specific components. But then I do not know what components we exactly need, so please let me know if you have ideas for this, or have better ways to do this.

As you can see, there are a few new components and options (static children, css options, altdoc page) we added, but basically this is it. If you have any trouble or suggestions for improvements, let me know.

Cheers,
Diego