Ok I understand, it's really nice (the rendering on your site too). Thanks for your answer
Le ven. 17 juin 2022 à 16:05, Kaushal Modi <kaushal.m...@gmail.com> a écrit : > On Fri, Jun 17, 2022 at 8:50 AM Cletip Cletip <clement020...@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 > > ===== > ****** 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 = /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 = $(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 = info # Default: html pdf > #+end_src > ===== > > exports to > https://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: > > ===== > ***** 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 > ===== > > exports to https://scripter.co/offline-html5-validator/#using-pip-install > > 3. Sometimes I also use it for adding Notes to a section > > ===== > - Note :: While the =%.1f= format is handy for those who are used to > =printf()= syntax, note that Calc unlimited precision > numbers are converted to double floats before applying > =%.1f=. Whereas =f1= operates on Calc numbers without > conversion. > ===== > > exports to the Note in > https://scripter.co/field-formatters-in-org-table/#using-calc-f1-formatter >
