Dear @larsbarring

Thanks a lot for this careful investigation. I certainly agree that these defects should be fixed, and also that the list of figures would more useful if it contained the fig titles too. Perhaps like you, I find the asciidoc syntax rather opaque when it gets beyond obvious text formatting.

Best wishes

Jonathan

I have prepared PR #565 that I think corrects all of these defects. I believe that all of these changes are purely editorial and do not change the meaning or interpretation of the text. Here is the HTML (gzipped) with the changes:
cf-conventions.html.gz

@larsbarring or @JonathanGregory - could you have a glance over this, perhaps?

Many thanks,
David

@davidhassell if that 1px image is no longer necessary, usual git practice would be to delete it and retrieve it from the git history if it ever needs to be used again.

Hi @DocOtak - sure thing. It has been deleted. I thought the comment on the procedure was potentially useful to retain but no one's going to find it there, so I'll delete that too :)

Dear @davidhassell

Thanks for this great effort! In looking through the PR, I've noted three places where perhaps we could have just <<NUG>>. I also made comments, and then resolved them, because of what looked like double refs to the tables in Sect 9, but it's correct in the HTML, so you must have the right incantation there.

Since you're on a roll, please could you also correct the first two entries in the Table of Figures, which currently appear like this?

7.1. figure 1
7.2. figure 2

Best wishes

Jonathan

@davidhassell I meant the file of the image, the comment is useful and probably should stay so we know what to do when a long table title happens.

I meant the file of the image, the comment is useful and probably should stay so we know what to do when a long table title happens.

Oh, I see :) I'll delete the file and re-instate the comment.

Dear Jonathan,

I have fixed up the chapter 7 figure references (25f355e).

Ideally all of the figures in the list of contents would have descriptive titles (like the tables), rather than just (e.g.) "Figure 8.1". This could be done but, as far as can ascertain, we'd have to hard-wire the figure numbers when used in references in the main body of the text (so that the reference rendered as "Figure 8.1", as opposed to "<Long description of figure>". This is probably not a great problem, as that's have we do example and table references, but I suppose it's a shame to break the auto-numbering we enjoy with figures.

New rendering: cf-conventions.html.gz

@DocOtak

Oh, I see :) I'll delete the file and re-instate the comment.

I've decided to keep the image file after all - if we want to do this technique in the future, we're going to not want the bother of creating a new file. I've updated the comment to say that there's a file that can be used: 11d5deb

Thanks, David. It's a shame that asciidoc isn't as clever as $\LaTeX$.

I asked a question about that over at the asciidoc support forum.

See here for response https://asciidoctor.zulipchat.com/#narrow/channel/279642-users/topic/Figure.20autonumbering.20within.20autonumbered.20Table.20text.20.3F/near/482438967

Thanks for finding the answer, Lars. We must try to remember about that, since this issue will be closed. If no-one objects to any of these defects being fixed, the PR will be merged next Wednesday 4th, just in time for David to build CF 1.12.