DrunkenMonk did a nice job answer the questions, I'll take another
stab, as sometimes hearing it more than one way can help.

On Sun, Jul 26, 2009 at 1:24 PM, Vivek Sharma<[email protected]> wrote:
>
> Hi all,
>
> Can  someone please explain with some examples. As, Boltwire
> Documentation is nice, but in my opinion its approach is hackish.
> Which means for people like me it adds more confusion. I think to use
> it you need to know how CMSes internally work form code-flow point-of-
> view. Plus i think need to know PHP very good. I am a systems
> programmer (c/c++) thats all :).

I don't know about hackish, but BoltWire is very open and flexible.
Meaning you can do about anything you want to once you learn how. The
problem with your question seems to be terminology, or perhaps that
you are just missing some basic concept somewhere. If you are coming
from other software that used different terminology or concepts, it
will just take some adjustment. As for having to know code flow or
php, you should have to know it at all for 99% of the stuff you want
to do.  But we'll see...

> Boltwire is getting so perplexing to me that, i am not able to get a
> simple setup, for my various networking, security, kernel, stack, CDN
> projects.

I'm really sorry it's been a challenge. I've been traveling a lot.
Just got back from another 4 day trip to Washington, and haven't kept
up with development. If you will give us a chance and we can help you
get started, I think you will end up liking BoltWire. It really is
quite flexible...

> Main/Super Questoin ----
> I wish to set up a wiki, with categories/hierarchy/folder(i dont know
> what concept will fit here) for each of the above projects, then i
> keep adding pages to them, and those pages are automatically added to
> TOC, with proper indentation, and if possible TOC is collapse/expand -
> able.

To create pages just click the create link and then give it a page
name based on where in the hierarchy you want it to be. For simple
example, let's say you had a pet store. You could create pages like:

dogs
dogs.chow
cats
cats.siamese
fish
fish.minnows
birds
birds.parakeet

That's eight pages. With four of them parent pages, and four of them
child pages. You could of course have grandkid pages like
dogs.chow.red and dogs.chow.black, and on down as many levels as you
need.

To show all the pages in the dogs group, you go

[(search group=dogs* template=toc)]

The * means not only all the kids, but all the grandkids too... The
toc means indent based on how many parts there are to the page name. I
should note, you will need to make sure all the parent pages exist to
get a proper display.

To get the expanding/collapsing menu bar you will need a small plugin.
Possibly worth adding to the core. But currently it's available here:

http://www.boltwire.com/index.php?p=solutions.search.toc

Download it to your farm/plugins folder. Go to site.plugins and enable
it. That's all you need to do to turn it on. Now, let's put it in your
sidebar. Go to page "side" and click edit. That put this content in
the sidebar:

[(search group={toc} include=dogs,cats,fish,birds template=toc)]

The {toc} markup is generated by the plugin to produce
dogs,dogs.chow,dogs.chow.black when you are on page dogs.chow.black
and thus opens up your whole tree where you are. The include parameter
gives you all the top level hierarchies. You should be able to click
around all over your four hierarchies and everything open and close as
needed.

If you want help generating actions that automatically put pages in
certain locations, that's easy enough to customize, but I usually just
type the page name I want and put it there directly.

> --trivia -- it will be awesome if i am able to put these projects in
> horizontal link on the top of page, like most of those lovely boltwire-
> skins they do, and each click on that link open the project, with a
> specific TOC in side. Well i shall not be so greedy especially when i
> cant do it myself, or donot know how to do it. anyways as they say
> baby-steps

Yes, this is very easy, depending on the skin of course. Usually there
is a top zone where these horizontal links go. Go to page "top" and
type something like this:

[[dogs]] | [[cats]] | [[fish]] | [[birds]]

That should give you links to your main sections. (Remember, some
skins organize the zones differently. Go to action.zones for help).
Then in your side bar you might put:

[(search group={toc} template=toc)]

as you won't really need the top level links there as well. But like
mostly things in BoltWire you can customize this anyway you want.

You can also have customized sidebars for each section of your site.
Just create pages like dogs.side and cats.side, etc. These will
override the normal side page when you are in those hierarchies. You
could also have a dogs.chow.side page as well. Which would be used in
that hierarchy. But it's easier usually to have one smart sidebar.

