From mboxrd@z Thu Jan  1 00:00:00 1970
From: emacs18@gmail.com (Richard Y. Kim)
Subject: incorrect HTML rendering of info links with spaces
Date: Wed, 08 Apr 2015 00:32:36 -0700
Message-ID: <qtmr3rvaxd7.fsf@gmail.com>
Reply-To: emacs18@gmail.com
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:49530)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs18@gmail.com>) id 1Yfkfs-0001KP-Ko
	for emacs-orgmode@gnu.org; Wed, 08 Apr 2015 03:45:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <emacs18@gmail.com>) id 1Yfkfp-0003ZW-Bb
	for emacs-orgmode@gnu.org; Wed, 08 Apr 2015 03:45:24 -0400
Received: from mail-pa0-x22e.google.com ([2607:f8b0:400e:c03::22e]:36393)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs18@gmail.com>) id 1YfkTY-0007os-PP
	for emacs-orgmode@gnu.org; Wed, 08 Apr 2015 03:32:40 -0400
Received: by pabsx10 with SMTP id sx10so106315352pab.3
	for <emacs-orgmode@gnu.org>; Wed, 08 Apr 2015 00:32:39 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: emacs-orgmode@gnu.org


It seems like org-html-publish-to-html does not translate info links
properly in generated HTML files.  The problem is that spaces in info
nodes should be converted to dashes, but instead spaces are left as is.

For example org-mode link [[info:elisp#Hash Tables]] is converted as 

    <a href="elisp#Hash Tables">elisp#Hash Tables</a>

when in fact the correct URL that should be generated is

    <a href="elisp.html#Hash-Tables">elisp#Hash Tables</a>

where a dash is used in the URL as well as ".html" suffix.

Why should it be "-" instead of " "?  Simply because that is the
convention used by GNU makeinfo when translating texinfo files into HTML
output.  For example

    http://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Hash-Tables

is the correct URL rather than this incorrect URL:

    http://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Hash%20Tables

So today if I hit C-c C-o on [[info:elisp#Hash Tables]] link, then it
correctly brings up "(elisp) Hash Tables" info node.  However the
generated HTML link does not work.  On the other hand
[[info:elisp#Hash-Tables]] with a dash rather than space generates valid
HTML link (ignoring missing ".html" suffix), but C-c C-o fails to work.
It would be very useful if the same org link such as [[info:elisp#Hash
Tables]] works for both C-c C-o as well as generate valid HTML link.

This issue is important to me, because I would rather use org-mode than
texinfo to write documentation on emacs packages with many links
pointing to the official emacs and elisp manuals.  Right now lack of
proper support for info links in org-mode is the *only* reason why I
currently use texinfo rather than org-mode.