From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 0BSCJW+hrGLSEQEAbAwnHQ (envelope-from ) for ; Fri, 17 Jun 2022 17:44:47 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id IPx8JW+hrGJxYAAA9RJhRA (envelope-from ) for ; Fri, 17 Jun 2022 17:44:47 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 22CD8306CF for ; Fri, 17 Jun 2022 17:44:47 +0200 (CEST) Received: from localhost ([::1]:59624 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o2E9N-0008C8-R9 for larch@yhetil.org; Fri, 17 Jun 2022 11:44:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54012) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o2E7x-0007qs-1V for emacs-orgmode@gnu.org; Fri, 17 Jun 2022 11:43:17 -0400 Received: from mail-ed1-x531.google.com ([2a00:1450:4864:20::531]:47038) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o2E7r-00072c-1j for emacs-orgmode@gnu.org; Fri, 17 Jun 2022 11:43:16 -0400 Received: by mail-ed1-x531.google.com with SMTP id z7so6676769edm.13 for ; Fri, 17 Jun 2022 08:43:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=eBYh3wTscFn5+MQ/QCdwJU6wRHR1fCsUhRNeoVVq0Tk=; b=fZIDYXKHToTSVPFK+jeFTeHvOPOTWXy36JlhmrPWzvcUF1fk/nkubjhQSAywCa573+ YqpWx1Xwe7Hl64lYT7kf3aNTJ47x/niGwg/1Gr/P9XxVtDu+I7RF5BFqB0fhR/f64g5X u5WInflvII2zNB8SvXMwl0hcYTidPR8Jn/LKSPXHOhFfr10FXiOGCkFWngGt/GLVHNav R/Nm3PGPBC+4PwdvdRGJ42YxzaUuRNFMbt/5NkgZD+X70UhN60CMM/vy8rK59XmwzaLP 38ow8n6cTXcwbmOOJaDOB7sDgJIwVm8CtimVcADIoLqFG1aGhlN/1NMMldsxKmaJ8Wv/ HtUw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=eBYh3wTscFn5+MQ/QCdwJU6wRHR1fCsUhRNeoVVq0Tk=; b=7scWKsO9s1qhPUmC3AUNHhsaecw8PLfOcH6Kq/kEpM9PiA93/01liYh/1Bgzl3+cQ8 kB9adpvU57tlQWmh60MuSFfCn6ei/1qke9f2gCW1drAKrIRvTMuvb2qSwgCmpFNpY6vr XQllTev/z8cvlbQ4+aJyg/biA3i8AS/OkKAJC0PD6QOXH8XUbJC5m6pQC272M2xT1dqy lrL5AepgAEjL0kUHqbtxThIS12Qb9ARbj6+XsKBAjuTLRXcgEPx5PRDdNyg8zR5p4ZIG Iu3BH3+GNrugObAikAObfM0gn9DCHw3carDHiHI4nI5xYCeSYqh0NwxffjJ3uFAL7fyB jGzg== X-Gm-Message-State: AJIora9UKpq2Xu7QB3KD0591pZUxqY9I84KV5f8HYdC9FVHyjfmLFS51 lUT51PusCzLigTrneoMCi5e2T4wi2Z9PianQobw= X-Google-Smtp-Source: AGRyM1t7Z+vOuU0pcsYSXzpTG1mRI9iPHvzeggrRL+RN+FHzwl+GwqB42BXwbRG1H5xah4vBwVHZWTidpLhMxWuD4XQ= X-Received: by 2002:a05:6402:249e:b0:42d:bb88:865b with SMTP id q30-20020a056402249e00b0042dbb88865bmr12915662eda.141.1655480589287; Fri, 17 Jun 2022 08:43:09 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Cletip Cletip Date: Fri, 17 Jun 2022 17:42:58 +0200 Message-ID: Subject: Re: Utility of description lists To: Kaushal Modi Cc: Org Mode List Content-Type: multipart/alternative; boundary="00000000000075068b05e1a69c16" Received-SPF: pass client-ip=2a00:1450:4864:20::531; envelope-from=clement020302@gmail.com; helo=mail-ed1-x531.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, T_SCC_BODY_TEXT_LINE=-0.01, T_SPF_TEMPERROR=0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1655480687; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=eBYh3wTscFn5+MQ/QCdwJU6wRHR1fCsUhRNeoVVq0Tk=; b=hWjBIAZOKIZdjqQ8DawWZbZ6Po7AhlRNnbWkJnNjKkF1P+oJ2Kk4JRfhQPFcTmMpveLm4N qpOl2iJ6amM/xxCn3xCNmAsHKWrak7Sj8jOGmJerWJMpKaXcaZJPGwt2inyWZ6Po3c7dI/ fKPAeKJvGDA/WzGCXjdIjf9zsQWaQVhFbQ3kHIAzxQBp7bhkoUaFKYvc7GD1wV9abdDIsL 6yJLigYB5ekQ+j6b1qdpplkg5FySCzuUkj8TUQQlyqsUMvxqfXxEwZVZ7HDkHbFqgd3ows SO0f/4NYtSGjVU2/wnr9NZUWVhmeN4IVuWcKmQ6pfWnNKzNKMNmJFy1K8BYFVQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1655480687; a=rsa-sha256; cv=none; b=GjOKmdpd/pd1AASoRW7/qDhFCW1hVoNQyFl57Qo2S7hxedoGEzd7yFEPIgtJxQW9djRmYC unZK6537uWQf48aadMDoK4BI6NCOA5Zlk/wJUGa0iqiBAs5A2U2aHPdWPRWqelx+jUUzru G1FVuCZ4+Icl5REF5CHPN3T8UWYZzZLOxFea6kvOoUBW6fKdJa+S3BJBEHpM+pryJ+TJYO HtPKdHtv6ym/rwMhx2QRIUycUNY9q9NO6xfx+jqc7pqHzNmGrX/bcm3X+z/AYJfMtMl6OK fa7E6iBgylRn3M8/dl4ctM0KT9u5W+B9TnUO+9eWDyuvvDnvcIVVizxMcE0Z2Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=fZIDYXKH; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.99 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=fZIDYXKH; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 22CD8306CF X-Spam-Score: -2.99 X-Migadu-Scanner: scn1.migadu.com X-TUID: R8jOy0RtgU74 --00000000000075068b05e1a69c16 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Ok I understand, it's really nice (the rendering on your site too). Thanks for your answer Le ven. 17 juin 2022 =C3=A0 16:05, Kaushal Modi a =C3=A9crit : > On Fri, Jun 17, 2022 at 8:50 AM Cletip Cletip > wrote: > > > Final question : why do you use description lists and not another ? > > I use description lists *heavily*. > > 1. For description lists of course.. where the "description" part is a > bit verbose and plain lists don't look at that elegant > > For example, this in Org > > =3D=3D=3D=3D=3D > ****** Customizing ~local.mk~ (Optional) > Here are few variables that you might like to change in the ~local.mk~: > - ~prefix~ :: Org installation directory > #+begin_src makefile > prefix =3D /dir/where/you/want/to/install/org # Default: /usr/share > #+end_src > The ~.el~ files will go to ~$(prefix)/emacs/site-lisp/org~ by > default. If you'd like to change that, change the ~lispdir~ > variable too. > - ~infodir~ :: Org Info installation directory. I like to keep the > Info file for development version of Org in a separate directory. > #+begin_src makefile > infodir =3D $(prefix)/org/info # Default: $(prefix)/info > #+end_src > - ~ORG_MAKE_DOC~ :: Types of Org documentation you'd like to build by > default. Setting below generates only the Org Info manual. > #+begin_src makefile > ORG_MAKE_DOC =3D info # Default: html pdf > #+end_src > =3D=3D=3D=3D=3D > > exports to > https://scripter.co/building-org-development-version/#customizing-local-d= ot-mk--optional > > 2. Where something would belong in a sub-heading, but not quite > exactly? I can only describe that using one of my examples: > > =3D=3D=3D=3D=3D > ***** Using ~pip install~ > If you do not want to manually download the ~.jar~, there's a Python > wrapper available to do the same for you: > [[https://github.com/svenkreiss/html5validator][html5validator]]. > - Install :: > #+begin_src shell > pip install --user html5validator > #+end_src > - Run :: > #+begin_src shell > html5validator --root public/ > #+end_src > It seems like this Python wrapper implicitly passes ~--skip-non-html > =3D=3D=3D=3D=3D > > exports to https://scripter.co/offline-html5-validator/#using-pip-install > > 3. Sometimes I also use it for adding Notes to a section > > =3D=3D=3D=3D=3D > - Note :: While the =3D%.1f=3D format is handy for those who are used to > =3Dprintf()=3D syntax, note that Calc unlimited precision > numbers are converted to double floats before applying > =3D%.1f=3D. Whereas =3Df1=3D operates on Calc numbers without > conversion. > =3D=3D=3D=3D=3D > > exports to the Note in > https://scripter.co/field-formatters-in-org-table/#using-calc-f1-formatte= r > --00000000000075068b05e1a69c16 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Ok I understand, it's really nice (the rendering on yo= ur site too).=C2=A0
Thanks for your answer

