[md-importer] Figure out how to display images

[Daniel Holbach]

Figure out how to display images in imported markdown docs. /snappy/build-apps should have one.

[Daniel Holbach (dholbach)]

David: do you have an idea how we could do this?

[Daniel Holbach (dholbach)]

I can see two options:

1) ship the image in trunk, make it show up in markdown too
    + produced markdown docs look the same as ours
    + less monkeying around with the produced HMTL
    - needs upload of images to swift
    - needs us to figure out how make it look well with markdown

2) have a custom solution, like setting a "hero picture" for a given article
    + no monkeying around with markdown
    - needs picture upload capability
    - needs new table for ImportedMarkdownArticle (if we decide to go with the idea of overriding URLs for imported articles we need this anyway)

Anything I've missed or forgotten?

[Daniel Holbach (dholbach)]

https://daringfireball.net/projects/markdown/syntax#img or https://daringfireball.net/projects/markdown/syntax#html

[Daniel Holbach (dholbach)]

Both would require us to keep track of the image, so remove it if it gets dropped from the article or the article gets deleted.

[Daniel Holbach (dholbach)]

Option 3:
<davidcalle> dholbach, I would say: hosting images in the docs dir in snapcraft, and using the proper markdown extension (there is one for images). To have something that would work both and github and d.u.c, with images hosted on github
<dholbach> so we'd hotlink to the image on github? or did I misunderstand
<davidcalle> dholbach, yes we would