[博客空间]JSPWiki stable release v2.2.33_jspwiki-2.2.33-src.rar

[{TableOfContents}] !!What are the hardware requirements for JSPWiki? JSPWiki is really quite modest for a Java-based server. JSPWiki.org was running several wiki instances with a 266 MHz Pentium II with 512 MB of memory. The runtime memory consumption is between 80 to 200 MB (Tomcat 4), and CPU utilization is rarely above 15%. This depends heavily on your choice of JVM and ServletContainer, as well as the JVM options. The most CPU-intensive part is the initial scan of all pages, which is done only once during startup. With a slow CPU this can take a while (even minutes) for a large Wiki site. However, JSPWiki 2.2 does cache this information in your work directory. !!How are [Bread Crumbs|BreadCrumbsIdea] enabled? According to the release notes, bread crumbs (a.k.a. Your Trail) functionality was added? However the "PageHeader.jsp" (template) doesn't include the snippet of code to enable this functionality. Bread crumbs are displayed only in webdocs\template\default\ViewTemplate.jsp. It was done this way so the bread crumbs only work when you are viewing a page. Are you sure you have the latest CVS code? -- KenLiu Actually there isn't anything special required to enable the bread crumbs. They are enabled by default. My problem was that the new template (jsp) wasn't being picked up by tomcat. When I updated the timestamp on the jsp file, the jsp was recompiled and everything works. -- [Niel Eyde] If however in a fresh installation (under Tomcat 5) the breadcrumbs fail to show, where should one look for the cause and solution of this problem? Could it be cookie- or baseurl related? -- [Bart Breeschoten] A: They need cookies to be enabled in order to work. Just make sure your virtual host setup is correct. !!Why is there a noticeable delay when you first start JSPWiki up? This is because the ReferenceManager (the piece of software that is responsible for creating the "Referenced by" -list which you can see in the [left menu footer], the [unused pages] -list and [undefined pages] -list, scans all wiki pages on your hard drive for links. For a large Wiki on a slow machine, this initialization can take a long time. !!Why are my references all wrong? A: It could be that you have been modifying the repository while JSPWiki was off. Try deleting the "refmgr.ser" -file from your {{jspwiki.workDir}} -directory and restarting. !!How do I change the page layout, modify the presentation or add a logo A: Since version 1.9.x, all pages are now [templates|JSPWikiTemplates], which the administrator can change at will. The display of many page elements can be modified via the style sheets. !!I've written (a new plugin/bug fixes/new functionality)! How do I contribute it to JSPWiki? A: Please see [JSPWiki:ContributingChanges]. !!My Wiki does not start! A: Are you absolutely sure that you have edited the config file as instructed by the README in the download archive, and [JSPWiki:JSPWikiDownload]? JSPWiki __needs to know where to put all wiki and log files first__, before you can start it. The configuration file is called "jspwiki.properties" and it can be found in the WEB-INF directory of the WAR. !!Changes do not appear to pagehistory or to RecentChanges The probable reason for this is that you have changed the user id under which JSPWiki was running, AND you're using [RCSFileProvider]. RCS locks all files it checks out under the current user id, and does not allow any other user to do a checking. See [JSPWiki:RCSFileProviderIssues] for more information. !!$~Id$ gets always expanded I'm using Id in $ symbols on a Wiki page for explaining a CVS/RCS feature. How can I prevent that this gets expanded by your RCS call? Even triple { don't help. [JanneJalkanen]: First of all, this is only a RCSFileProvider specific issue. Other providers (like VersioningFileProvider) do not have this problem. I think you would need to put the following in your jspwiki.properties file: {{{ jspwiki.rcsFileProvider.checkoutCommand = co -kk -l %s jspwiki.rcsFileProvider.checkoutVersionCommand = co -kk -p -r1.%v %s }}} You can also put a '~' before the keyword, which stops the expansion. However, this may be a bit problematic if you do a cut-n-paste of source code. For more information about the RCSFileProvider, check RCSFileProviderIssues. !!How to avoid the port number in the URL? What is one (are some) way(s) to install JSPWiki so that the Tomcat port # doesn't show in the URL? Specifically, I'm looking for the way to do this so that the jsp is called right after the domain (e.g.localsite.org/Wiki.jsp?page=Example) just like it is here. A: Edit Tomcat's {{conf/server.xml}} file and replace port 8080 with port 80 and restart Tomcat. Note: If you are on Unix, this is a restricted port and you'll have run Tomcat as root. Also, if you have a web server running, this will produce a conflict. If you are running Apache, get the Tomcat module for it and configure it and then use Apache to talk to Tomcat to run your JSP applications. !!How to make JSPWiki faster? Well, there's always a bit of a penalty when using Java technology, though the modern virtual machines are getting really good. However, you can use OSCache to cache some of the JSPWiki output: Check out [UsingOSCacheWithJSPWiki] for more info. !!What is this XML-RPC thingy? XML-RPC stands for "XML- Remote Procedure Call". It basically allows you to make calls to the Wiki API from remote servers, without resorting to HTTP and having to deal with HTML formatting. See [WikiRPCInterface], [JSPWiki:NotificationList], and [JSPWiki:Hula] for examples. !!How do I rename pages? Create a new page, copy stuff from the old page, go and rename all links. We're working on a better solution, but also take a look at [JSPWiki:RenamePagePatch]. !!Can I block WikiSpam? Q: I've been getting some WikiSpam on my wiki. Is there any way to prevent this or at least block based on IP address? See [here|http://csx.calvin.edu/JSPWiki/Wiki.jsp?page=TextFormattingRules&version=5] for an example. --[DaveBrondsema] A: Yep, check out the [SpamFilter]. !!NDC (Nested Diagnostic Context) Q: What the heck does the variable NDC on Wiki.jsp reference? That is a new one on me. A: It is a "Nested Diagnostic Context". In effect, it's a way to tell [Log4j] which page is currently under handling, and it would allow us to do stuff like write a separate log for each page, or just a subset of pages. See [Log4j documentation|http://jakarta.apache.org/log4j/docs/manual.html] for more info. !!Loading time? ;:Q: I've seen it written that JSPWiki takes some time to initially load, but that once it does it runs pretty fast. What does this mean? What is loading? Where is it loading? --MatthewSimpson ;:A: JSPWiki uses most of the startup time to go through all of the pages and builds a list of all the links on those pages. This allows the BackLinks feature to work, since then we know which pages link where. It also allows us to build the [UndefinedPages] and [UnusedPages]. Another thing is that Java and the servlet container (like Tomcat) take a bit of time to start up, too. ;:Q: After doing this once, what would cause this list to be lost? Does it need to be rebuilt? How often? Why? ;:A: The rebuilding of the list only happens when the web server is started (or restarted). After that, we just track changes to all pages, so things are pretty fast. BTW, if you're using Tomcat, then it is possible to start just JSPWiki without starting the whole web server, which is a bit faster. See the [manager app documentation|http://jakarta.apache.org/tomcat/tomcat-4.0-doc/manager-howto.html]. The list is lost when the server is shut down because the current implementation does not save the index. Saving would require a consistency check on restart, otherwise possible manual additions/removals of pages woul