bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Dmitry Alexandrov]

[-- Attachment #1: Type: text/plain, Size: 756 bytes --]

Dear maintainers,

with the latest Emacs from git master, exporting #+begin_right block
neither to HTML, nor to ODT (didn’t test other options) does not work
as expected, while this should be pretty possible with both.

With HTML, as far as I can see, the problem is in that, so a CSS class
is named ‘org-right’:

--8<---------------cut here---------------start------------->8---
  .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
--8<---------------cut here---------------end--------------->8---

while in the HTML it is referenced as just ‘right’:

--8<---------------cut here---------------start------------->8---
<div class="right">
--8<---------------cut here---------------end--------------->8---

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 487 bytes --]

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Nicolas Goaziou]

Hello,

Dmitry Alexandrov <321942@gmail.com> writes:

> with the latest Emacs from git master, exporting #+begin_right block
> neither to HTML, nor to ODT (didn’t test other options) does not work
> as expected, while this should be pretty possible with both.
>
> With HTML, as far as I can see, the problem is in that, so a CSS class
> is named ‘org-right’:
>
>   .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
>
>
> while in the HTML it is referenced as just ‘right’:
>
> <div class="right">

".org-right" is an internal CSS class for table alignment.

OTOH, "#+begin_right" starts a special block that, as expected, create
a "right" div.

So, there is no issue here. You can either define "right" CSS, or
(untested), try "#+begin_org-right".

Regards,

-- 
Nicolas Goaziou                                                0x80A93738

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Dmitry Alexandrov]

[-- Attachment #1: Type: text/plain, Size: 2281 bytes --]

Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
> Dmitry Alexandrov <321942@gmail.com> writes:
>> with the latest Emacs from git master, exporting #+begin_right block
>> neither to HTML, nor to ODT (didn’t test other options) does not work
>> as expected, while this should be pretty possible with both.
>>
>> With HTML, as far as I can see, the problem is in that, so a CSS class
>> is named ‘org-right’:
>>
>>   .org-right  { margin-left: auto; margin-right: 0px;  text-align: right; }
>>
>>
>> while in the HTML it is referenced as just ‘right’:
>>
>> <div class="right">
>
> ".org-right" is an internal CSS class for table alignment.
>
> OTOH, "#+begin_right" starts a special block that, as expected, create
> a "right" div.
>
> So, there is no issue here. You can either define "right" CSS, or
> (untested), try "#+begin_org-right".

Thank you for a response, #+begin_org-right block indeed works like a charm.

Now, I am not sure, whether am I supposed to use #+begin_org-center blocks instead of #+begin_center too.

In fact, given that #+begin_center creates a .org-center div block, that is centred by default CSS (and stylesheets of other formats), I found your answer absolutely surprising.

I would be probably not alone on this feeling; see, for instance, Fabrice Niessen’s Org mode syntax reference card [0], where (as far as I got it) #+begin_right is presented as alignment tag for paragraphs rather than tables:

--8<---------------cut here---------------start------------->8---
Centered text

#+begin_left
This text is \\
aligned to the left!
#+end_left

#+begin_center
This text is \\
centered!
#+end_center

#+begin_right
This text is \\
aligned to the right!
#+end_right
--8<---------------cut here---------------end--------------->8---

In a part for centring it is in accordance to (info "(org) Paragraphs"), which says:

--8<---------------cut here---------------start------------->8---
   If you would like to center some text, do it like this:
     #+BEGIN_CENTER
     Everything should be made as simple as possible, \\
     but not any simpler
     #+END_CENTER
--8<---------------cut here---------------end--------------->8---

[0] https://github.com/fniessen/refcard-org-mode

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 487 bytes --]

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Nicolas Goaziou]

Dmitry Alexandrov <321942@gmail.com> writes:

> Now, I am not sure, whether am I supposed to use #+begin_org-center
> blocks instead of #+begin_center too.

The latter. As I explained, ".org-center" is an internal style.

> In fact, given that #+begin_center creates a .org-center div block,
> that is centred by default CSS (and stylesheets of other formats),
> I found your answer absolutely surprising.

"Center" blocks are defined in the manual, along with their syntax.
There is nothing surprising.

