From: kkolinko Date: Tue, 2 Mar 2010 15:23:06 +0000 (+0000) Subject: Implement support for automatic generation of Table of Contents. X-Git-Url: https://git.internetallee.de/?a=commitdiff_plain;h=27dfc77b1d51dc070e8bc241e108a92bfbc9f834;p=tomcat7.0 Implement support for automatic generation of Table of Contents. It is triggered by element. Section header is not included into generation, so the complete code fragment to add will be
The html-manager-howto.xml provides a usage example for this. Also corrected minor issues with tags nesting, reported by w3c validator. git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@918073 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/webapps/docs/html-manager-howto.xml b/webapps/docs/html-manager-howto.xml index 4ccf7cce5..e8d5990cb 100644 --- a/webapps/docs/html-manager-howto.xml +++ b/webapps/docs/html-manager-howto.xml @@ -29,6 +29,10 @@ +
+ +
+

In many production environments it is very useful to have the capability @@ -36,7 +40,7 @@ to manage your web applications without having to shut down and restart Tomcat. This document is for the HTML web interface to the web application manager.

-

The interface is divided into six sections: +

The interface is divided into six sections:

  • Message - Displays success and failure messages.
  • Manager - General manager operations like list and @@ -48,7 +52,6 @@ Tomcat. This document is for the HTML web interface to the web application
  • Server Information - Information about the Tomcat server.
-

@@ -68,7 +71,7 @@ application documentation.
-

The Manager section has three links: +

The Manager section has three links:

  • List Applications - Redisplay a list of web applications.
    • @@ -76,7 +79,6 @@ application documentation.
  • Manager Help - A link to the comprehensive Manager App HOW TO.
-

@@ -84,7 +86,7 @@ application documentation.

The Applications section lists information about all the installed web applications and provides links for managing them. For each web application -the following is displayed: +the following is displayed:

-

@@ -129,7 +130,7 @@ OK - Started application at context path /examples

Otherwise, the Message will start with FAIL and include an -error message. Possible causes for problems include: +error message. Possible causes for problems include:

  • Encountered exception
    @@ -152,7 +153,6 @@ error message. Possible causes for problems include: The path parameter is required.
-

 @@ -162,14 +162,14 @@ error message. Possible causes for problems include: deployed. Any request that comes in while an application is stopped will see an HTTP error 404, and this application will show as "stopped" on a list applications command.

- +

If this command succeeds, you will see a Message like this:

OK - Stopped application at context path /examples - +

Otherwise, the Message will start with FAIL and include an -error message. Possible causes for problems include: +error message. Possible causes for problems include:

-

@@ -217,7 +216,7 @@ OK - Reloaded application at context path /examples

Otherwise, the Message will start with FAIL and include an -error message. Possible causes for problems include: +error message. Possible causes for problems include:

-

@@ -268,14 +266,14 @@ remove it from Tomcat (which also makes this context path available for reuse later). This command is the logical opposite of the /deploy Ant command, and the related deploy features available in the HTML manager.

- +

If this command succeeds, you will see a Message like this:

OK - Undeployed application at context path /examples - +

Otherwise, the Message will start with FAIL and include an -error message. Possible causes for problems include: +error message. Possible causes for problems include:

-

@@ -335,22 +332,22 @@ refer to the entire WAR file.

In this example the web application located in the directory C:\path\to\foo on the Tomcat server (running on Windows) -is deployed as the web application context named /footoo. +is deployed as the web application context named /footoo.

Context Path: /footoo WAR or Directory URL: file:C:/path/to/foo -

+

In this example the ".war" file /path/to/bar.war on the Tomcat server (running on Unix) is deployed as the web application context named /bar. Notice that there is no path parameter so the context path defaults to the name of the web application -archive file without the ".war" extension. +archive file without the ".war" extension.

WAR or Directory URL: jar:file:/path/to/bar.war!/ -

+

Deploy a Directory or War from the Host appBase

@@ -362,20 +359,20 @@ or the war file name without the ".war" extension is used as the path.

foo in the Host appBase directory of the Tomcat server is deployed as the web application context named /foo. Notice that there is no path parameter so the context path defaults -to the name of the web application directory. +to the name of the web application directory.

WAR or Directory URL: foo -

+

In this example the ".war" file bar.war located in your Host appBase directory on the Tomcat server is deployed as the web -application context named /bartoo. +application context named /bartoo.

Context Path: /bartoo WAR or Directory URL: bar.war -

+

Deploy using a Context configuration ".xml" file

@@ -388,7 +385,7 @@ configuration file.

A Context configuration ".xml" file can contain valid XML for a web application Context just as if it were configured in your Tomcat server.xml configuration file. Here is an -example for Tomcat running on Windows: +example for Tomcat running on Windows:

<Context path="/foobar" docBase="C:\path\to\application\foobar" debug="0"> @@ -399,27 +396,27 @@ example for Tomcat running on Windows: </Context> -

+

Use of the WAR or Directory URL is optional. When used to select a web application ".war" file or directory it overrides any docBase configured in the context configuration ".xml" file.

Here is an example of installing an application using a Context -configuration ".xml" file for Tomcat running on Windows. +configuration ".xml" file for Tomcat running on Windows.

XML Configuration file URL: file:C:/path/to/context.xml -

+

Here is an example of installing an application using a Context configuration ".xml" file and a web application ".war" file located -on the server (Tomcat running on Unix). +on the server (Tomcat running on Unix).

XML Configuration file URL: file:/path/to/context.xml WAR or Directory URL: jar:file:/path/to/bar.war!/ -

+ diff --git a/webapps/docs/tomcat-docs.xsl b/webapps/docs/tomcat-docs.xsl index 332413db3..950ce9dba 100644 --- a/webapps/docs/tomcat-docs.xsl +++ b/webapps/docs/tomcat-docs.xsl @@ -106,9 +106,7 @@ - -

- +

APACHE LOGO @@ -134,7 +132,7 @@ LEFT SIDE NAVIGATION - + @@ -238,6 +236,23 @@ + + +
+ + + + + + +
  • + +
    +     +
    • +     + + @@ -247,35 +262,35 @@
    - + - + - +
    - +
    		- +
    - + - + - +