1. In page editor, move all topics to the root folder of your web. The page editor will reconcile links and references.
Note. There is no need to organize topics in folders at editor/web level, since this task is taken over by KSW completely.
2. Check your site in browser, everything should work as normal. If not, make adjustments. After everything works, make a copy of the home page in a private folder. You may need it when removing the KB structures.
3. KSW will ask for a default topic when you'll create the project. Which topic is your default? It could be your current home page, or another topic, but it must be different from the new default page of the site you create next.
4. Create the new default page of the site (we call it the default/front page, this is not the default topic), and configure it. See Default/Front Page. Set as default page of the site.
5. Close editor, open KSW.
6. Make new KSW project, point to the new site location on disk.
7. Enter the required project info and proceed. KSW scans and parses files in the local/working web, sets up databases of the project, and loads the project.
8. Open project. Here you'll find many tabs you can explore; they're all self-explanatory.
9. Stay in 'TOC Builder' first:
• You'll find all your topics in a list called
'Available Topics'. But besides the files you intend to use as topics, 'Available
Topics' may also contain non-topic pages. Just select the non-topics and exclude
(right-click) them all in one shot. KSW keeps track of exclusions. From now on, unless you
change their status, these files will stay excluded.
Note. There may also be non-page files in the web's root, like images, binaries, etc., but KSW most likely has excluded those all automatically.
• Located on the left is a panel called 'TOC
Folders', a place where folders are shown in a hierarchy; it contains only the root for
now, selected. You only use this panel to locate and select folders.
• The middle panel contains the expanded folder
that is selected in 'TOC Folders'. Here you can...
• create new folders (right-click), or
• add topics (drag from 'Available Topics').
• Now categorize the available topics in
folders. You may drag the same topic from the Available Topics' list to multiple
folders.
10. Go to the 'Index Builder' tab. All topics you categorized have already been inserted in the Index. You may use the Index as an alphabetic list of all topics. These new topics also appear in the 'Available for Terms' list, because they are new and susceptible for being used for terms.
11. To create a new term in the Index, drag a topic from 'Available for Terms' to the Index list on the left.
12. Do as much as you feel it's enough, leave the rest undone. Save the project.
13. Open the editor and publish. Check site on web; first you'll see the welcome page; then the frameset; check functionality, it should work.
14. Next time you open the project, you'll see topics you left uncategorized, again in 'Available Topics', together with any new topics. You may ask, what if I need a topic already categorized, to place it in additional folders? For that, you don't need 'Available Topics' anymore. Just go to the 'TOC Explorer' tab. Between the two middle panels there you can copy, move, and do all operations common to file management. So you can use an existing topic and copy to any number of other folders.
15. Now say the time comes when you need to remove
the KB structures. You want your site to behave like before adding them. Here is what you
need to do:
• Delete the ksw folder under the root of the web.
• Delete the default/front page you created for KSW.
• If the original home page was removed, copy it back from where you saved it (see step 2
above). Set it again as default page.
We're done. Try your site in browser.
That's about it, enough to get us started. Always, remember the Context Help expandable bar everywhere; it may give you the quick answer you need, so you won't have to open the help file.