V4 proposed aligned paragraph tokens

[dbolack-ab]

Description

This implements the suggested syntax for V4 paragraph text alignment tokens from #2879

Related Issues or Discussions

#2879

QA Instructions, Screenshots, Recordings

• insert :- in front of a paragraph. It should align left. You should see a class of mdParagraphJustifyLeft on the paragraph tag
• insert -: in front of a paragraph. It should align right. You should see a class of mdParagraphJustifyRight on the paragraph tag
• insert :-: in front of a paragraph. It should align center. You should see a class of mdParagraphJustifyCenter on the paragraph tag

Reviewer Checklist

[calculuschild]

As long as these syntaxes don't conflict with existing documents, we should be able to just add them to V3. I think this one should be pretty safe.

[5e-Cleric]

i want to test this

[calculuschild]

Three thoughts:

First, the table syntax this borrows from allows any number of hyphens in the construction. Is it valuable to allow that here as well? For example:

"I am inevitable."
--------------: Michael Scott

Second, is it valuable to allow this syntax on the first line of a paragraph
by itself, to act as an optional familiar appearance more like the Table syntax?

This is a normal paragraph.

---------------------------:
This paragraph is going
to be right-aligned.

:--------------------------:
This paragraph is going
to be centered

This paragraph is unmarked,
and so defaults back to
left-aligned

Third, we should aim to have Markdown convert to pure HTML, so they do not rely upon CSS to function. In this case, we have the align HTML property we can use, the same way it is handled in Tables.

All this said, please don't start writing code for the first two unless we get a consensus, so you don't have to undo it later.

[ericscheid]

This paragraph is unmarked,
and so defaults back to
left-aligned

Technically, since that ¶ is unmarked it should default back to the default .. which in many themes might be left-aligned, but could also conceivably be full-aligned in some themes.

I suggest

:----------------
This para is marked to be 
explictly left aligned

This paragraph is unmarked,
and so is the default for the
current theme

[dbolack-ab]

Three thoughts:

First, the table syntax this borrows from allows any number of hyphens in the construction. Is it valuable to allow that here as well? For example:

I'm dubious, but I don't see any reason that there needs to be a fixed number unless we want to ascribe value based on the number of hyphens ( example - 1: use HTML Align 2: use class )

Second, is it valuable to allow this syntax on the first line of a paragraph by itself, to act as an optional familiar appearance more like the Table syntax?

I think it is better suited to being a lead-in paragraph-marker.

Third, we should aim to have Markdown convert to pure HTML, so they do not rely upon CSS to function. In this case, we have the align HTML property we can use, the same way it is handled in Tables.

I chose to use a class instead of the property so that users could overload the feature with additional styling. If we do it with the property, users lose that option and must {{}} it as-well.

[5e-Cleric]

I chose to use a class instead of the property so that users could overload the feature with additional styling. If we do it with the property, users lose that option and must {{}} it as-well.

To be fair, centered text is something common to most if not all themes, i'm not sure of the value of the overriding possibility. Not against it.

[dbolack-ab]

I chose to use a class instead of the property so that users could overload the feature with additional styling. If we do it with the property, users lose that option and must {{}} it as-well.

To be fair, centered text is something common to most if not all themes, i'm not sure of the value of the overriding possibility. Not against it.

I'm guessing I explained that poorly? I dunno. The notion that a brew or theme could choose to override and extend what :-: did struck me as useful.