Konstantin, On 6/10/14, 4:46 PM, Konstantin Kolinko wrote: > 2014-06-10 18:25 GMT+04:00 Christopher Schultz <ch...@christopherschultz.net>: >> All, >> >> I noticed a series of typos on the connectors docs and I was going to >> fix them. Before noticing that, as usual, .xml -> .html, I saw that >> there are two copies of many parts of the site: "regular" and "printer". >> For example: >> >> ./tomcat-site/docs/connectors-doc/generic_howto/printer/workers.html >> ./tomcat-site/docs/connectors-doc/generic_howto/workers.html >> ./tomcat-site/docs/connectors-doc/reference/printer/workers.html >> ./tomcat-site/docs/connectors-doc/reference/workers.html >> >> I checked, and the only difference appears to be that the "regular" >> pages have a link to the "printable" pages, their links (due to nested >> directories) all have an additional ".." in them, and of course the >> "left navigation bar" is missing. >> >> Is there a reason not to do this with CSS where the @media=print just >> hides the left bar? I think we'd have a slightly simpler docs/build, >> fewer pages and links, etc. >> >> Any objections to me removing those extra pages and using CSS instead? > > Just a legacy. See > https://svn.apache.org/r601180 > https://svn.apache.org/r717913 > https://svn.apache.org/r941413 > > Connectors are released rather rarely, so just nobody worked on that.
Thanks for the references. I'll likely make similar changes to the connectors project, then. > A caveat may be that you have to update build.xml as well and make > sure that a src buindles build successfully. Both > tomcat-connectors-1.2.40-src.zip and > tomcat-connectors-1.2.40-src.tar.gz contain "docs" directory with > generated documentation in them. Gotcha. I'm okay with the generated documentation lacking those printer/.html files. I'm more worried about potential external links out there in the world stuffed into documentation, etc. > The binary bundles do not have documentation in them, just README, > LICENSE, NOTICE and a binary (e.g. mod_jk.so). So those are not > affected. > >> We'd want to set up permanent redirects from the printer/* URLs to their >> replacements, and I don't know how to do that from the docs themselves >> unless we actually code META REFRESH which seems silly when the web >> server can handle that for us. I'd need a bit of help from the infra >> team for that, I think. > > Redirection can be done with a ".htaccess" file, like here: > https://svn.apache.org/viewvc/tomcat/site/trunk/docs/faq/ Aah, okay. I didn't realize that .htaccess files were okay to use. They seem like a huge security hole ;) -chris
signature.asc
Description: OpenPGP digital signature
