From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christian Moe Subject: Re: seeking advice on use of drawers vs blocks Date: Tue, 05 Apr 2016 09:54:20 +0200 Message-ID: References: <57035782.3050202@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57925) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1anLoh-0008CV-1X for emacs-orgmode@gnu.org; Tue, 05 Apr 2016 03:54:28 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1anLoc-00073p-O3 for emacs-orgmode@gnu.org; Tue, 05 Apr 2016 03:54:26 -0400 Received: from mail2.b1.hitrost.net ([91.185.211.205]:29180) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1anLoc-0006zE-GV for emacs-orgmode@gnu.org; Tue, 05 Apr 2016 03:54:22 -0400 In-reply-to: <57035782.3050202@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Christian Wittern Cc: Org Mode Mailing List Hi, Mandoku looks very nice -- an inspiration. I don't really know enough about what your users do or how you want to process the blocks to venture an opinion. On the one hand, for the sake of simplicity and continuity for your users (to say nothing of aesthetics), I'd say keep the drawer format, and add what functionality you need to add by defining further conventions and writing code to process drawer contents. Org blocks are many wonderful things, but unobtrusive they're not, and they look quite intimidating when you start adding header lines and parameters. On the other hand, when Org already has these powerful blocks, it does seem a bit wasteful to reinvent the wheel, as well as less portable. On the third hand, have you considered wrapping a block in a drawer? It would only look worse after you've opened it, and you could provide a template for insertion so users don't have to remember where all the colons and pluses go. If you only need the added metadata/functionality for some annotations, and not always, that might be a solution. Yours, Christian Moe Christian Wittern writes: > Dear Orgmoders, > > Today I would like to poll the collective wisdom of the Orgmode user > community about a design question I have. > > Since discovering org-mode more than 9.5 years ago (yeah! ), it has > transformed my life almost as much, maybe even more than Emacs itself. > Among other things, for work I have developed a package called Mandoku, > which uses the org-mode format to deal with (classical) Chinese text. For > those interested, a description of this format, which is 99% org-mode is > here[1]. > > Now, as described at the very end of that page, I allow users to maintain > annotations to things on the previous line of text in drawers. I then have > scripts to collect these annotations and do various interesting things with > them. Now, since I started doing this some 6+ years ago, the org-mode > syntax has seen some changes and especially blocks seem much more advanced > now. I would like to have more expressive power concerning the content of > the annotations, so I am considering switching to a block format for these > annotations (or more likely for the time being, supporting both). This would > give me more metadata and control over the content, because I can have > header lines etc. However, my audience is somewhat non-technical and they > concentrate on reading the texts, so the intrusion has to be minimal. > Currently I handle that with the drawers being mostly folded and only > expanded on demand with a key on the line as usual, that is also the > reason to use a short word for the drawer, which is the only thing seen in > the folded state. > > So this does not work so nicely with blocks, especially if the header line > expands. Ideally I would even like to avoid seeing the header line in > folded state and just have an icon in the margin to indicate that there is > an annotation. Does anybody know how this can be done? Has anybody done > something similar? > > Apart from that, I wonder if there are other things to consider in the > question: Should I move to block syntax rather than staying with drawers? > > Any and all comments appreciated, > > Christian Wittern > > > > [1] http://www.mandoku.org/mandoku-format-en.html