From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rasmus Subject: Re: setting local variables Date: Wed, 06 Sep 2017 14:42:29 +0200 Message-ID: <87h8wgov62.fsf@gmx.us> References: <871sotiqld.fsf@ericabrahamsen.net> <87r2wsly88.fsf@nicolasgoaziou.fr> <877eykbpho.fsf@ericabrahamsen.net> <87wp5dmkm0.fsf@gmx.us> <87h8wh13tm.fsf@ericabrahamsen.net> <87y3psp5ne.fsf@gmx.us> <87mv68159v.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:51950) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dpZgS-00006D-PK for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 08:44:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dpZfn-00014d-3G for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 08:43:56 -0400 Received: from [195.159.176.226] (port=51248 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dpZfm-00014C-SF for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 08:43:15 -0400 Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1dpZfC-0000Ov-7F for emacs-orgmode@gnu.org; Wed, 06 Sep 2017 14:42:38 +0200 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" To: emacs-orgmode@gnu.org Hi, Nicolas Goaziou writes: > Rasmus writes: > >> Eric Abrahamsen 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. I could not get it to work. I tried stuff like "[[(org) Tables]]", "[[*(org) Tables]]" and , [[texinfo:(org) tables]]. It is always unresolved. I couldn’t think of any other way of referencing an external manual, even skimming ox-texinfo.el, so it is not straightforward to me. >>> 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. That is why I asked for a reference as I do not remember having seen such a layout in an info page. If we know of an example, it might not be hard to implement. > 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. I don’t know as I am not a texinfo expert, but in the texinfo manual they tell you to be vary of @ref. It is probably a bit over the top. The @ref command can tempt writers to express themselves in a manner that is suitable for a printed manual but looks awkward in the Info format. Bear in mind that your audience could be using both the printed and the Info format. For example: Sea surges are described in @ref{Hurricanes}. looks ok in the printed output: Sea surges are described in Section 6.7 [Hurricanes], page 72. but is awkward to read in Info, “note” being a verb: Sea surges are described in *note Hurricanes::. Also, does Org support all four @ref arguments? In either case, these are questions that I find reasonable and cannot find the answer to in the manual. >> 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-~ > in Org, as long as the document targets info. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ I guess the idea of Texinfo is produce info, html, and paper manuals consistently, though. I personally agree, but just look at the Org manual and the fuss about @code vs @samp (which, I believe, are also displayed in the same way). Texinfo is proudly pedantic. People exporting to Texinfo might care about @kbd{} vs @code{} and explaining how to get such fine-grained control would be a fine thing to document in the manual IMO. Rasmus -- Hooray!