On Jan 25, 2016, at 11:33 AM, John Gabriele <jgabri...@fastmail.fm> wrote:
> 
> So far I've been unable to get inline images to show up. Does the fossil
> wiki support that?

Yes, but not in a WYSIWYG fashion.  You need to use one of the markup languages 
to do that.

Rather than switch the WYSIWYG editor into raw HTML mode, I recommend that you 
learn Markdown, which is simpler than either HTML yet broadly useful.  Fossil 
Wiki is roughly as powerful as Markdown, but because it delegates a lot of its 
power to HTML, Markdown ends up being simpler in many cases, including this one.

Markdown is also more broadly useful on the Internet than Wiki syntax, being 
built into so many other tools.  (Github, blogging platforms, Stack Exchange…)

You can get up to speed on Markdown quickly:

  https://daringfireball.net/projects/markdown/basics

or from “fossil ui” on a local repo:

  http://localhost:8080/md_rules

Referencing an image attachment from a Markdown-formatted wiki article requires 
jumping through a few hoops, but it’s not too horrible:

1. Attach the image
2. Click attachment
3a. Right-click “Image,” then copy the URL
3b. Alternately, left-click “Image,” then copy URL from the browser’s address 
bar
4. Add something like this to the wiki article

  ![description of image](/raw/01ed6167686c0da94803655c8dcd2ddf52c92608)

Notice that I’ve trimmed the URL down, removing leading and trailing bits that 
aren’t necessary here.  You can actually abbreviate it further, since you only 
need to give as much of that big long hexadecimal number as is unique in your 
repository.  Five to eight digits should suffice for a small repo:

  ![description of image](/raw/01ed61)

The HTML form is a bit more verbose:

  <img alt="description of image" 
src="/raw/01ed6167686c0da94803655c8dcd2ddf52c92608"/>

The Fossil Wiki language doesn’t have a special syntax for inline images.  It 
just uses a form of HTML:

  <p><img alt="description of image" 
src="/raw/01ed6167686c0da94803655c8dcd2ddf52c92608"/></p>

The <p> wrapper is necessary here for reasons you should not have to care about 
unless you’re a web developer.  That’s a good reason why I recommend Markdown 
over Fossil Wiki.

> Does the markdown flavor supported by fossil support
> tables?

Yes, though it isn’t explained in /md_rules:

  -----------
  Foo | Bar
  -----------
  1    | 2
  3    | 4
  -----------


_______________________________________________
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Reply via email to