Pretext Plus Markdown

[Daniel Lim]

Hi everyone,

I'm new to pretext and found pretext.plus to be a very nice, low-threshold entry for authoring. In particular, I prefer markdown to XML, but I'm having trouble finding documentation on how markdown connects with various pretext features. For example, if I want to create a figure (with auto-numbering) and embed an image, what does this look like in markdown? Is there a web resource that provides guidance on this?

Thank you!

[David W. Farmer]

This is a topic for discussion, but my guess is that this is
not going to be possible in literal PreTeXt-style Markdown.

Images typically need a caption, alt text, and size specification.
That type of (meta)data is very cumbersome to do in a way that is
natural and intuitive to Markdown.

So, faced with the option of either make some non-intuitive
sort-of Markdowny way, which most users have to look up repeatedly,
vs. the perfectly good (and not too difficult to use) existing
PreTeXt syntax, my guess is that we will choose the second option.

I am just expressing my opinion about a topic currently under discussion.

Note that if you are using a good editor, if you just start typing

<fig

and then hit TAB, if automatically makes the opening and closing
figure tags, and inside it it automatically makes the caption tags.
So, you don't really have to type all those tags and angle brackets.

Regards,

David

ps to Oscar: maybe the shortdescription and image.source should
also automatically appear in a bare figure?

> --
> You received this message because you are subscribed to the Google Groups "PreTeXt support" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pretext-suppo...@googlegroups.com.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-support/702cba52-80a4-4835-adfc-676ea1c1df0en%40googlegroups.com.
>
>

[Oscar Levin]

We do have a way to embed images in pretext plus in all three syntax styles.  We just added this, and the documentation hasn't kept up.  I'll send you an example of how to do this first thing tomorrow.

Oscar.

To view this discussion visit https://groups.google.com/d/msgid/pretext-support/b47d8cd2-9238-13c-ea41-971b31fb57f0%40aimath.org.

[Daniel Lim]

Appreciate your prompt responses! I've been going down the XML path on pretext.plus and find the tab-completions to be very helpful. Also the github instructions on the pretext website were excellent in setting up the overall workflow - though I will keep all of this hidden from our authors. The bar, nevertheless, will be a bit high for our non-experienced authors, but I think it'll be worth their while. Thank you.

[Oscar Levin]

I've documented the process for adding static images in PreTeXt Plus, in all three syntax styles.  See https://docs.pretext.plus/how-to/images/.

Still lots of documentation missing, so please reach out when you run into the next hurdle.

[Daniel Lim]

Thanks Oscar!