Hi Andreas, sorry to hear you have these problems. See below.
Andreas Schaefer wrote:
I tried for a few weeks to make XWiki work for me and
even though it
worked out well in the beginning I will not go into production with
it. These are the issues I had to deal with it:
1) Renaming Pages and Spaces leave the wiki somewhat in limbo because
the references are not working anymore. Copying around the pages seems
to do the trick but I leaves a lingering bad feeling.
For Example I can rename the Web Home of a Space but then the Space
because empty (? at the end). I cannot rename the WebHome because the
new Space already has that Document and then I need to manually copy
each document one by one.
http://code.xwiki.org/xwiki/bin/view/Snippets/RenameSpaceSnippet
(linked from
http://platform.xwiki.org/xwiki/bin/view/Features/Spaces)
I guess a problem is that it is not clear enough that spaces are not
real, there is no "Space" entity. A space is just a common prefix for
documents. As long as there are documents with a given space, that space
exists. A special case is the WebHome document, which is considered to
be the homepage of the space. So renaming the WebHome of a space causes
the space to still exist, but it's index does not exist anymore.
2) Upgrade to a new minor release is a nightmare. Even
though the WAR
file can be easily replaced and seems to work fine the upgrading of
documents is a blind flight because there is no list that tells me
what should be imported and not.
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HUpgrading…
It is generally a good idea not to modify default documents, except
Main.WebHome. This way, upgrading the XAR is as simple as uploading it,
unselecting 4 documents (Main.WebHome, XWiki.XWikiPreferences,
XWiki.XWikiAllGroup and XWiki.AdminGroup), and importing the rest of the
documents.
XWiki should now which documents where edited and so
should be able
to give a hint if they were changes before importing them. I would
also like a way to create a diff of the existing file and the one I
like to import.
Yes, this is a planned improvement, but since upgrades are not such a
frequent operation, other issues have been given priority.
3) I cannot make XWiki work on JBoss without messing
around with
Classloader settings. This is a no-go because I cannot afford to make
existing applications fail.
Well, since XWiki works fine with Tomcat and Jetty, without any
classpath changes, then I'd say the fault is also partially on the JBoss
side. Still, we're willing to solve as much as we can on our side. Can
you please create bug reports on
jira.xwiki.org ?
4) I cannot build the current XWiki code (from SVN)
because the
XWikiDocument in the Core is messed up. I also have no idea how I can
get the code of an existing release (no docu). This means I cannot
figure out if I try to fix the classloading. This is the compiler error:
Did you try updating the code? The build works fine for all the
developers, and it also works on our automatic build server
(
http://hudson.xwiki.org/job/xwiki-platform-core/ shows one failed build
during the last 10 builds). If you're trying to build just a snapshot
module from old sources, the newer versions of the dependencies are
downloaded from the web, coming with a changed API.
/Users/schaefa/Development/xwiki/trunks/core/xwiki-core/src/main/java/
com/xpn/xwiki/doc/XWikiDocument.java:[3273,15] cannot find symbol
symbol : method
getRenderedContent(java.lang.String,com.xpn.xwiki.XWikiContext)
location: class com.xpn.xwiki.doc.XWikiDocument
UPDATE: as of tonight I fail now building the WYSIWYG component (Mac
OS X 10.5.7, JDK 1.6, Maven 2.0.10):
I also get this error sometimes, but only when building it from inside
the trunks folder, and only with Maven 2.1.0. Try building directly from
the web/wysiwyg folder.
Removing units with errors
[ERROR] Errors in 'file:/Users/schaefa/Development/xwiki/trunks/
web/wysiwyg/src/main/java/com/xpn/xwiki/wysiwyg/client/util/
Attachment.java'
4b) In the same direction I was not able to check out the source of my
current released version.
Since XWiki is not just one project, but a stack consisting of a core
platform, plugins, applications and a final product on top of it, the
sources are distributed in several modules. I think
http://dev.xwiki.org/xwiki/bin/view/Community/SourceRepository explains
it pretty well.
The sources for released versions of the platform are at
http://svn.xwiki.org/svnroot/xwiki/platform/core/tags/ , just select
which one you want and "svn checkout" it. If you want the sources for
just one module, we also have source jars generated during releases, for
example:
http://maven.xwiki.org/releases/com/xpn/xwiki/platform/xwiki-core/1.8.4/xwi…
http://maven.xwiki.org/releases/org/xwiki/platform/xwiki-core-rendering-api…
5) Handling of images is cumbersome. If I have a lot
of images to be
added to a page like a walkthrough then uploading the images is a
hercules task. I would expect that I could add x number of files or
mark a number of file before hitting upload or delete. This works in
the JSPWiki. I also saw that with JIRA I can add an image directly
from the clipboard into the web page. I am not a Web Expert and so I
don't know how difficult that is.
Since 1.9M2 it is possible to upload more files in a request, using the
attachment upload form in view mode. Using the WYSIWYG editors it is
also possible to upload files directly when editing the document.
6) I tried to keep the images in one document and
reference them in
the pages containing the text. But I can only use get the reference in
the WYSIWYG editor when the images are in the same page. I expect that
I can at least list all the image names from the entire space or from
another document. Sometimes I need to reuse the images or I want to
reuse the page without having to reupload all the images.
Did you read the documentation for the image macro?
http://code.xwiki.org/xwiki/bin/view/Macros/ImageMacro lists the
"document" parameter, which indicates the source document, so:
{image:file.png|document=Main.Pictures} should insert the "file.png"
image from the "Main.Pictures" document.
The new WYSIWYG editor, available for documents in the xwiki/2.0 syntax,
which will be the default syntax starting with 1.9, also allows
selecting images from other documents. Indeed, the old WYSIWYG editor
did not have this functionality.
7) The Trail is broken in my installation bringing up
an error page
even though the page is available. This is because I copied some pages
around and the trail is now pointing to the old defunct space.
The rename function does not update the parent field yet
(
http://jira.xwiki.org/jira/browse/XWIKI-1082 ), so this is a known bug.
Still, why do you rename things so often? Renaming should only happen
once in a while, when you just realized that a page is wrongly named.
Few people complained about Rename problems so far, although we are
aware of such problems.
8) How can I delete a space
http://code.xwiki.org/xwiki/bin/view/Snippets/DeleteSpaceSnippet
(linked from
http://platform.xwiki.org/xwiki/bin/view/Features/Spaces)
9) In case I want to clean up my somewhat messy wiki
and only export a
given Space so that I can recreate the Wiki and then import only that
given Space. Currently it seems I can only export everything and then
only select the space I want to be imported. I would prefer to do it
the other way around.
You can try using
http://code.xwiki.org/xwiki/bin/view/Applications/ImportExportApplication
10) I see really strange reaction from the system when
a Space name
(maybe even regular documents) contain a dot at the end. If that is an
issue why is the application no displaying a warning or error when
that happens (see my issue with the Trail).
Dots are not allowed in document names, since the dot separates the
space from the document (as in Space.Document). We strip dots from most
document creation forms that come with the default XE. If you know of
such a form that doesn't strip points, please report it.
I think that is bugging me the most right now. I still
like XWiki the
most so far and would be disappointed if I could not use it. I also
would be willing to help dealing with the JBoss classloading issue if
I can get the build to compile.
I really hope that these problems can be clarified/solved and have you
as a user. We're willing to work with you to solve these issues. As an
open source project, we are always listening to the community and try to
solve the problems encountered. As a company, we can offer you a support
contract to have these issues fixed with a higher priority, or even give
the administration burden to one of our admins. See
http://www.xwiki.com/ for more details.
--
Sergiu Dumitriu
http://purl.org/net/sergiu/