一、從1.X升級(jí)到2.X需要做以下事情：
1、改變你的taglib聲明中的URI。
 <% at taglib uri="http://struts-menu.sf.net/tag" prefix="menu" %>
2、改變<plug-in>,使用新的包名"net.sf.navigator." 。
 <plug-in className="net.sf.navigator.menu.MenuPlugIn">
3、改變你的menu-config.xml文件，使用新的包名"net.sf.navigator." 。
 <Displayer name="Simple"
   type="net.sf.navigator.displayer.SimpleMenuDisplayer"/>

二、快速開始：
1、下載最新的struts-menu版本；
2、解包到本地目錄；
3、下載Tomcat或者其它Servlet容器；
4、把struts-menu.war包放入Tomcat安裝目錄的wabapps目錄下，并重啟Tomcat服務(wù)。
5、打開htpp://localhost:8080/struts-menu/

三、把Struts Menu整合到你的應(yīng)用程序中：
Struts Menu能夠被輕易的整合到你的Struts應(yīng)用程序中，它也可以整合到一個(gè)非Struts的應(yīng)用程序中，但是我不喜歡這樣做，所以在此沒(méi)有提供相應(yīng)的教程。這里將一步步的帶你整合這個(gè)標(biāo)簽庫(kù)。
你需要把struts-menu.jar放到你的WEB-INF/lib目錄下。然后使用URI標(biāo)簽聲明你的JSP文件中想使用的這個(gè)標(biāo)簽庫(kù)。
如果使用Struts Menu 2.1，你還需要 Jakarta's Standard Tag Library JAR包放入你的WEB-INF/lib目錄下。下載地址：http://ibiblio.org/maven/taglibs/jars/standard-1.0.4.jar，這個(gè)文件包括例程WAR包文件和二進(jìn)制發(fā)布包。
1、放入struts-menu.jar包到你的應(yīng)用程序的WEB-INF/lib目錄中。
2、在你的struts-config.xml文件中加入plug-in設(shè)置。
 <plug-in className="net.sf.navigator.menu.MenuPlugIn">
   <set-property property="menuConfig"
     value="/WEB-INF/menu-config.xml"/>
 </plug-in>
3、你將需要在你的應(yīng)用程序的/WEB-INF/menu-config.xml文件中定義你的菜單，這里提供一個(gè)簡(jiǎn)單的片斷：
 <Menu name="contactMenu" title="Contact" location="?Contact">
   <Item name="email" title="E-Mail" location="?EMail"/>
   <Item name="phone" title="Phone" location="?Phone"/>
 </Menu>
　　更多全面的例程，請(qǐng)查看應(yīng)用程序的web/WEB-INF目錄中的menu-config.xml文件，你可以截取一段作為你需要的菜單。完整的屬性列表，可以查看MenuBase class's javadocs（http://struts-menu.source......avigator/menu/MenuBase.html）。
4、在你的JSP文件的頂部加入taglib聲明：
 <% at taglib uri="http://struts-menu.sf.net/tag" prefix="menu" %>
5、在你的JSP文件中要放置菜單的位置加入taglib代碼：
 <menu:useMenuDisplayer name="TabbedMenu"
   bundle="org.apache.struts.action.MESSAGE">
   <menu:displayMenu name="Home"/>
   <menu:displayMenu name="About"/>
 </menu:useMenuDisplayer>
　　屬性name="TabbedMenu"被定義在menu-config.xml文件的頂部：
 <Displayer name="TabbedMenu"
   type="net.sf.navigator.displayer.TabbedMenuDisplayer"/>

(譯注：其實(shí)到此步即可在你的JSP文件中添加相應(yīng)的菜單了，只不過(guò)是沒(méi)有結(jié)合Velocity。在menu-config.xml文件的頭部可以定義多個(gè)Displayer，每個(gè)Displayer都有name和type屬性，name屬性與JSP文件中menu:useMenuDisplayer標(biāo)簽的name屬性相對(duì)應(yīng)，即表明使用何種樣式，具體的樣式定義便在type屬性中定義，type屬性中是一個(gè)class。在menu-config.xml文件中的菜單定義中的name屬性則與JSP文件中的menu:displayMenu標(biāo)簽的name屬性相對(duì)應(yīng)。)

