emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Karl Voit <devnull@Karl-Voit.at>
To: emacs-orgmode@gnu.org
Subject: "Orgdown", the new name for the syntax of Org-mode
Date: Sun, 28 Nov 2021 20:46:17 +0100	[thread overview]
Message-ID: <2021-11-28T20-44-37@devnull.Karl-Voit.at> (raw)

Hi Org-mode community,

At this year's EmascsConf, I had a 12 minute video where I explain why
we do need a different name for the syntax of Org-mode in contrast to
the Elisp implementation of GNU/Emacs Org-mode.

I would like you to read my rationale and motivate you to use the term
"Orgdown" for the syntax and "Orgdown1" for the first (very basic)
level of Orgdown syntax elements.

- The EmacsConf21 talk: https://emacsconf.org/2021/talks/org-outside
- Orgdown site: https://gitlab.com/publicvoit/orgdown (please contribute!)
- My motivation article: https://karl-voit.at/2021/11/27/orgdown/
  - This is the longer version of my 12 minute EmacsConf21 video.
- My personal copy of the video: https://tube.graz.social/w/bgJVfjPLQAoJwLJQZoo3Hu


Just as a sneak preview (not as a replacement for my motivation article):

Orgdown is and will be defined in a set of levels, starting with very
basic Orgdown1 (or OD1 or O↓1 or ⧬1 - depending on your coolness
factor of choice :-) )

- OD1 → https://gitlab.com/publicvoit/orgdown/-/blob/master/doc/Orgdown-Levels.org
- OD2 → will be defined in future
- OD3 → will be defined in future
- ...
- OD∞ = Org-mode (by definition)

Any OD-level needs to be compatible with Org-mode as implemented in
Elisp for GNU/Emacs Org-mode according to https://orgmode.org. Any ODx
is a sub-set of the syntax elements of ODy (with y>x).

With introducing a new term specific for the syntax, we do get the
benefit of getting a better way to handle Org-mode support in
3rd-party tools such as listed on
https://gitlab.com/publicvoit/orgdown/-/blob/master/doc/Tool-Support.org
(please extend!).

Having a well-defined sub-set of Org-mode, I also do think that formal
definitions of the Org-mode syntax will be easier to develop, starting
with the very simple OD1 level.

It would be awesome if we start referring to syntax support in
3rd-party tools with the corresponding OD levels.

I want to emphasize that the goal of Orgdown is NOT and will never be
something that is an alternative to our golden standard Org-mode. We
will try hard not to get into the Markdown situation where you need to
know the exact flavor of the markup in order to produce text.

So far, the response was great at the conference and I do hope that
this idea will get a life of its own, developing the standard further,
bringing this magnificent lightweight markup to the digital world.
This also eases some pain for users of GNU/Emacs when it comes to
exchanging text-based data.

Thanks for your support here!


-- 
Personal Information Management > http://Karl-Voit.at/tags/pim/
Emacs-related > http://Karl-Voit.at/tags/emacs/



             reply	other threads:[~2021-11-28 19:47 UTC|newest]

Thread overview: 39+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-11-28 19:46 Karl Voit [this message]
2021-11-28 21:34 ` Jean-Christophe Helary
2021-11-28 21:39   ` Bruce D'Arcus
2021-11-28 21:50     ` Tom Gillespie
2021-11-28 22:25 ` Juan Manuel Macías
2021-11-28 22:57   ` Tom Gillespie
2021-11-28 23:16     ` Joost Kremers
2021-11-29  1:36       ` George Mauer
2021-11-29  3:25       ` Juan Manuel Macías
2021-11-29  7:13         ` Dr. Arne Babenhauserheide
2021-11-28 23:24     ` Jean-Christophe Helary
2021-11-29  3:25       ` Devin Prater
2021-12-26 14:54       ` Jean-Christophe Helary
2021-11-29  5:41   ` Marcin Borkowski
2021-11-29 12:18     ` Juan Manuel Macías
2021-11-29 12:36       ` Marcin Borkowski
2021-11-28 22:42 ` Tim Cross
2021-11-29 13:19   ` Karl Voit
2021-11-29 15:12     ` Matt Price
2021-11-29 18:27     ` M. ‘quintus’ Gülker
2021-11-30  7:39       ` Marcin Borkowski
2021-11-30 20:44       ` Orgdown: negative feedback & attempt of a root-cause analysis (was: "Orgdown", the new name for the syntax of Org-mode) Karl Voit
2021-11-30 22:28         ` Dr. Arne Babenhauserheide
2021-11-30 22:50         ` Eduardo Ochs
2021-12-01  0:41         ` Tom Gillespie
2021-12-01  1:12           ` Tim Cross
2021-12-01  3:28           ` Orgdown: negative feedback & attempt of a root-cause analysis Juan Manuel Macías
2021-12-01 21:17         ` Orgdown: negative feedback & attempt of a root-cause analysis (was: "Orgdown", the new name for the syntax of Org-mode) M. ‘quintus’ Gülker
2021-12-02  6:50           ` Orgdown: negative feedback & attempt of a root-cause analysis Eric S Fraga
2021-12-01 23:43         ` Karl Voit
2021-12-02  1:44           ` Tim Cross
2021-12-02  2:12           ` George Mauer
2021-12-02  8:07           ` Greg Minshall
2021-11-29  2:22 ` "Orgdown", the new name for the syntax of Org-mode Jim Porter
2021-11-29  2:33   ` Michael Ashton
2021-11-29 12:38     ` Max Nikulin
2021-11-29 12:58     ` Christophe Schockaert
2021-11-30 23:50 ` Samuel Wales
2021-11-30 23:56   ` Samuel Wales

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=2021-11-28T20-44-37@devnull.Karl-Voit.at \
    --to=devnull@karl-voit.at \
    --cc=emacs-orgmode@gnu.org \
    --cc=news2042@Karl-Voit.at \
    --subject='Re: "Orgdown", the new name for the syntax of Org-mode' \
    /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

Code repositories for project(s) associated with this 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).