You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Rich Bowen <rb...@rcbowen.com> on 2009/12/18 14:26:11 UTC

Your mod_rewrite tutorial

Joseph,

I just saw your new mod_rewrite tutorial - http://net.tutsplus.com/tutorials/other/a-deeper-look-at-mod_rewrite-for-apache/ 
  - and it was firmly in the category "much better than most." I left  
you a few comments, but for the most part I thought you did a great  
job of explaining things.

I'm on the Apache documentation team. Over the last six months or so,  
we've been doing a major rewrite of the docs, because they are bloody  
awful, and serve to scare away a lot of people who could otherwise be  
helped by them. The "Voodoo" remarks don't help, do they? The new docs  
are here: http://httpd.apache.org/docs/trunk/rewrite

I particularly liked your diagrams, and was wondering if you would be  
willing to donate them to the Apache Software Foundation for use in  
the mod_rewrite documentation. The docs, as you know, have this  
diagram: http://httpd.apache.org/docs/trunk/images/mod_rewrite_fig1.gif

It's confusing, to say the least, and I was wondering if we could have  
your permission to replace it with this one: http://nettuts.s3.cdn.plus.org/435_htaccess/images/flow_chart.png

I was also very fond of http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewriterule.png 
  and http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewritecond.png 
  and http://nettuts.s3.cdn.plus.org/435_htaccess/images/url_full.png  
and would like to use those too, with your permission.

Heck, while we're at it, would you consider subscribing to the  
documentation mailing list (docs-subscribe@httpd.apache.org) and  
coming along to help us out with the mod_rewrite docs rewrite? We  
could use your flair for step-by-step explanation and diagraming.

Thanks, and I hope you'll be willing to come help us out.

Rich Bowen, for the Apache HTTPd Documentation project

--
Rich Bowen
rbowen@apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: Your mod_rewrite tutorial

Posted by Joseph Pecoraro <jo...@gmail.com>.
Now that I've subscribed, I'll give an on list response:

> I particularly liked your diagrams, and was wondering if you would be willing to donate them to the Apache Software Foundation for use in the mod_rewrite documentation. The docs, as you know, have this diagram: http://httpd.apache.org/docs/trunk/images/mod_rewrite_fig1.gif
> 
> It's confusing, to say the least, and I was wondering if we could have your permission to replace it with this one: http://nettuts.s3.cdn.plus.org/435_htaccess/images/flow_chart.png
> 
> I was also very fond of http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewriterule.png and http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewritecond.png and http://nettuts.s3.cdn.plus.org/435_htaccess/images/url_full.png and would like to use those too, with your permission.

Absolutely. I am willing to donate the images. You may use it with whatever license you need.

I also have all of the original files (OmniGraffle on Mac OS X), so if you think they should be updated, or any wording changed, I'd be happy to update them.


> Heck, while we're at it, would you consider subscribing to the documentation mailing list (docs-subscribe@httpd.apache.org) and coming along to help us out with the mod_rewrite docs rewrite? We could use your flair for step-by-step explanation and diagraming.
> 
> Thanks, and I hope you'll be willing to come help us out.

I'm going to be quite busy on existing projects for the next few months, but I am interested in helping out the Apache team. You guys do great work. I just subscribed. I may not be as active as I would have liked, but we will see how things go.

Cheers,
Joseph Pecoraro
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: Your mod_rewrite tutorial

Posted by Joseph Pecoraro <jo...@gmail.com>.
>>> I was also very fond of http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewriterule.png and http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewritecond.png andhttp://nettuts.s3.cdn.plus.org/435_htaccess/images/url_full.png and would like to use those too, with your permission.
>> 
>> I would absolutely be willing to donate the images! I also have all of the original files (OmniGraffle on Mac OS X), so if you think they should be updated, or any wording changed, I'd be happy to update them.
> 
> I have a requested change to the file syntax_rewritecond.png

This was actually syntax_rewriterule.png.


> It contains the phrase: Regular Expression checked against the "URL Part" which is similar to REMOTE_URI
> 
> I was wondering if you could change that phrase to: Regular Expression checked against the requested URI, which is the part after "http://hostname"
> 
> Or words to that effect. Yes, it's nit-picky, but the regex is matched against the URI, not the full URL.

Sure. Here is what the change produces:
http://grab.by/1tZn

When a particular format is chosen (another email thread) I will
put the updated files in a public location where you can
download them.

In my article, I made up the terminology "URL Part" to simplify
things for readers. I expected that the technical documentation
to be more precise.  Good suggestion.

- Joe
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Re: Your mod_rewrite tutorial

Posted by Rich Bowen <rb...@rcbowen.com>.
On Dec 18, 2009, at 11:26 , Joseph Pecoraro wrote:

>>
>> I was also very fond of http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewriterule.png 
>>  and http://nettuts.s3.cdn.plus.org/435_htaccess/images/syntax_rewritecond.png 
>>  andhttp://nettuts.s3.cdn.plus.org/435_htaccess/images/url_full.png  
>> and would like to use those too, with your permission.
>
> I would absolutely be willing to donate the images! I also have all  
> of the original files (OmniGraffle on Mac OS X), so if you think  
> they should be updated, or any wording changed, I'd be happy to  
> update them.

I have a requested change to the file syntax_rewritecond.png

It contains the phrase: Regular Expression checked against the "URL  
Part" which is similar to REMOTE_URI

I was wondering if you could change that phrase to: Regular Expression  
checked against the requested URI, which is the part after "http://hostname 
"

Or words to that effect. Yes, it's nit-picky, but the regex is matched  
against the URI, not the full URL.

Thanks.

--
Rich Bowen
rbowen@rcbowen.com