bugtexinfo - GNU documentation system - Bugs: bug #35614, mobile-phone friendly HTML output


You are not allowed to post comments on this tracker with your current authentication level.

bug #35614: mobile-phone friendly HTML output

Submitted by:  Seong-Kook Shin <cinsk>
Submitted on:  Fri 24 Feb 2012 12:24:57 AM UTC  
Category:  makeinfo Release: 
Priority:  5 - Normal Severity:  3 - Normal
Item Group:  enhancement Privacy:  Public
Open/Closed:  Closed Assigned to:  None
Status:  Wont Fix

Thu 10 Sep 2015 06:24:40 PM UTC, comment #1:

I couldn't think of any good way to allow arbitrary text to be inserted in the <HEAD> section of the HTML file, from the perspective of Texinfo source. This could be dealt with by some kind of postprocessing of the HTML file, with a special program or library for processing HTML. Some of this might be possible with the customization API for makeinfo (since Texinfo 5.0). If these changes were possible, there would likely be infinitely many other similar changes that somebody would want to make, so I wouldn't support adding explicit support for these iphone tags in the main Texinfo project.

Gavin D. Smith <gavin>
Project Administrator
Fri 24 Feb 2012 12:24:57 AM UTC, original submission:

The HTML generated by makeinfo (texinfo 4.13) is hard to read from mobile phone such as iphone 4s.

Two things should be dealt with, for best iphone-safari experience.

1. Device-width aware HTML.

Simple, just inserting follow meta tags will be enough:
(See also https://github.com/h5bp/mobile-boilerplate)

<meta name="HandheldFriendly" content="True">
<meta name="MobileOptimized" content="320">
<meta name="viewport" content="width=device-width">
<meta http-equiv="cleartype" content="on">

I'm not expecting this will be hard coded into texinfo, rather,
it will be grateful if there is a way to insert custom <meta>.

Contents between "@html .. @end html" are inserted in <body> so that, I cannot use it for my purpose.

2. "Reader" feature in Safari 5.x.
Safari 5.x in iphone renders HTML for easier reading on the device. See http://mathiasbynens.be/notes/safari-reader for more information.

In short, put everything in "<body><article> ... </article></body>" will trigger the "Reader" feature. Note that I didn't investigate much here so there will be better HTML markup for Safari reader.

After looking at makeinfo's source, it would be trivial to support safari reader. Replace every occurrence of "<body>" and "</body>" in html.c, makeinfo.c, and node.c into "<body><article>" and "</article><body>".

I tried that, and found for multiple HTML page output, it would be great. But for one huge HTML page output, Safari reader won't be triggered.

Since, my experiment was just for my personal use, non-general-purpose, I asking texinfo developers, so that there will be some solution about this.

Thank you,

Seong-Kook Shin <cinsk>


No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by xuhdev
  • -email is unavailable- added by gavin (Posted a comment)
  • -email is unavailable- added by cinsk (Submitted the item)

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.




    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2016-02-01 xuhdev Carbon-Copy- => Added -email is unavailable-
    2015-09-10 gavin Open/ClosedOpen => Closed
        StatusNone => Wont Fix

    Back to the top

    Powered by Savane 3.3