> In detail questions ---
> 1. Can anyone explain what is the use of folders in boltwire.
> -- Site Administration > Folders
>
> It says " Use this page to store certain pages in specific sub-
> folders. " Is it a way of organizing the pages.

Yes, but normally this is not needed. Normally all pages just go right
in the pages folder. But suppose you have a site with a large forum
and for various reasons you would rather separate out all your forum*
pages. Just go to site.folders and type forum*: forum. If you already
have some forum pages, you will then need to manually create a
pages/forum subfolder and manually move all your existing forum pages.
But all future forum pages created will get stored away. It helps to
keep your main pages folder less cluttered. It also helps because you
can do searching and limit your search to the forum sub folder,
boosting performance. There are other potential benefits as well, but
for most small sites though, the indexing is plenty fast, and the use
of sub folders is not necessary.

> 2. How to make a page hierarchy. I followed i think now all the
> documentation, still i am not able to figure out, or get any relevant
> information how to create a page in some hierarchy.
> For example
> I have a page called Project
> in project i have reset
> in reset i have high level design.
>
> so i have
>
> Project
> -- reset
> -- -- High Level design.

Just create a page called project.reset.high_level_design.

The dots are kind of like folders. Pages within pages. Like branches
in a tree. Whatever. Just use the create action, and type your name.
It's that easy.

> now i have made this by going to > site administration > zones, and
> manually doing it there. Ofcourse this is not the right way to do it.
> From what i got from the docs, i tired projects.reset.lowLevelDesign,
> i stupidly thought it might add the page in right place and update TOC
> in side. but i was wrong.

I have no idea what you mean by site.zones. That page doesn't exist.
If you created the pages projects.reset.lowLevelDesign outside of
BoltWire it won't work because all pages names must be lower case.
This is how you get case insensitivity within BoltWire. If you type in
[[PROJECTS.RESET.LOWLEVELDESIGN]] then BoltWire automatically converts
to lower case to find a match. If you created it within BoltWire it
should have showed up in your menu assuming you had

[(search group=projects* template=tocs)]

Note again the * for without it, it only looks for child pages in
projects, no grandkids.

> 2a --> how to make a top page, then a sub-page, then a sub-sub-page,
> then a sub-sub-sub-page. and how to get the toc generated for it
> automatically.

I think these questions are answered above

> 2b --> how to have fold-able menu, by which i mean, i shall be able to
> collapse/expand TOC for top-page/sub-page/sub-sub-page ... and so on.

You have to use the TOC plugin mentioned above for this

> 2c --> how to have fold-able menu for all various the top-level-pages
> in SIDE-ZONE, and only the present top-level-page menu in MAIN-ZONE.

Not sure what you mean here. But maybe from what I wrote above you can
figure it out...

> 2d --> If i like to display it in the right side of the page, with my
> text wrapping the TOC in the main-zone i think i will have to do
> changes only in CSS for it.

This all depends on the skin you have. Perhaps once you get it all
working you can ask some more specific skin related questions.

> 3 -- how to display breadcrumbs.

Put [(breadcrumb)] on a page. Usually this is done in the header zone.
I usually put in page "header" the following

! {title}
[(breadcrumb)]

With two line returns at the end.

> 4 -- TOC is a template. any only says
> [(toc {+p})][[{+p}|{+title}]]
> does it mean i have manually paste this in all the pages. I did try
> that only it showed  {+title}?

No, there is a template.toc in the default distribution. You just have
to tell BoltWire which template to use when doing a search function,
so it knows how to display the output. ie

[(search group=whatever template=toc)]

> I think its a good idea to invite you all, to check what mistakes/
> blunders i did here. Do what-ever you wish to the site. i have a
> backup, i can always upload it.
>
> http://wiki.vks.uni.cc
> username - admin
> password - admin

Ha, just took a quick look at your site. Looks like you have got it
working. Probably didn't need to write all this!!!  Oh well, maybe
this will help.

> thanks a lot, if some is able to find time to help me out.
> vks

Sure, no problem.  Good luck!

Cheers,
Dan

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"BoltWire" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/boltwire?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to