[Hpr] images

Ken Fallon ken.fallon at gmail.com
Sun Oct 14 00:43:54 PDT 2012

On Sun, 14 Oct 2012 00:19:04 +0100
Dave Morriss <dave.morriss at gmail.com> wrote:

> On 14/10/12 00:11, sigflup synasloble wrote:
> > What's the best way to include images in show notes?

The goal is to have everyone supply the show notes in Atom format. 
<title>, <summary>, <content>, and <rights> contain human-readable
text, usually in small quantities. The type attribute determines how
this information is encoded (default="text")

If type="text", then this element contains plain text with no entity
escaped html.

<title type="text">AT&T bought by SBC!</title>
If type="html", then this element contains entity escaped html.

<title type="html">
  AT&amp;T bought <b>by SBC</b>!
If type="xhtml", then this element contains inline xhtml, wrapped in a 
div element.

<title type="xhtml">
  <div xmlns="http://www.w3.org/1999/xhtml">
    AT&T bought <b>by SBC</b>!

So depending on the one type you pick for the summary element, the
encoding will change. However it should be a regular html image link.

Keep the images in the same directory and don't use any path.
<img src="big-xyz.jpg" alt="Photo of XYZ" title="XYZ">

Although optional, skipping the "alt" tag is not advised or teams of
Accessibility ninjas will descend on you. Just saying.

Whither you attach thumbnails or not is up to you. Probably best to
send in the highest quality original and let downstream systems handle
the thumbnails.

> I used txt2tags (http://txt2tags.org/) at Ken's recommendation. I then
> created images and their thumbnails and included them thus:
> [[./thumb.NERDTree.png] ./NERDTree.png]
> Dave

Ahh yes I've been meaning to talk to you about that :)
txt2tags is fine if you don't know html, but it will add an additional
processing step and that means a delay in getting it processed. So if
you know basic (x)html use that. If you're only using one link then use
TXT and the link tag. Avoid using javascript as that will definitely put
you in the "this will need to be checked" corner. 


More information about the Hpr mailing list