[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] setting local variables

From: Nicolas Goaziou
Subject: Re: [O] setting local variables
Date: Wed, 06 Sep 2017 12:38:04 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux)


Rasmus <address@hidden> writes:

> Eric Abrahamsen <address@hidden> writes:
>> The only real problem I encountered was that links to external Info
>> manuals did not export correctly, and couldn't be followed. I gave up on
>> learning the exact syntax of texinfo's @[px]ref commands because it was
>> dinnertime, but I can figure out what went wrong and maybe provide a
>> patch.
> I am not sure either.  I couldn’t get cross-referencing working.
> http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Cross-References
> The texinfo part of the Org manual could use a section on
> cross-referencing

IIRC, cross-referencing is straightforward. It should just work.

>> The other thing I'd like to know is how to "inline" sections (ie output
>> several sections on a single page), but still have links to those
>> sections work correctly.
> Are you talking about info pages now?  Because in pdf and html it’s not an
> issue as far as I’m aware.

The OP is probably talking about @heading and al. 

There is actually no way to specify such a "nodeless" heading (more
exactly, an unnumbered heading that doesn't appear in the table of
contents), because I couldn't find any appealing syntax (i.e., not too
low level, and, if possible, generic enough).

I agree this is the last major issue in this export back-end.

> I would agree, but perhaps I’m biased since I don’t have much of a working
> knowledge of texinfo other than enough to add sections to an existing
> manual.
> You could look at the texinfo manual and see if we are missing something
>     http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html
> On the top of my head it would be good to have a cross-referencing
> section, though I think that there may not be support for too
> sophisticated referencing, at least judging from address@hidden

What it sophisticated referencing? "ox-texinfo" supports internal and
external links without specific syntax. @pxref and @xref is just
syntactic sugar over @ref.

"ox-texinfo.el" supports @email, @ref and @uref.

> Another area that seems slightly lacking is support for all markings, so
> perhaps there could be a section on accessing your favorite via
> ‘org-texinfo-text-markup-alist’ (if ‘org-texinfo--text-markup’ supports
> it) and the rest via macros, if necessary.
> http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Marking-Text

IMO, advanced marking is not needed, at least out of the box. For
example, @address@hidden in Texinfo is morally equivalent to ~M-<TAB>~
in Org, as long as the document targets info.

If you absolutely need @kbd, you can use a macro.


Nicolas Goaziou

reply via email to

[Prev in Thread] Current Thread [Next in Thread]