Le=C2=A0ven. 17 juin 20= 22 =C3=A0=C2=A016:05, Kaushal Modi <kaushal.modi@gmail.com> a =C3=A9crit=C2=A0:
On Fri, Jun 17, 2022 at 8:50 AM Cl= etip Cletip <clement020302@gmail.com> wrote:

> Final question : why do you use description lists and not another ?
I use description lists *heavily*.

1. For description lists of course.. where the "description" part= is a
bit verbose and plain lists don't look at that elegant

For example, this in Org

=3D=3D=3D=3D=3D
****** Customizing ~local.mk~ (Optional)
Here are few variables that you might like to change in the ~local.mk~:
- ~prefix~ :: Org installation directory
=C2=A0 #+begin_src makefile
=C2=A0 prefix =3D /dir/where/you/want/to/install/org # Default: /usr/share<= br> =C2=A0 #+end_src
=C2=A0 The ~.el~ files will go to ~$(prefix)/emacs/site-lisp/org~ by
=C2=A0 default. If you'd like to change that, change the ~lispdir~
=C2=A0 variable too.
- ~infodir~ :: Org Info installation directory. I like to keep the
=C2=A0 Info file for development version of Org in a separate directory. =C2=A0 #+begin_src makefile
=C2=A0 infodir =3D $(prefix)/org/info # Default: $(prefix)/info
=C2=A0 #+end_src
- ~ORG_MAKE_DOC~ :: Types of Org documentation you'd like to build by =C2=A0 default.=C2=A0 Setting below generates only the Org Info manual.
=C2=A0 #+begin_src makefile
=C2=A0 ORG_MAKE_DOC =3D info # Default: html pdf
=C2=A0 #+end_src
=3D=3D=3D=3D=3D

