一、從1.X升級到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服務。
5、打開htpp://localhost:8080/struts-menu/

三、把Struts Menu整合到你的應用程序中：
Struts Menu能夠被輕易的整合到你的Struts應用程序中，它也可以整合到一個非Struts的應用程序中，但是我不喜歡這樣做，所以在此沒有提供相應的教程。這里將一步步的帶你整合這個標簽庫。
你需要把struts-menu.jar放到你的WEB-INF/lib目錄下。然后使用URI標簽聲明你的JSP文件中想使用的這個標簽庫。
如果使用Struts Menu 2.1，你還需要 Jakarta's Standard Tag Library JAR包放入你的WEB-INF/lib目錄下。下載地址：http://ibiblio.org/maven/taglibs/jars/standard-1.0.4.jar，這個文件包括例程WAR包文件和二進制發布包。
1、放入struts-menu.jar包到你的應用程序的WEB-INF/lib目錄中。
2、在你的struts-config.xml文件中加入plug-in設置。
 <plug-in className="net.sf.navigator.menu.MenuPlugIn">
   <set-property property="menuConfig"
     value="/WEB-INF/menu-config.xml"/>
 </plug-in>
3、你將需要在你的應用程序的/WEB-INF/menu-config.xml文件中定義你的菜單，這里提供一個簡單的片斷：
 <Menu name="contactMenu" title="Contact" location="?Contact">
   <Item name="email" title="E-Mail" location="?EMail"/>
   <Item name="phone" title="Phone" location="?Phone"/>
 </Menu>
　　更多全面的例程，請查看應用程序的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"/>

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

使用定制的Velocity模版實施你的菜單，你需要整合Velocity到你的WEB應用程序中。如果需要這樣做的話，請完成下面的步驟：
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”屬性指向一個文件（如config="/templates/tabs.html"）或者如果tabs.htm在你的WEB-INF/classes目錄中的話，則可設config="tabs.html"。

這里提供了一些使用Velocity的displayer例子，可在sample application（http://demo.raibledesigns.com/struts-menu/index.jsp）中查看。它總是在你的菜單需要的時候顯示CSS，JavaScript和圖像文件。下面有一些在當前的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

所有相關的有用的文件如果你需要的話都可以在下面的站點上下載：
 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的顯示/隱藏菜單的信息，請查看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類的源代碼。

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

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

如果你喜歡使用Eclipse開發項目，請參考此份開發向導（http://struts-menu.sourceforge.net/devguide.html）。