Donna
Staff
/ Moderator
Jun 5, 2006, 10:36 AM
Post #3 of 5
(10389 views)
Shortcut
|
|
Re: [dagnome] Have you considered better installation documentation?
[In reply to]
|
Can't Post
|
|
Hi there!
The problem is, many servers do not have or require a cgi-bin directory. The instructions are a little vague, because there are many, many different server setups that might require different steps. We try to write the installation instructions to apply to as many different server setups as possible. There is a mention that you may need to put the scripts into the cgi-bin directory if necessary -- but not all (in fact, increasingly few) servers actually require this anymore.
We also offer a free installation so that if you're having any trouble, we're happy to pop in there and install it for you. :)
However, I will pass along your concerns, and hopefully we can clarify any instructions that could be confusing to new users.
We also have instructions already for how to setup the "tabs" in DocBuilder, like what we have for the Article Manager documentation! It's considered an advanced tutorial, but here's how you can do it:
1. First we created 3 directories; /user/, /admin/, and /install/
2. Next we created 3 HTML files, each file has the same name, tabs.html. This was the file that the images of the tabs were stored in. There are 3 different variations of the image. One with the "user" button highlighted and the other two buttons not highlighted, one with the "admin" button highlighted and the other two not, and one with the "install" button highlighted and the other two not. Each of the tabs.html files has one of these 3 variations. (Each button, of course, links to the published content of it's document group. e.g. the admin button will have a link to the index.html file in the /admin/
directory.)
3. We then uploaded the "user" highlighted tabs.html file into the /user/ directory, the "admin" tabs.html into the /admin/ directory, and the "install" tabs.html into the /install/ directory.
4. We then added a Server Side Include call to the /templates/doc_menu.html file that calls the tabs.html file. <!--#include file="tabs.html" -->
So change this:
<table border=0 cellpadding=0 cellspacing=0 width=100% height=100%> <tr>
<td valign="top" width=100%>
<table width=100% border=0 cellpadding=2 cellspacing=0>
<tr><td rowspan=99><img src="$imageurl$spacer.gif" width=5>
To this:
<table border=0 cellpadding=0 cellspacing=0 width=100% height=100%> <tr>
<td valign="top" width=100%>
<!--#include file="tabs.html" -->
<table width=100% border=0 cellpadding=2 cellspacing=0>
<tr><td rowspan=99><img src="$imageurl$spacer.gif" width=5>
This means that each document groups menu file will include the tabs.html file within its respective directory (e.g. the "Admin" document group will include the admin tabs.html file within the /admin/ directory.
And that's it.
If you have any other questions or comments please feel free to let me know. :)
Donna
--
support@interactivetools.com
|
Re: [dagnome] Have you considered better installation documentation?
[
