summaryrefslogtreecommitdiff
path: root/doc/todo/inline_raw_files.mdwn
blob: 100c07288776cfd5490a363fab23b84a9f7c9aeb (plain)

[[!template id=gitbranch branch=wtk/master author="[[wtk]]"]]

summary

Extend inlining to handle raw files (files with unrecognized extensions).

Also raise an error in IkiWiki::pagetype($file) if $file is blank, which avoids trying to do much with missing files, etc.

I'm using the new code in my blog.

usage

\[[!inline pagenames="somefile.txt" template="raw" feeds="no"]]

But inline already supports raw files in two ways:

  • setting raw=yes will cause a page to be inlined raw without using any template, as if it were part of the page at the location of the inline
  • otherwise, the file becomes an enclosure in the rss feed, for use with podcasting.

So I don't see the point of your patch. Although since your text editor seems to like to make lots of whitespace changes, it's possible I missed something in the large quantity of noise introduced by it. --[[Joey]]

As I understand it, setting raw=yes causes the page to be inlined as if the page contents had appeared in place of the directive. The content is then processed by whatever htmlize() applies to the inlining page. I want the inlined page to be unprocessed, and wrapped in <pre><code>...</code></pre> (as they are on the blog post I link to above).

Enclosures do not include the page contents at all, just a link to them. I'm trying to inline the content so I can comment on it from the inlining page.

Apologies for my cluttered version history, I should have branched my earlier changes off to make things clearer. I tried to isolate my whitespace changes (fixes?) in c9ae012d245154c3374d155958fcb0b60fda57ce. 157389355d01224b2d3c3f6e4c1eb42a20ec8a90 should hold all the content changes.

A list of other things globbed into my master branch that should have been separate branches:

  • Make it easy to select a Markdown executable for mdwn.pm.
  • Included an updated form of [[Javier Rojas' linktoimgonly.pm|forum/link_to_an_image_inside_the_wiki_without_inlining_it]].
  • Included an updated form of Jason Blevins' mdwn_itex.pm.
  • Assorted minor documentation changes.

--[[wtk]]