Solved

HTML authoring software for creating a FAQ

Posted on 2004-03-29
7
241 Views
Last Modified: 2013-12-25
I am looking for an application to help author a FAQ compilation (HTML).

Requrements:
- Should take care of section/subsection/question numbering.
- Should create a "table of contents" based on the numbering.
- Should allow easy internal (between questions) and external linking.
- Should allow creating the FAQ as a single HTML page or as several sections.
-
- The end result should look good on all reasonably modern browsers.

Basically, I need an HTML authoring package that has very good support for nested numbering levels.

For this task, I will have access to Frontpage 2000, NetObjects Fusion 7 and Visual Studio.NET 2003.
If one of these packages fits the bill, great.

Otherwise, please suggest another option.
Freeware is preferred, low-cost shareware comes next followed by expensive shareware -- I like the "try before you buy" concept.

Thanks.
0
Comment
Question by:alexo
[X]
Welcome to Experts Exchange

Add your voice to the tech community where 5M+ people just like you are talking about what matters.

  • Help others & share knowledge
  • Earn cash & points
  • Learn & ask questions
  • 3
  • 3
7 Comments
 
LVL 10

Accepted Solution

by:
KenAdney earned 300 total points
ID: 10785007
To keep it as simple as can be, if the whole FAQ is going to be a single page, why not just use Word and Save As HTML?  The numbering section/subsection will be a piece of cake, it can automatically build the table of contents and hyperlink the table of contents to the questions.  True, the end resulting code is needlessly complex but you can use the free MS Office HTML filter to simplify the code.

I'm sure a better solution is to use a database driven system, but Word would be mighty easy.
0
 
LVL 11

Author Comment

by:alexo
ID: 10785860
> if the whole FAQ is going to be a single page
It has already become too large for a single page so I'd like to split it.

> you can use the free MS Office HTML filter to simplify the code.
Interesting idea, I'll look into it.

I prefer something that can handle single and multiple pages.
0
 
LVL 15

Expert Comment

by:ericpete
ID: 10907820
"... too large for a single page so I'd like to split it...."

Word can handle that. Ordinarily, I'd shudder at the idea of using Word to create an HTML page, but Ken's right -- you can always clean it up later using either the filter or a simple text editor.

But look at EE's help page... it has a bunch of sections, all internally linked, and it started out as a bunch of separate pages. That's the nice thing about HTML pages -- if your TOC is good, then you don't really need to worry about how long the page is.

ep
0
Salesforce Has Never Been Easier

Improve and reinforce salesforce training & adoption using WalkMe's digital adoption platform. Start saving on costly employee training by creating fast intuitive Walk-Thrus for Salesforce. Claim your Free Account Now

 
LVL 11

Author Comment

by:alexo
ID: 10907879
> That's the nice thing about HTML pages -- if your TOC is good, then you don't really need to worry about how long the page is.

I disagree.  I find it easier to peruse such documents if they are split into more manageble pieces.

Take http://www.parashift.com/c++-faq-lite as an example. It is a very large FAQ but navigation is pretty easy.  Incidently, I emailed the author and he told me he uses a custom-tailored perl script to manage the FAQ which has borderline usability and is overdue for an update...
0
 
LVL 15

Expert Comment

by:ericpete
ID: 10907920
Okay, then we'll agree to disagree.

I find having to go back and forth between multiple documents an annoyance. But it's really pretty much an academic question; either way, Ken's suggestion of using Word will work. You'll just have to clean up the HTML after you create it.

ep
0
 
LVL 11

Author Comment

by:alexo
ID: 10907960
> Ken's suggestion of using Word will work. You'll just have to clean up the HTML after you create it.

Not an optiman solution but if I don't get any better answers soon I'll accept it.

By the way, why are your comments marked as "administrative"?
0
 
LVL 15

Expert Comment

by:ericpete
ID: 10908023
Because I wasn't paying attention... *wince*... PE privileges used for testing and I forget that I have them.
0

Featured Post

Resolve Critical IT Incidents Fast

If your data, services or processes become compromised, your organization can suffer damage in just minutes and how fast you communicate during a major IT incident is everything. Learn how to immediately identify incidents & best practices to resolve them quickly and effectively.

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

"In order to have an organized way for empathy mapping, we rely on a psychological model and trying to model it in a simple way, so we will split the board to three section for each persona and a scenario and try to see what those personas would Do,…
Get to know the ins and outs of building a web-based ERP system for your enterprise. Development timeline, technology, and costs outlined.
Viewers will get an overview of the benefits and risks of using Bitcoin to accept payments. What Bitcoin is: Legality: Risks: Benefits: Which businesses are best suited?: Other things you should know: How to get started:
This tutorial walks through the best practices in adding a local business to Google Maps including how to properly search for duplicates, marker placement, and inputing business details. Login to your Google Account, then search for "Google Mapmaker…

696 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question