exports to h= ttps://scripter.co/building-org-development-version/#customizing-local-dot-= mk--optional

2. Where something would belong in a sub-heading, but not quite
exactly? I can only describe that using one of my examples:

=3D=3D=3D=3D=3D
***** Using ~pip install~
If you do not want to manually download the ~.jar~, there's a Python wrapper available to do the same for you:
[[https://github.com/svenkreiss/h= tml5validator][html5validator]].
- Install ::
=C2=A0 #+begin_src shell
=C2=A0 pip install --user html5validator
=C2=A0 #+end_src
- Run ::
=C2=A0 #+begin_src shell
=C2=A0 html5validator --root public/
=C2=A0 #+end_src
=C2=A0 It seems like this Python wrapper implicitly passes ~--skip-non-html=
=3D=3D=3D=3D=3D

exports to https://scripter.co/offline= -html5-validator/#using-pip-install

3. Sometimes I also use it for adding Notes to a section

=3D=3D=3D=3D=3D
- Note :: While the =3D%.1f=3D format is handy for those who are used to =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =3Dprintf()=3D syntax, note that Calc un= limited precision
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 numbers are converted to double floats b= efore applying
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =3D%.1f=3D. Whereas =3Df1=3D operates on= Calc numbers without
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 conversion.
=3D=3D=3D=3D=3D

exports to the Note in
https://scripter.co/field-= formatters-in-org-table/#using-calc-f1-formatter
--00000000000075068b05e1a69c16--