📄 help.html
字号:
<HTML>
<HEAD>
<TITLE>Faces Console - Help</TITLE>
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="blue" VLINK="blue">
<FONT FACE="Arial,Helvetica" SIZE="-1" COLOR="#666666"><B>JamesHolmes.com</B></FONT><BR>
<TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BGCOLOR="#FFFFFF">
<TR VALIGN="bottom">
<TD>
<FONT FACE="Arial,Helvetica" SIZE="+2"><B>Faces Console</B></FONT><BR>
</TD>
<TD ALIGN="right">
<FONT FACE="Arial,Helvetica" SIZE="-1">
<A HREF="index.html">Home</A> •
<A HREF="changelog.html">Change Log</A> •
<A HREF="download.html">Download</A> •
<A HREF="faq.html">FAQ</A> •
<A HREF="help.html">Help</A> •
<A HREF="screenshots.html">Screen Shots</A>
</FONT>
</TD>
</TR>
</TABLE>
<HR WIDTH="100%" SIZE="1" NOSHADE><BR>
<BLOCKQUOTE>
<FONT FACE="Arial,Helvetica" SIZE="+1"><B>Help</B></FONT><BR><BR>
<FONT FACE="Arial,Helvetica" SIZE="-1">
<OL>
<LI><b><A HREF="#install">Installing Faces Console</A></b></LI><br><br>
<LI><b><A HREF="#upgrade">Upgrading Faces Console</A></b></LI><br><br>
<LI><B><A HREF="#run">Running Faces Console (Standalone)</A></B>
<OL>
<LI TYPE="a"><A HREF="#run-win">Microsoft Windows Platforms</A></LI>
<LI TYPE="a"><A HREF="#run-unix">Unix/Linux Platforms</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#using"><B>Using Faces Console</B></A>
<OL>
<LI TYPE="a"><A HREF="#using-support">Supported Config Files</A></LI>
<LI TYPE="a"><A HREF="#using-validation">Turning Off DTD Validation</A></LI>
<LI TYPE="a"><A HREF="#using-output">Configuring Output Options</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#jbuilder"><B>Using Faces Console with Borland JBuilder</B></A>
<OL>
<LI TYPE="a"><A HREF="#jbuilder-install">Installing Faces Console OpenTool</A></LI>
<LI TYPE="a"><A HREF="#jbuilder-validation">Turning Off DTD Validation</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#eclipse"><B>Using Faces Console with Eclipse and IBM WebSphere Application Developer</B></A>
<OL>
<LI TYPE="a"><A HREF="#eclipse-install">Installing Faces Console Plugin</A></LI>
<LI TYPE="a"><A HREF="#eclipse-using">Using Faces Console inside Eclipse/WSAD</A></LI>
<LI TYPE="a"><A HREF="#eclipse-validation">Turning Off DTD Validation</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#idea"><B>Using Faces Console with IntelliJ IDEA</B></A>
<OL>
<LI TYPE="a"><A HREF="#idea-install">Installing Faces Console Plugin</A></LI>
<LI TYPE="a"><A HREF="#idea-using">Using Faces Console inside IDEA</A></LI>
<LI TYPE="a"><A HREF="#idea-validation">Turning Off DTD Validation</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#netbeans"><B>Using Faces Console with NetBeans and Sun One Studio (Forte)</B></A>
<OL>
<LI TYPE="a"><A HREF="#netbeans-install">Installing Faces Console Module</A></LI>
<LI TYPE="a"><A HREF="#netbeans-validation">Turning Off DTD Validation</A></LI>
</OL>
</LI><BR>
<LI><A HREF="#jdeveloper"><B>Using Faces Console with Oracle JDeveloper</B></A>
<OL>
<LI TYPE="a"><A HREF="#jdeveloper-install">Installing Faces Console Addin</A></LI>
<LI TYPE="a"><A HREF="#jdeveloper-using">Using Faces Console inside JDeveloper</A></LI>
<LI TYPE="a"><A HREF="#jdeveloper-validation">Turning Off DTD Validation</A></LI>
</OL>
</LI>
</OL>
</FONT><BR>
<A NAME="install"></A>
<FONT FACE="Arial,Helvetica"><B>1. Installing Faces Console</B></FONT><BR><BR>
<FONT FACE="Arial,Helvetica" SIZE="-1">
Installation is quick and easy when following these simple steps.
<OL>
<LI><A HREF="download.html">Download</A> the latest Faces Console release.</LI>
<LI>Unzip the distribution file to the directory where you want the Faces Console software installed at.<BR><BR>
i.e. "c:\Program Files\" on Microsoft Windows<BR>
i.e. "/home/<username>/" on Unix/Linux<BR><BR>
The distribution contains a parent directory named after the release with all of the directories and files
underneath it. For example, the 1.0 release distribution would have a parent directory called "faces-console-1.0".
</LI>
</OL>
</FONT><BR>
<A NAME="upgrade"></A>
<FONT FACE="Arial,Helvetica"><B>2. Upgrading Faces Console</B></FONT><BR><BR>
<FONT FACE="Arial,Helvetica" SIZE="-1">
Upgrading from one version of Faces Console to a newer version is pretty straight forward. If you are only
using the standalone Faces Console and no IDE plugins then all you have to do is follow the installation
instructions for the new version. Each Faces Console realease has a different parent directory, thus allowing
for multiple versions to be installed at once.<BR><BR>
You may decide to remove the previous version once the new version is installed. Simply delete the parent
directory for the previous version from where you installed it and the old version will no longer be installed.<BR><BR>
If you are using the Faces Console as a plugin to an IDE then you should only need to repeat the "faces-console.jar"
portion of the installation process for that IDE plugin. Please see the installation instructions for the IDE
plugin.
</FONT><BR><BR><BR>
<A NAME="run"></A>
<FONT FACE="Arial,Helvetica"><B>3. Running Faces Console (Standalone)</B></FONT><BR><BR>
<BLOCKQUOTE>
<FONT FACE="Arial,Helvetica" SIZE="-1">
<A NAME="run-win"></A>
<B>a. Microsoft Windows Platforms</B><BR><BR>
There are two ways to run the Faces Console on Windows machines:
<OL>
<LI>Using Windows explorer, navigate to the directory where you unzipped the Faces Console distribution to. Go into the "bin" directory and double click on "console".</LI>
<LI>Open a DOS command prompt window and navigate to the directory where you unzipped the Faces Console distribution to. Go into the "bin" directory and type "console".</LI>
</OL>
<A NAME="run-unix"></A>
<B>b. Unix/Linux Platforms</B><BR><BR>
<OL>
<LI>Navigate to the directory where you unzipped the Faces Console distribution to.</LI>
<LI><FONT COLOR="red">If you have not already done so</FONT>, change "console.sh" file permissions to be exceutable.</LI>
<LI>Go into the "bin" directory and run "console.sh".</LI>
</OL>
</FONT>
</BLOCKQUOTE><BR>
<A NAME="using"></A>
<FONT FACE="Arial,Helvetica"><B>4. Using Faces Console</B></FONT><BR><BR>
<FONT FACE="Arial,Helvetica" SIZE="-1">
The Faces Console is a simple GUI for editing the elements of JavaServer Faces and JavaServer Faces-related config files. For information on
what each config file element does and what values it accepts, please see the config file DTDs hyperlinked below.
<BR><BR>
Please see the <A HREF="faq.html">FAQ</A> page for other topics related to using Faces Console.
<BLOCKQUOTE>
<A NAME="using-support"></A>
<B>a. Supported Config Files</B><BR><BR>
Below is a list of the config files and their associated DOCTYPEs that Faces Console supports. If your config file does not specify one of these DOCTYPEs then Faces Console will not recognize your config file and thus will not be able to open it.
</FONT>
<BLOCKQUOTE>
<FONT FACE="Arial,Helvetica" SIZE="-1"><B>Faces</B></FONT>
<PRE>
<!DOCTYPE faces-config PUBLIC
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN"
"<A HREF="http://java.sun.com/dtd/web-facesconfig_1_1.dtd" TARGET="_blank">http://java.sun.com/dtd/web-facesconfig_1_1.dtd</A>">
<!DOCTYPE faces-config PUBLIC
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN"
"<A HREF="http://java.sun.com/dtd/web-facesconfig_1_0.dtd" TARGET="_blank">http://java.sun.com/dtd/web-facesconfig_1_0.dtd</A>">
</PRE>
<FONT FACE="Arial,Helvetica" SIZE="-1"><B>JSP Tag Library</B></FONT>
<PRE>
<!DOCTYPE taglib PUBLIC
"-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"<A HREF="http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd" TARGET="_blank">http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd</A>">
<!DOCTYPE taglib PUBLIC
"-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"<A HREF="http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd" TARGET="_blank">http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd</A>">
</PRE>
</BLOCKQUOTE>
<BR>
<A NAME="using-validation"></A>
<FONT FACE="Arial,Helvetica" SIZE="-1">
<B>b. Turning Off DTD Validation</B><BR><BR>
If your config file uses an altered DTD or simply has no DTD, then the Faces Console will not be able to open your
config file. To get around this you can turn off config file validation, thus allowing non-standard files to be opened.
<BR><BR>
In the standalone version of the software you can turn off this validation by selecting the option for it on the
"Options" menu. For instructions on how to turn off validation for IDE plugins, see the specific plugin's section
on this page.<BR><BR>
<A NAME="using-output"></A>
<B>c. Configuring Output Options</B><BR><BR>
The Faces Console reads in Faces config XML files and then manipulates them in memory using the JDOM XML library. Unfortunately, XML parser libraries do not retain all of a file's original formatting when it is parsed. This leads to poorly formatted XML output when the files are saved.
<BR><BR>
By default, the Faces Console saves/outputs XML files using JDOM's built in XMLOutputter functionality, which results in poorly formatted XML files. To get around this limitation, the standalone version of the Faces Console allows for the configuration of how XML output will be generated. Underneath the "Options" menu in the standalone version you can select "Output". This will bring up a dialog with options for generating "Pretty" output. Following is an explanation of each of the output options.
<BR><BR>
<FONT COLOR="red"><B>NOTE:</B> Enabling the "Pretty" output options will remove any comments and formatting from your original config files. The "Pretty" output option simply outputs config files' elements and their attributes.</FONT>
<BR><BR>
<IMG SRC="images/help/output.gif" BORDER="0" WIDTH="385" HEIGHT="480"><BR>
<OL>
<LI>Enables and disables the use of "Pretty" output options.</LI>
<LI>Determines the type of newlines to use. System Default is the default and recommended setting. For example, if you are using the Faces Console on a Windows system the System Default will use Windows newlines.</LI>
<LI>Determines the number of new lines to place in between elements.</LI>
<LI>Determines the number and type of indenting to use. Indenting is used for elements and is leveled. Each level in the element hierarchy is a level of indenting.</LI>
<LI>Determines whether an element's attributes should each be placed on a new line or if they should be placed on the same line as the element.</LI>
<LI>Determines whether or not empty elements, elements without sub elements, should be expanded. For example, if you have an <action> element with no child elements and have selected to expand empty elements it will be outputted as <action></action> instead of just <action/>.</LI>
<LI>Shows an example of how the output will look with the output options applied. This changes as you change the output options.</LI>
</OL>
</BLOCKQUOTE>
</FONT><BR>
<A NAME="jbuilder"></A>
<FONT FACE="Arial,Helvetica"><B>5. Using Faces Console with Borland JBuilder</B></FONT><BR><BR>
<FONT FACE="Arial,Helvetica" SIZE="-1">
The Faces Console software integrates with Borland JBuilder as an OpenTool for seamless development of JavaServer Faces applications in one development tool. Once the Faces Console OpenTool for JBuilder has been installed,
you can manage JavaServer Faces config files by simply opening them and clicking on the "Faces Console" tab.
<BLOCKQUOTE>
<A NAME="jbuilder-install"></A>
<B>a. Installing Faces Console OpenTool</B>
<OL>
<LI>Shutdown JBuilder if it is currently running.</LI>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -