emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Ulf Stegemann <ulf-news@zeitform.de>
To: emacs-orgmode@gnu.org
Subject: Re: [BUG] HTML exporting numbered literal examples
Date: Fri, 17 Jul 2009 12:10:39 +0200	[thread overview]
Message-ID: <zf.upnskgvr55s.fsf@zeitform.de> (raw)
In-Reply-To: 87r5wg8lch.fsf@bzg.ath.cx

Hi,

Bastien <bastienguerry@googlemail.com> wrote:

> Ulf Stegemann <ulf-news@zeitform.de> writes:
>
>> With latest CVS Emacs and Git Org mode exporting literal examples
>> (example/src) with the `-n' switch results in numbering starting on line
>> *2* of the example in the resulting HTML file (LaTeX seems to be okay).
>>
>> The example in the manual ...
>>
>> --8<--------------------------snip-------------------------->8---
>>   #+BEGIN_SRC emacs-lisp -n -r
>>   (save-excursion                  (ref:sc)
>>      (goto-char (point-min))       (ref:jump)
>>   #+END_SRC
>>   In line [[(sc)]] we remember the current positon.  [[(jump)][Line (jump)]]
>>   jumps to point-min.
>> --8<--------------------------snap-------------------------->8---
>>
>> ... (which is BTW not working as the manual misses the underscore in
>> `#+END_SRC') results (visually) in
>
> Fixed in the manual.

great, thanks!

>> --8<--------------------------snip-------------------------->8---
>> (save-excursion                  (ref:sc)
>> 1:     (goto-char (point-min))
>> --8<--------------------------snap-------------------------->8---
>>
>> with reference `sc' broken.
>>
>> Can anyone reproduce this?
>
> Yes.  And I just pushed fix for that.

dto. seems to work now as expected.

>> And while we are at it: Would it be feasible to have `-r' in literal
>> examples even without `-n', thus removing the label in the source code
>> block even if the example is not numbered. I have no concrete case where
>> this may be necessary but I think that usually labels shouldn't be
>> displayed in /literal/ examples.
>
> For this I have no idea - it looks like we can wait for "concrete
> examples" :)

I think, those examples are easy to make up.  Line numbers are great for
file contents and maybe input /or/ output.  But as soon as in- and output
are mixed up I find them rather disturbing (imagine e.g. a shell
session).  On the other hand removing labels and having that nice
highlighting feature with HTML exported files maybe useful in either
case.

I had a quick look at `org-export-number-lines' and the following seems
to work smoothly ...

--8<--------------------------snip-------------------------->8---

--- org-exp.el.orig	2009-07-17 11:56:22.000000000 +0200
+++ org-exp.el	2009-07-17 11:57:30.000000000 +0200
@@ -2293,8 +2293,6 @@
 (defun org-export-number-lines (text backend
 				     &optional skip1 skip2 number cont
 				     replace-labels label-format)
-  (if (and (not number) (not (eq replace-labels 'keep)))
-      (setq replace-labels nil)) ;; must use names if no numbers
   (setq skip1 (or skip1 0) skip2 (or skip2 0))
   (if (not cont) (setq org-export-last-code-line-counter-value 0))
   (with-temp-buffer
@@ -2342,7 +2340,7 @@
 	  (if replace-labels
 	      (progn
 		(delete-region (match-beginning 1) (match-end 1))
-		(push (cons ref n) org-export-code-refs))
+		(push (cons ref (if (> n 0) n ref)) org-export-code-refs))
 	    (goto-char (match-beginning 2))
 	    (delete-region (match-beginning 2) (match-end 2))
 	    (insert "(" ref ")")

--8<--------------------------snap-------------------------->8---

Ulf

  reply	other threads:[~2009-07-17 10:11 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-07-09 10:44 [BUG] HTML exporting numbered literal examples Ulf Stegemann
2009-07-16 19:43 ` Bastien
2009-07-17 10:10   ` Ulf Stegemann [this message]
2009-07-17 14:50     ` Bastien
2009-07-17 21:08       ` Ulf Stegemann
2009-07-18  7:15         ` Bastien
2009-07-20 11:36           ` Ulf Stegemann
2009-07-23 19:58             ` Bastien
2009-07-24  6:38               ` Ulf Stegemann
2009-08-03  4:27 ` Carsten Dominik

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=zf.upnskgvr55s.fsf@zeitform.de \
    --to=ulf-news@zeitform.de \
    --cc=emacs-orgmode@gnu.org \
    /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).