My pod is getting linked to .tt files instead of .pod files in my CPAN distro

metaperl has asked for the wisdom of the Perl Monks concerning the following question:

In the DBIx::Cookbook distribution on search.cpan.org, if you take a look at the searching document you will notice that the pod links to files of the form:

DBIx/Cookbook/Recipe/Searching/$recipe.pod
[download]

for most of the cases starting from the top.

However, all pod links after the heading "specifying which columns to retrieve from a search" link to a ..tt file.

My problems with this are:

If you look at the raw pod you dont see any change in the syntax warranting this
When github formats this page all links point to the .pod files, never the .tt files

The only unusual thing is the head2 tag starts with a lowercase letter on the heading just before the odd redirection to .tt files starts

The mantra of every experienced web application developer is the same: thou shalt separate business logic from display. Ironically, almost all template engines allow violation of this separation principle, which is the very impetus for HTML template engine development.

-- Terence Parr, "Enforcing Strict Model View Separation in Template Engines"

Comment on My pod is getting linked to .tt files instead of .pod files in my CPAN distro Select or Download Code

Replies are listed 'Best First'.
Re: My pod is getting linked to .tt files instead of .pod files in my CPAN distro by jmcnamara (Monsignor) on Jun 22, 2010 at 21:45 UTC
That is odd. I see from the MANIFEST for DBIx::Cookbook that you include the `.tt` files and (I guess) the expanded `.pod` files. I'd guess that the variant of Pod::Simple used on search.cpan searches for local files to link to and somehow finds the `.tt` files instead of the `.pod` files (in some cases). I'd suggest excluding the `.tt` files from your distro before uploading to CPAN. -- John.	[reply]
Re: My pod is getting linked to .tt files instead of .pod files in my CPAN distro by Anonymous Monk on Jun 22, 2010 at 22:17 UTC
I have two ideas report the bug don't keep tt files under lib	[reply]
Re: My pod is getting linked to .tt files instead of .pod files in my CPAN distro by metaperl (Curate) on Jun 24, 2010 at 18:46 UTC
gbarr's reponse via RT: search.cpan.org searches for all files in the distribution that may have documentation. If there are files you do not want indexed them you should specify that in your META.yml I would suggest you add lib/DBIx/Cookbook/RecipeTT under no_index.directory The mantra of every experienced web application developer is the same: thou shalt separate business logic from display. Ironically, almost all template engines allow violation of this separation principle, which is the very impetus for HTML template engine development. -- Terence Parr, "Enforcing Strict Model View Separation in Template Engines"	[reply]