Use the new section title style in Asciidoctor. We previous use the section title style like: Section level 1 =============== Section level 2 --------------- Which have a problem in Asciidoctor that the number of "="s or "-"s must match the number of characters in the header exactly, as a result it's easy to make mistakes while changing the titles. Asciidoctor provides a better style like: = Section level 1 == Section level 2 So we switched to this style. Also fixed a bug in replace_macros.py, which will not cause any problem in the old style. Change-Id: I811dd7238735d98f662767c17086152cd69aea02
diff --git a/Documentation/config-reverseproxy.txt b/Documentation/config-reverseproxy.txt index 563b322..0c52be6 100644 --- a/Documentation/config-reverseproxy.txt +++ b/Documentation/config-reverseproxy.txt
@@ -1,8 +1,6 @@ -Gerrit Code Review - Reverse Proxy -================================== += Gerrit Code Review - Reverse Proxy -Description ------------ +== Description Gerrit can be configured to run behind a third-party web server. This allows the other web server to bind to the privileged port 80 @@ -10,8 +8,7 @@ from Java to optimized native C code. -Gerrit Configuration --------------------- +== Gerrit Configuration Ensure `'$site_path'/etc/gerrit.config` has the property link:config-gerrit.html#httpd.listenUrl[httpd.listenUrl] configured @@ -25,8 +22,7 @@ ---- -Apache 2 Configuration ----------------------- +== Apache 2 Configuration To run Gerrit behind an Apache server using 'mod_proxy', enable the necessary Apache2 modules: @@ -62,8 +58,7 @@ The two options 'AllowEncodedSlashes On' and 'ProxyPass .. nocanon' are required since Gerrit 2.6. -SSL -~~~ +=== SSL To enable Apache to perform the SSL processing, use 'proxy-https://' in httpd.listenUrl within Gerrit's configuration file, and enable @@ -83,8 +78,7 @@ configure SSL within the server, like controlling how strong of an encryption algorithm is required. -Troubleshooting -~~~~~~~~~~~~~~~ +=== Troubleshooting If you are encountering 'Page Not Found' errors when opening the change screen, your Apache proxy is very likely decoding the passed URL. @@ -93,8 +87,7 @@ 'AllowEncodedSlashes NoDecode' set. -Nginx Configuration -------------------- +== Nginx Configuration To run Gerrit behind an Nginx server, use a server statement such as this one: @@ -112,8 +105,7 @@ } ---- -SSL -~~~ +=== SSL To enable Nginx to perform the SSL processing, use 'proxy-https://' in httpd.listenUrl within Gerrit's configuration file, and enable @@ -136,8 +128,7 @@ how to configure SSL within the server, like controlling how strong of an encryption algorithm is required. -Troubleshooting -~~~~~~~~~~~~~~~ +=== Troubleshooting If you are encountering 'Page Not Found' errors when opening the change screen, your Nginx proxy is very likely decoding the passed URL.