From: Adam Porter <adam@alphapapa.net>
To: Ihor Radchenko <yantar92@posteo.net>
Cc: emacs-orgmode@gnu.org
Subject: Re: [Worg] CSS improvements
Date: Tue, 26 Mar 2024 22:20:30 -0500 [thread overview]
Message-ID: <38e2ca8a-175b-4f74-aae5-39f6d605a6b8@alphapapa.net> (raw)
In-Reply-To: <87le659hgv.fsf@localhost>
On 3/26/24 09:48, Ihor Radchenko wrote:
> Adam Porter <adam@alphapapa.net> writes:
>
>>>> What is the purpose of centering text if not to make it stand out?
>>>
>>> To align text. I am not sure why anything more is necessary - it
>>> is certainly counter-intuitive for me that "center" means something more
>>> than just alignment.
>>
>> Again, what is the purpose of centering text? The answer, "To align
>> text," is tautological.
>
> I am very confused. Of course, it is tautological. "center" container is
> aiming to align the text. That's why it is named "center".
Yes, but why do we center text? That's what I'm asking.
>> Especially, on Worg, where the whole site serves as a kind of extended
>> user manual, the purpose of centering text is, what, if not to make it
>> stand out?
>
> To align text... I really do not understand why one would _anticipate_
> that #+begin_center is doing anything other than center alignment.
Of course, I'm not suggesting that this be the default for Org's HTML
export CSS. I'm suggesting that, on Worg, since the .org-center class
hasn't even been styled, we might as well use it for this purpose--to
make text stand out--since that's generally the purpose of centering
text anyway.
>>> If you need extra highlighting, we may introduce a dedicated style and
>>> apply it via special block.
>>
>> Why, when we already have #+begin_center? Currently it's not even used
>> at all. This would not change anything that already exists; it would
>> make something that already exists useful.
>
> It would break expectations.
> It will also differ from ox-html output with the default css style
> `org-html-style-default':
Worg already differs significantly from the ox-html default styles, so
why not in this way also?
>>> Mostly because it is unexpected, as I described above.
>>> I'd prefer to stick closer to the semantics and just apply alignment to
>>> center blocks.
>>
>> *shrug* Worg has existed for years without even doing anything with
>> #+begin_center blocks--not even centering them. I propose that we make
>> it useful and serve its natural purpose, rather than adding a special
>> new block that most users won't even know about (having to find it in
>> the voluminous Worg content isn't likely to happen for most users).
>
> I do not see how, without documentation, one would expect that
> #+begin_center can be used for highlighting and not for text alignment.
> From my point of view, it is worse than a special block - not only this
> ad-hoc convention is not documented; it will also break expectations
> about what #+begin_center does.
Again, this is just for Worg, and centering hasn't even had any effect
for years. There seem to be no expectations to break.
> What about:
>
> 1. Introducing a new special block for highlighting
> 2. Documenting it in https://orgmode.org/worg/worg-editing.html
I think that such a new special block would likely go unused in favor of
default blocks. The cognitive load of learning how to contribute to
Worg is already pretty high. We see this same pattern in contributions
to Emacs and Org themselves: code is often unidiomatic because it takes
a long time to learn all the idioms, and it's often not obvious what the
idiomatic way to do something is. The same is true for contributions to
documentation. Worg is no different.
So I would still suggest that, on Worg, we use my suggested styling on
#+begin_center blocks. This would make them useful and fulfill their
natural purpose.
I understand your general objection--and I wouldn't suggest it for Org's
default export CSS--but I think that, for Worg specifically, it needn't
apply.
Since Worg is updated with relatively low frequency, anyway, perhaps
this suggestion could be tried as an experiment. If problems are found
with it, then the extra styling, beyond merely centering the text, could
be reverted. Nothing is permanent here; we've probably spilled more
virtual ink on this topic than would be affected by the change.
Anyway, if this idea is vetoed, it would still be good to have some way
to make text stand out in a standard way, similar to various HTML
documentation styles in other projects (to avoid resorting to inline
HTML). It seems like a missing feature on Worg.
And the other changes in the patch would be good to have, regardless.
Thanks,
Adam
next prev parent reply other threads:[~2024-03-27 3:21 UTC|newest]
Thread overview: 21+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-03-23 14:35 [Worg] CSS improvements Adam Porter
2024-03-23 14:49 ` Ihor Radchenko
2024-03-24 6:14 ` Adam Porter
2024-03-24 8:56 ` Ihor Radchenko
2024-03-24 9:28 ` Dr. Arne Babenhauserheide
2024-03-25 14:09 ` Adam Porter
2024-03-26 14:48 ` Ihor Radchenko
2024-03-27 3:20 ` Adam Porter [this message]
2024-03-28 11:44 ` Ihor Radchenko
2024-03-28 12:41 ` Adam Porter
2024-03-28 13:18 ` Ihor Radchenko
2024-03-28 17:53 ` Adam Porter
2024-03-29 9:48 ` Ihor Radchenko
2024-03-29 22:38 ` How to organize tasks about Worg within Worg documents (was: Re: [Worg] CSS improvements) Adam Porter
2024-03-29 23:30 ` Thomas S. Dye
2024-03-30 2:27 ` How to organize tasks about Worg within Worg documents Adam Porter
2024-03-30 10:47 ` How to organize tasks about Worg within Worg documents (was: Re: [Worg] CSS improvements) Ihor Radchenko
2024-03-31 15:43 ` How to organize tasks about Worg within Worg documents Adam Porter
2024-04-01 11:34 ` Ihor Radchenko
2024-04-01 18:02 ` Adam Porter
2024-03-26 22:12 ` [Worg] CSS improvements David Rogers
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=38e2ca8a-175b-4f74-aae5-39f6d605a6b8@alphapapa.net \
--to=adam@alphapapa.net \
--cc=emacs-orgmode@gnu.org \
--cc=yantar92@posteo.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).