What is a Kumera?
A kumera is a yellow sweet potato, you can read more about it at The Natural Food Hub.
Why do I still need to enter HTML in the <textarea> edit box, can't you just give me a nice GUI tool?
This comes down to two issues:
- There are ActiveX GUI tools to do this, and a few Java ones, but nothing that I have found usable, generic and free.
- I have a philosophical issue with covering up too much of the internals of the system. If the GUI tool doesn't do what you want, well, you're stuck. So by exposing the HTML, although you don't need to know much, you're empowered to do a lot more with the system.
Will it run at my ISP, or Web Hosting site?
Probably not. Because of the requirement of the installation procedure with the extra perl modules, and directory permissions and ownership it may be difficult to actually install the whole system. It's designed more to be run on your own server (in your home or office), which then uploads the static HTML files to your hosting provider.
Does it run under WindowsNT/2000/XP?
Yes, it should. The current support of perl under these platforms is quite good now. Reports of users running Apache and Win95 have come in to indicate it can be done.
Can it be used to edit multiple directories?
Yes, it can. This was one of the main design goals. XML templates can be different for different sub-directories. Only order, title, abstract, url and body elements need to be present. If you add more, Kumera automatically makes fields for you to enter text into them.
I'm getting weird things happening with uploading the index.html file?
If you're finding that the index.html gets uploaded with more entries than have been created, it may be because there are multiple users with editor permission for that section. This is a bad thing, there should be only one editor per section.
What version of Perl does it run under?
Pretty much the latest versions. It currently it runs under perl 5.8.7. and will run under the older versions as well.
What extra Perl modules do I need?
There are a few extra Perl modules you'll need in order to run Kumera,
See the install document about how to get these.
Hey, not all the buttons at the bottom of the pages are just text, not links?
This can be because of two things. Either the permissions on the directories and files are not correct and Kumera can't write/create to them, so you need to make sure you went through the part of the installation dealing with the chown, chmod and chgrp commands.
Or that you aren't in a part of the process that doesn't allow something to happen. If you're in the edit a file page, in terms of workflow you can only go back to browsing or logout. There's no sense in creating a new file, editing, deleteing, commiting or uploading from the editing page.
I already have my own content in XML, can I use this?
Maybe. The XML DTD for Kumera is fairly simple, and
at the moment is fairly fixed in it's design. It uses XML for it's
own storage of documents. It is not an XML editor. Kumera is not
designed to be that complex.
You can however use XSL to transform it into the Kumera's DTD. As the XML perl code is non-validating, no actual DTDs have been built. See the TODO document.