UseModjWiki - UseModj.UseModjFeatures

 	UseModj? v1.0a
 =========================

- date: 2004-02-22 - Developer : Seo Seok-Jin ( usemod@yahoo.com )

- Developping Environment :

	* OS: Window 2000
	* Language: Java
	* Server : jakarta-Tomcat4.1.xx
	* JDK : J2SDK1.4.1, J2SDKEE?
	* Tools/Components: 
		Eclipse v2.1, 
		HTML-Kit, 
		XDoclet, 
		Ant1.5.4, 
		Struts, strutsTestCase-2.1.0.jar,
		Velocity, VelocityTool?, 
		CSS,
		jakarta-oro.jar, 
		junit.jar v3.8.1, 
		log4j.jar, 

 	UseModj? v1.1a
 =========================

- date: 2004-05-20 - Developer : Seo Seok-Jin ( usemod@yahoo.com )

    * New Features :
        : File /Image Upload 
            ... { upload | attach | image }:< file or image name >
            ...  generates image thumbnail   
            ...  makes appear url link into image file
            ...  supports changing the uploaded file  

         : User.setCookie() modified

Features of User visible:

New RecentChanges:

Selectable number of days to display
Selectable order of changes (newest or oldest on top)
DifferenceLinks? to show the most recent changes
Summary information and minor edits can be noted on RecentChanges
SubPages? which allow every page to act like a separate wiki
InterWiki? links like Wiki:UseModWiki
A PageRedirect? command(useful for plural/singular link pairs)
EditConflict? detection and resolution
All pages have a search form and a link to RecentChanges
The editing lock can be force-cleared by a remote user
Index of all pages (common feature)
Full text searching (common feature)
Previous author backup allows recovery from accidental editing (common feature)
Free Links for free-form wiki names
Administrative features. See AdminFeatures? for documentation.

Features of Administrator or Editor visible: Administration: Unlock page /Lock page ... lock page editing. only admin or editor is editable Delete this page ... delete a page and its revisions Run Maintenance Edit/Rename pages ... Editing/Deleting page titles about site Lock site ... lock editing of all pages of site

Edit/Rename pages ... Editing/Deleting page titles:

  Enter one command on each line. Commands are: 
 !PageName? -- deletes the page called PageName? 
  =OldPageName?=NewPageName? -- Renames OldPageName? to NewPageName? and updates links to  OldPageName? to NewPageName?.
 |OldPageName?|NewPageName?  -- Changes links to OldPageName? to NewPageName?. (Used to rename links to non-existing pages.) 

 Note: page names are case-sensitive!

Configuration properties for Administator

   File: WEB-INF/classes/usemodj.properties : 
   ...

  # Set to non-blank to enable password(s)             
  AdminPass?   = admin 
  # Like AdminPass?, but for editing only            
   EditPass?  =

Administator or Editor Login : First confirm AdminPass? or EditPass? password in WEB-INF/classes/usemodj.properties Next, goto "Preferences" menu page and input admin password into Administrator Password: text box and save Then, Administration menu box apprears the left pane of all pages

Administator or Editor Logout : Goto "Preferences" menu page and input empty into Administrator Password: text box and save

Setup and other features:

Simple setup:

A single war file
Does not require external programs (but can use "diff")
Requires jdk 1.4.1, Tomcat 4.1.24
The war can be auto deployed and auto create needed directories and files
All configuration variables are at the WEB-INF/classes/usemodj.properties, ApplicationResources?.properties and WEB-INF/web.xml
International translation is supported by ApplicationResources?_{ko|jp|..}.properties that translated with jdk/bin/native2ascii.exe tool
Pages are stored in ordinary files, allowing simple renaming, deletion, and backups

File/Image Upload

  support after usemodj version 1.1a

Configuration properties for file upload File: WEB-INF/classes/usemodj.properties :

   ...

 # 1 = allow uploads, 0 = no uploads
 UseUpload? = 1           

 # Full path (like <Context ROOT Real Path>/uploads/<the first char of  fileName>/<fileName>) 
 # UploadDir? = $CONTEXT_DIR/uploads ($CONTEXT_DIR = C:/cafe/jakarta-tomcat-4.1.24/webapps/usemodj)
 UploadDir? = C:/cafe/jakarta-tomcat-4.1.24/webapps/usemodj/uploads  

 #  Full URL (like [http://foo.com]/<Context ROOT>/uploads/<the first char of fileName>/<fileName>)
 # UploadUrl? = $CONTEXT_URI/uploads ($CONTEXT_URI= /usemodj)
 UploadUrl? = /usemodj/uploads

File, Image upload wiki tag :

  {upload | image | attach}:<file name> 



 upload:<File Name or Image Name> 

 ex) upload:Tiger.gif , upload:wikiToturial.txt , upload:Mount 

 image:<Image Name> 

 ex) image:usemodj.gif , image:usemodj.png , image:usemodj.jpg , image:usemodj 

 attach:<File Name or Image Name>

 ex) attach:fileName.doc , attach:fileName , attach:imageName.png , attach:imageName 

  upload:<File Name or Image Name>  
     ex) 
   upload:Tiger.gif , upload:wikiToturial.txt , upload:Mount

  image:<Image Name>  
    ex) image:usemodj.gif , image:usemodj.png , image:usemodj.jpg , image:usemodj

  attach:<File Name or Image Name>  
    ex) attach:Tiger.gif , attach:Mount  , attach:Car.png , attach:WikiDocument???

Upload (Image | File) Scenario

First write <code>upload:<file or image name> </code> in wiki editing page and save it, and upload link(?) appears above the <file or image name>. click the link and upload the local file to the web server. . After a file is uploaded, file url link will appear and file change link(+) will be followed. <code> upload:, attach:, image: </code> are the same function(file or image upload). If image file has been uploaded, its thumbnail appears and there is url link to the uploaded image file. Thumbnail size is some different between <code>image:</code> tag and <code> upload: and attach: </code> tags

  upload:mount.jpg  attach:mount.gif  image:mount.png 
  upload:wikiToturial.txt  attach:wikiToturial.txt image:wikiPage.txt

Images (Url link)

Just provide the URL, and the image will be inserted inline.

    http:images/usemodj.gif (local url) 
  OR  
     http://www.usemod.com/wiki.gif