Moreover, there is no such thing as a "Right" block. Or, more precisely,
this falls into the special block category, which is handled differently
in each export back-end.

> I would be probably not alone on this feeling; see, for instance,
> Fabrice Niessen’s Org mode syntax reference card [0], where (as far as
> I got it) #+begin_right is presented as alignment tag for paragraphs
> rather than tables:

This reference card is not an official reference card.

In any case, let me insist again on the following point: you can use
"#+begin_right" in HTML to your heart's content if you define the
appropriate CSS property.

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Dmitry Alexandrov]

[-- Attachment #1: Type: text/plain, Size: 2077 bytes --]

Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
> Dmitry Alexandrov <321942@gmail.com> writes:
>
>> Now, I am not sure, whether am I supposed to use #+begin_org-center
>> blocks instead of #+begin_center too.
>
> The latter. As I explained, ".org-center" is an internal style.
>
>> In fact, given that #+begin_center creates a .org-center div block,
>> that is centred by default CSS (and stylesheets of other formats),
>> I found your answer absolutely surprising.
>
> "Center" blocks are defined in the manual, along with their syntax.

Thank you, I will.

> There is nothing surprising.
>
> Moreover, there is no such thing as a "Right" block. Or, more precisely,
> this falls into the special block category, which is handled differently
> in each export back-end.
>
>> I would be probably not alone on this feeling; see, for instance,
>> Fabrice Niessen’s Org mode syntax reference card [0], where (as far as
>> I got it) #+begin_right is presented as alignment tag for paragraphs
>> rather than tables:
>
> This reference card is not an official reference card.

Yes, I fully realize that.

Just another unofficial reference card [0], by Caio Rordrigues at that time, that again states that:

--8<---------------cut here---------------start------------->8---
#+begin_right
This text is
aligned to the right!
#+end_right
--8<---------------cut here---------------end--------------->8---

These persons are probably consider themselves highly familiar with Org, yet they have been mistaken.  What to say about novices!  So the absence of this feature is indeed highly unobvious.  That’s the only point I am trying to make.

[0] https://github.com/caiorss/Emacs-Elisp-Programming/blob/master/Org-Mode.org#text-position

> In any case, let me insist again on the following point: you can use
> "#+begin_right" in HTML to your heart's content if you define the
> appropriate CSS property.

If there is no plan to make into default as with centring, a warning might be very apt.

Thank you again for your work on the Org.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 487 bytes --]

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Nicolas Goaziou]

Dmitry Alexandrov <321942@gmail.com> writes:

> Just another unofficial reference card [0], by Caio Rordrigues at that time, that again states that:
>
> #+begin_right This text is aligned to the right! #+end_right
>
> These persons are probably consider themselves highly familiar with
> Org, yet they have been mistaken. What to say about novices! So the
> absence of this feature is indeed highly unobvious. That’s the only
> point I am trying to make.
>
> [0] https://github.com/caiorss/Emacs-Elisp-Programming/blob/master/Org-Mode.org#text-position
>
>> In any case, let me insist again on the following point: you can use
>> "#+begin_right" in HTML to your heart's content if you define the
>> appropriate CSS property.
>
> If there is no plan to make into default as with centring, a warning
> might be very apt.

The issue here is that "#+begin_right" is perfectly valid syntax, and so
is, e.g., "#+begin_foobar". Their behaviour is perfectly defined. For
example, in HTML export the will create <div class="right"> and <div
class="foobar"> if you have a nil `org-html-html5-fancy', or <right> and
<foobar> otherwise.

Therefore, a warning is not an option here. Only a careful read of the
manual can help clearing the misconception about what is included in Org
and what can be extended.

Now, it's true that at some point, Org defined a ".right" CSS rule
instead of ".org-right", so "#+begin_right" could work out of the box, but
only in the HTML export. However, this was not the intent.

For the record any "#+begin_XXX" construct that has no particular
meaning in Org may be treated specially by export back-ends (or ignored
altogether). It is often a way to write a specific environment.

bug#31273: 27.0.50; org: #+begin_right block is not exported correctly

[Nicolas Goaziou]

I'm closing this report, which is not considered as a bug.

-- 
Nicolas Goaziou                                                0x80A93738