Solved

Documentation Software

Posted on 2004-09-11
13
1,048 Views
Last Modified: 2011-10-03
Hello,

I am looking for some really easy to install and use documentation software for the web using PHP. I want to add help docs to an application, but would like to be able to just add simple titles and content and have it indexed automatically for our users. I have checked out Sourceforge and Hotscripts without much luck.

Has anyone had experience with documentation / knowledge base software?

I would ideally prefer links to software you have actually used and recommend, since I have searched around plenty and found nothing that jumps out at me.

Many thanks,

Bodog.
0
Comment
Question by:cracky
[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
  • 4
  • 2
  • 2
  • +4
13 Comments
 
LVL 26

Expert Comment

by:Umesh
ID: 12033865
0
 
LVL 14

Author Comment

by:cracky
ID: 12033908
Thanks uhastry, but I am looking for end user help documentation, not coding documentation. Both phpdoc and PHPDocumentor are used for programmers to parse PHP comments as class / method descriptions etc. The documentation I require is for end users.
0
 
LVL 18

Expert Comment

by:armoghan
ID: 12041530
I think the problem is not related to PHP directly
Why dont you try HTMLhelp from microsoft to create static Help pages
and attach it with Php application
0
What does it mean to be "Always On"?

Is your cloud always on? With an Always On cloud you won't have to worry about downtime for maintenance or software application code updates, ensuring that your bottom line isn't affected.

 
LVL 14

Author Comment

by:cracky
ID: 12041634
armoghan > I think the problem is not related to PHP directly

In fact, it is.

I am looking for a PHP documentation feature / software that I can use to create help docs or a knowledge base with a minimum of effort. I want to be able to add / edit / remove help topics dynamically without having to export a static set of pages. Besides, I have successfully worked the last year without touching a single Microsoft product and I intend to keep it that way. It's like junk food, once you wean yourself off it, you don't even feel like it anymore.
0
 
LVL 18

Expert Comment

by:armoghan
ID: 12041720
you can use a content management system for this purpose
0
 
LVL 48

Assisted Solution

by:hernst42
hernst42 earned 100 total points
ID: 12082531
Have you looked at http://www.hotscripts.com/PHP/Scripts_and_Programs/FAQ_and_Knowledgebase/index.html There are a lot of scripts in PHP listed one might b able to do what you want.
0
 
LVL 9

Accepted Solution

by:
techtonik earned 400 total points
ID: 12083261
If you know how to write in DocBook, you can use PHP documentation build system. =)
In short:
 - your documentation sources are in XML format (DocBook elements and rules);
 - you can validate your document for structure errors;
 - you use templates to convert XML into something readable (i.e. HTML or text);
 - templates are in XSL language;
 - templates can be common DocBook templates or your custom modified DocBook.

Learning curve:
 - learn about XML;
 - learn about DTD (Document Type Definition) - standard for particular XML content;
 - understand validation toolchain: XML + DTD = error log
 - understand transformations toolchain: XML + XSL = HTML or whatever..
 - (optional) understand XSL language.
 - read some tutorial on DocBook to really put it together =)
   http://www.google.com/search?q=docbook+tutorial&sourceid=opera&num=0&ie=utf-8&oe=utf-8
   http://wiki.docbook.org/topic/DocBookTutorials

Drawbacks:
 - DocBook is rather big standard, though it isn't complex.

You can fetch example from PHP CVS:
http://cvs.php.net/livedocs/
Page of interest:
http://wiki.phpdoc.info/LiveDocs
0
 
LVL 14

Author Comment

by:cracky
ID: 12083545
I have read a little about DocBook and forgot about it entirely. Looks like a good solution for a scalable help system. Exactly what I need.

Thanks also to hernst for finding me some scripts I missed.

techtonik, could you possibly show me some examples of DocBook documentation systems with a more graphical representation? Of course, since it uses XSLT, presenting DocBook in a prettier way isn't hard. I couldn't see anyone presenting in anything but the most basic HTML. It would be great if you could point me to some well-presented documentation examples.

Cheers.
0
 
LVL 9

Expert Comment

by:techtonik
ID: 12086125
All PHP documentation is rendered from DocBook sources (with some minor tweaks), but unfortunately with DSSSL (non-XSL) template toolchain. FreeBSD handbook is also an example of DSSSL output http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/.

As for XSL examples - you can look at xCHM edition, which has been made with XSL. http://cvs.php.net/phpdoc/htmlhelp. The reason why DSSSL is used instead of XSL is mostly of historical reasons. XSL tools for a long time were not enough polished to produce usable output, so during this time there were a lot of tweaks made to DSSSL templates. So one have to do a lot with XSL to make output the same. Needless to say, that many just followed "If it ain't broke, don't fix it" principle.

So, there are not too much ready to use examples, because XSL toolchain is rather young, but not because it is very hard to customise DocBook. Starting point here is DocBook XSL stylesheets and basic HTML is a base function of them. After you've generated your first HTML files - you can customise DocBook templates, insert CSS styles and other stuff in output. Good resource about customising is here: (http://www.dpawson.co.uk/docbook/styling/custom.html) and, of course, http://wiki.docbook.org/topic/DocBookXslStylesheets.

Hope you are not dissapointed. =)  XSL is the future of DocBook and is actively developed. The recent version of XSL DocBook templates released just some days ago and is available on http://sourceforge.net/projects/docbook/
0
 
LVL 14

Author Comment

by:cracky
ID: 12089384
Thanks techtonik. Exactly what I wanted.

Cheers.
0
 
LVL 8

Expert Comment

by:AJAY CHADHA
ID: 24727358
Have you had a look at PHPKB knowledgebase software from http://www.knowledgebase-script.com
0
 

Expert Comment

by:Adwait Chitaley
ID: 24727375
Hello,

We use mediawiki for our documentation. We have installed mediawiki with FCKEditor extension for easier input (WYSIWYG) and used the Page Names to link up the Help Page with the context form.

Through this, we get a good Collaborative Document Maintenance Platform and also, a linked Help Documentation.
0
 
LVL 8

Expert Comment

by:AJAY CHADHA
ID: 24733534
PHPKB uses InnovaEditor which makes the WYSIWYG editing compatible on all browsers such as Google Chrome, Safari, Internet Explorer, Firefox etc. plus it is backed by 12 months of free private technical support.
0

Featured Post

WordPress Tutorial 1: Installation & Setup

WordPress is a very popular option for running your web site and can be used to get your content online quickly for the world to see. This guide will walk you through installing the WordPress server software and the initial setup process.

Question has a verified solution.

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

Author Note: Since this E-E article was originally written, years ago, formal testing has come into common use in the world of PHP.  PHPUnit (http://en.wikipedia.org/wiki/PHPUnit) and similar technologies have enjoyed wide adoption, making it possib…
Many old projects have bad code, but the budget doesn't exist to rewrite the codebase. You can update this code to be safer by introducing contemporary input validation, sanitation, and safer database queries.
Learn how to match and substitute tagged data using PHP regular expressions. Demonstrated on Windows 7, but also applies to other operating systems. Demonstrated technique applies to PHP (all versions) and Firefox, but very similar techniques will w…
The viewer will learn how to count occurrences of each item in an array.

630 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