Re: [BUG] ox-md image captions

2023-04-16 Thread Ihor Radchenko
Ihor Radchenko writes: > Indeed. > I tried to make this point more clear in the attached patch for Org manual. Applied, onto main. https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=62996300e -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at

Re: [BUG] ox-md image captions

2023-04-08 Thread Ihor Radchenko
Max Nikulin writes: > On 07/04/2023 22:29, Vladimir Alexiev wrote: >> It's not about the tooltip in HTML: >> figure captions are very important in scholarly publishing. > > I see and I do not like that Org exports caption as title (tooltip). On > the other hand neither original markdown nor

Re: [BUG] ox-md image captions

2023-04-08 Thread Ihor Radchenko
Vladimir Alexiev writes: > It's not about the tooltip in HTML: > figure captions are very important in scholarly publishing. I agree, but are you actually publishing scholar articles to MD? Caption are correctly handled in Latex and ODT publishing - the most common formats for scholary

Re: [BUG] ox-md image captions

2023-04-07 Thread Max Nikulin
On 07/04/2023 22:29, Vladimir Alexiev wrote: It's not about the tooltip in HTML: figure captions are very important in scholarly publishing. I see and I do not like that Org exports caption as title (tooltip). On the other hand neither original markdown nor GitHub flavored markdown have

Re: [BUG] ox-md image captions

2023-04-07 Thread Vladimir Alexiev
Hi Max! It's not about the tooltip in HTML: figure captions are very important in scholarly publishing.

Re: [BUG] ox-md image captions

2023-04-07 Thread Max Nikulin
On 05/04/2023 02:41, Ihor Radchenko wrote: IMHO, it would make more sense if Pandoc had a toggle to treat captions differently. As an alternative. printf '![Alt](file.jpg "title")\n' | pandoc -f org -t markdown_strict disables generation of . I think, it is unlikely that users with

Re: [BUG] ox-md image captions

2023-04-05 Thread Vladimir Alexiev
I posted a Pandoc request: https://github.com/jgm/pandoc/issues/8752 On Wed, Apr 5, 2023 at 2:04 PM Ihor Radchenko wrote: > Morgan Willcock writes: > > > If ox-md is trying to do the same thing as Markdown.pl then it doesn't > > really make sense to compare it to CommonMark. > > Most likely,

Re: [BUG] ox-md image captions

2023-04-05 Thread Ihor Radchenko
Max Nikulin writes: > My expectation is that Markdown > > ![Alt text](/path/to/img.jpg "Optional title") > > is exported to HTML > > > > If it is so then caption should not be exported as title and it is not > related to markdown extensions. Org caption should appear as text, it >

Re: [BUG] ox-md image captions

2023-04-05 Thread Max Nikulin
On 05/04/2023 20:05, Ihor Radchenko wrote: MD has nothing to do with how Pandoc's "implicit_figures" extension modifies MD->HTML export. The original MD spec only talks about image description and image title being exported to "alt" and "title" HTML attributes. My expectation is that Markdown

Re: [BUG] ox-md image captions

2023-04-05 Thread Ihor Radchenko
Max Nikulin writes: >> Upon further investigation, I have found that our base MD reference we >> follow in ox-md is defining image syntax as the following: >> >> ![Alt text](/path/to/img.jpg) >> >> ![Alt text](/path/to/img.jpg "Optional title") >> >>

Re: [BUG] ox-md image captions

2023-04-05 Thread Max Nikulin
On 04/04/2023 15:48, Ihor Radchenko wrote: Ihor Radchenko writes: I am inclined to change ![img](url "caption") to ![caption](url) for links without description (links with description do not obey caption in org export). Upon further investigation, I have found that our base MD reference we

Re: [BUG] ox-md image captions

2023-04-05 Thread Ihor Radchenko
Morgan Willcock writes: > If ox-md is trying to do the same thing as Markdown.pl then it doesn't > really make sense to compare it to CommonMark. Most likely, ox-md is following Markdown.pl simply because there was no better standard at the time ox-md was written. I now looked up a comparison

Re: [BUG] ox-md image captions

2023-04-05 Thread Morgan Willcock
Ihor Radchenko writes: > Please provide concrete examples where ox-md does not follow > specification. > > The title/caption issue herein does not qualify. > https://spec.commonmark.org/0.30/#images also defines > ![foo](/url "title") with "title" being the title, as we currently use > it in

Re: [BUG] ox-md image captions

2023-04-05 Thread Ihor Radchenko
Morgan Willcock writes: >> https://daringfireball.net/projects/markdown/syntax#img >> >> Therefore, Org mode is doing everything right within the scope of MD >> specification we follow. Pandoc does not. > > I don't think that Markdown has a single specification. Indeed. And the one in

Re: [BUG] ox-md image captions

2023-04-05 Thread Morgan Willcock
Ihor Radchenko writes: > Upon further investigation, I have found that our base MD reference we > follow in ox-md is defining image syntax as the following: > > ![Alt text](/path/to/img.jpg) > > ![Alt text](/path/to/img.jpg "Optional title") > >

Re: [BUG] ox-md image captions

2023-04-04 Thread Ihor Radchenko
Vladimir Alexiev writes: > Maybe an option? I do not mind. Patches welcome. See https://orgmode.org/worg/org-contribute.html > Saying "pandoc is in the wrong" doesn't do much to resolve the issue. Sure. But I did not see changing default Org's behaviour as justified in such scenario. >

Re: [BUG] ox-md image captions

2023-04-04 Thread Vladimir Alexiev
Maybe an option? Saying "pandoc is in the wrong" doesn't do much to resolve the issue. Despite my enormous love for orgmode, Pandoc is used a lot more widely for scholarly publishing and interactive websites. See Quarto and Manubot. On Tue, Apr 4, 2023, 11:46 Ihor Radchenko wrote: > Ihor

Re: [BUG] ox-md image captions

2023-04-04 Thread Ihor Radchenko
Ihor Radchenko writes: > I am inclined to change ![img](url "caption") to > ![caption](url) for links without description (links with description do > not obey caption in org export). > > Any objections? Upon further investigation, I have found that our base MD reference we follow in ox-md is

Re: [BUG] ox-md image captions

2023-02-27 Thread Ihor Radchenko
Vladimir Alexiev writes: > I have an image caption like this: > > #+label: fig:bsdd-graphql-voyager-refact-detail > #+caption: Refactored bSDD GraphQL Schema > [[./img/bsdd-graphql-voyager-refact-Classification-ClassificationProperty.png]] > > ox-md exports it like this: > >

[BUG] ox-md image captions

2023-02-27 Thread Vladimir Alexiev
I have an image caption like this: #+label: fig:bsdd-graphql-voyager-refact-detail #+caption: Refactored bSDD GraphQL Schema [[./img/bsdd-graphql-voyager-refact-Classification-ClassificationProperty.png]] ox-md exports it like this: