doc: adjust WikiExport documentation

[A-dot-S-dot]

Hey,
it seems to be sufficient to set only url_extension to make -link_ext_replace work. It's my first pull request I ever made. So I appreciate every feedback.

[lervag]

Hey, it seems to be sufficient to set only url_extension to make -link_ext_replace work. It's my first pull request I ever made. So I appreciate every feedback.

To be honest, it's a little bit unclear why you find the original phrasing to be wrong. Could you perhaps expand a little on what makes you think your suggested change is correct?

Considering the PR, it is clear that the phrasing must be confusing, and so I would be surprised if we can come up with an improvement here.

[A-dot-S-dot]

Ok, then I had misunderstood the instructions. I thought you had to create a separate entry for html. Then it would be enough to use option url_extension for the extension. But I realize that I don't need this entry and that the links are adjusted on its own somehow. How was this requirement originally meant? Suppose you have the following code example? How I should adjust it regarding the doc?

let g:wiki_link_creation = {
      \ 'md': {
      \   'link_type': 'md',
      \   'url_extension': '.md',
      \   'url_transform': { x ->
      \     printf("0x%08x", str2nr(strftime('%s')))},
      \ },
      \}

let s:pandoc_args = '--standalone '
      \.. '--toc '
      \.. '--template easy_template.html '
      \.. '--mathjax '
      \.. '--citeproc '
      \.. '--metadata-file metadata.yaml'

let g:wiki_export = {
      \ 'args' : s:pandoc_args,
      \ 'from_format' : 'markdown',
      \ 'ext' : 'html',
      \ 'link_ext_replace': v:true,
      \ 'view' : v:true,
      \ 'output': 'build/',
      \}

With this settings I experience no issues. Is it possible that the requirement in the doc can simply be omitted?

[lervag]

Suppose you have the following code example? How I should adjust it regarding the doc?

…

With this settings I experience no issues. Is it possible that the requirement in the doc can simply be omitted?

Good question. Perhaps you are right. I'll look into it!

[lervag]

I think you are right. I've updated the docs. I think the second requirement is not relevant, so I removed it.