使用定制的Velocity模版實(shí)施你的菜單，你需要整合Velocity到你的WEB應(yīng)用程序中。如果需要這樣做的話，請(qǐng)完成下面的步驟：
1、確定你的menu-config.xml文件有“Velocity”的displayer定義：
 <Displayer name="Velocity"
     type="net.sf.navigator.displayer.VelocityMenuDisplayer"/>
2、加入Velocity的JARs包到你的WEB-INF/lib目錄中，下載velocity-1.4-rc1.jar（http://www.ibiblio.org/ma......y/jars/velocity-1.4-rc1.jar）和velocity-tools-view-1.0.jar（http://www.ibiblio.org/ma......velocity-tools-view-1.0.jar）。
3、加入globalMacros.vm（http://cvs.sourceforge.net/viewcvs.py/*checkout*/struts-menu/navigator/web/WEB-INF/classes/globalMacros.vm?content-type=text%2Fplain&rev=1.1（右鍵另存為））到你的WEB-INF/lib目錄中。
4、改變你的JSP文件中displayer的值為“Velocity”，“config”屬性指向一個(gè)文件（如config="/templates/tabs.html"）或者如果tabs.htm在你的WEB-INF/classes目錄中的話，則可設(shè)config="tabs.html"。

這里提供了一些使用Velocity的displayer例子，可在sample application（http://demo.raibledesigns.com/struts-menu/index.jsp）中查看。它總是在你的菜單需要的時(shí)候顯示CSS，JavaScript和圖像文件。下面有一些在當(dāng)前的Struts Menu中用到的Velocity模版的例子的鏈接：
 CoolMenus: Demo（http://demo.raibledesigns......menu/velocity-coolmenu4.jsp）,
  　 Template（http://struts-menu.sourceforge.net/templates/coolmenus.html）
 NiceTabs: Demo, Template
 Tabs: Demo, Template
 XTree: Demo, Template

所有相關(guān)的有用的文件如果你需要的話都可以在下面的站點(diǎn)上下載：
 Images （http://struts-menu.sourceforge.net/menu-images/）
 Stylesheets （http://struts-menu.sourceforge.net/styles/）
 Scripts （http://struts-menu.sourceforge.net/scripts/）
 Templates （http://struts-menu.sourceforge.net/templates/）

更多的基于roles的顯示/隱藏菜單的信息，請(qǐng)查看FAQs（http://struts-menu.sourceforge.net/faq.html）。

四、在Struts之外使用Struts Menu:
在2.2版中，Menu Repository能夠使用MenuContextListener載入：
 <!--
    - Loads the menu-config.xml for struts-menu at startup,
    - by default from "/WEB-INF/menu-config.xml".
    - To override this, add a context-param named "menuConfigLocation"
    - web.xml file.
    -->
 <listener>
     <listener-class>net.sf.navigator.menu.MenuContextListener</listener-class>
 </listener>

或者如果你使用Spring，甚至更容易。僅僅需要加入下面的部分到你的applicationContext.xml文件中：
 <bean id="menu" class="net.sf.navigator.menu.MenuLoader">
   <property name="menuConfig">
     <value>/WEB-INF/menu-config.xml</value>
   </property>
 </bean>
 <!-- The menuConfig property is an optional attribute.  It is set to
     /WEB-INF/menu-config.xml by default. -->
感謝Dan Luputan提供MenuLoader類的源代碼。

五、從源文件編譯：
要從源文件編譯這個(gè)項(xiàng)目，執(zhí)行下面的步驟：
1、下載并安裝Maven（http://maven.apache.org/）；
2、創(chuàng)建一個(gè)環(huán)境變量MAVEN＿HOME指出你的Maven的安裝目錄，然后添加$MAVEN_HOME/bin到你的PATH變量中；
3、操縱這個(gè)目錄你可以擴(kuò)展源代碼，執(zhí)行“maven.jar”創(chuàng)建target/struts-menu.jar。

要展開struts-menu例程，需要下面的步驟：
1、下載和安裝Tomcat；
2、創(chuàng)建一個(gè)環(huán)境變量CATALINA＿HOME指出你的Tomcat的安裝目錄；
3、執(zhí)行“maven deploy”把應(yīng)用程序展開到Tomcat中；
4、打開http://localhost:8080/struts-menu在你喜愛的瀏覽器中。

如果你喜歡使用Eclipse開發(fā)項(xiàng)目，請(qǐng)參考此份開發(fā)向?qū)В?a >http://struts-menu.sourceforge.net/devguide.html）。