Hello, Rasmus <ras...@gmx.us> writes:
> Eric Abrahamsen <e...@ericabrahamsen.net> 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 ‘org-texinfo--@ref’. 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, @kbd{M-@key{TAB}} 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. Regards, -- Nicolas Goaziou
