From: tsd@tsdye.com (Thomas S. Dye)
To: Org-mode <emacs-orgmode@gnu.org>
Subject: texinfo export advice
Date: Wed, 05 Dec 2012 06:22:24 -1000 [thread overview]
Message-ID: <m1a9tsfozj.fsf@poto.myhome.westell.com> (raw)
Aloha all,
I'm trying to find a good Org representation for a common construct in
org.texi and need some help.
Here is the construct in org.texi:
@table @asis
@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}
Switch back to the startup visibility of the buffer, i.e.: whatever is
requested by startup options and @samp{VISIBILITY} properties in individual
entries.
@end table
It displays a key command and the Org function that it runs, then has a
description of the function. In the info manual it looks like this:
`C-u C-u <TAB>' (`org-set-startup-visibility')
Switch back to the startup visibility of the buffer, i.e.:
whatever is requested by startup options and `VISIBILITY'
properties in individual entries.
I can export this with the texinfo exporter with a lot of wrapping:
@@info:@table @asis@@
@@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@
Switch back to the startup visibility of the buffer, i.e.: whatever is
requested by startup options and @@info:@samp{VISIBILITY}@@ properties in individual
entries.
@@info:@end table@@
This is fine, but the Org mode buffer doesn't look much like Org mode
after a few of these.
My idea is to use a description list, like so:
- @@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@ ::
Switch back to the startup visibility of the buffer, i.e.:
whatever is requested by startup options and
@@info:@samp{VISIBILITY}@@ properties in individual entries.
This almost works. However, it inserts an @index command that gets in
the way:
@table @samp
@item @orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}
Switch back to the startup visibility of the buffer, i.e.:
whatever is requested by startup options and
@samp{VISIBILITY} properties in individual entries.
@end table
This is the view from info:
`
`C-u C-u <TAB> (`org-set-startup-visibility')'
'
Switch back to the startup visibility of the buffer, i.e.:
whatever is requested by startup options and `VISIBILITY'
properties in individual entries.
Note the extra open and close quotes and newlines.
I'm thinking something like this might be a useful addition:
#+attr_texinfo :item nil
- @@info:@orgcmd{C-u C-u @key{TAB},org-set-startup-visibility}@@ ::
Switch back to the startup visibility of the buffer, i.e.:
whatever is requested by startup options and
@@info:@samp{VISIBILITY}@@ properties in individual entries.
Ideas?
All the best,
Tom
--
T.S. Dye & Colleagues, Archaeologists
735 Bishop St, Suite 315, Honolulu, HI 96813
Tel: 808-529-0866, Fax: 808-529-0884
http://www.tsdye.com
reply other threads:[~2012-12-06 1:32 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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=m1a9tsfozj.fsf@poto.myhome.westell.com \
--to=tsd@tsdye.com \
--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).