Re: Manual in CHM format
| From: | Jesus M. Castagnetto | Date: | Tue, 28 Oct 2003 21:23:18 +0000 |
| Subject: | Re: Manual in CHM format | ||
| References: | 1 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-1804@lists.php.net to get a copy of this message | ||
Just a quick question:
Is this CHM generation based on the one that is
already existing for the PHP manual, or is a
re-implementation from scratch?
If it is a re-implementation, why? there is working
process for the CHM for the PHP manual already, why
not just use that.
Also, if the lack of EOL in the HTML breaks IE, then I
would suggest to trash that defective piece of
software and use one that does comply/follow the known
specs.
--- Dennis Sterzenbach <lists@darknoise.de> wrote:
> Dieter Raber wrote:
>
> >>Looks cool, but all the examples in it are broken.
> :[
> >
> >
> > I assume you are talking about the line breaks and
> the syntax
> > highlighting. I started the .chm file by adding
> the original PEAR
> > stylesheet to the <head> section of the files wich
> are on the website
> > for download. I did that again with a new copy and
> the linebreaks are
> > now allright. Still there is no syntax
> highlighting available since
> > the downloadable HTML files differ from the online
> manual in that
> > respect:
> > Code example from core.pear.pear.intro.html
> (download version)
> > <pre>
> > ...
> > class FileContainer extends PEAR
> > {
> > var $file = '';
> > var $contents = '';
> > var $modified = 0;
> >
> > ...
> > </pre>
> >
> > The same bit online (linebreaks after </font>
> added by myself)
> >
> > <font color="#7F007F">{<br
> /> var </font>
> > <font color="#0000BB">$file </font><font
> color="#7F007F">= </font>
> > <font color="#007F00">''</font><font
> color="#7F007F">;<br />
> > var </font><font
> color="#0000BB">$contents </font>
> > <font color="#7F007F">= </font><font
> color="#007F00">''</font>
> > <font color="#7F007F">;<br
> /> var </font>
> > <font color="#0000BB">$modified </font><font
> color="#7F007F">= </font>
> > <font color="#0000BB">0</font><font
> color="#7F007F">;<br />
> >
> > Now there are several ways to deal with the issue.
> Either I just add
> > the stylesheet link which means we will have
> correct linebreaks but no
> > highlighting. Or I mirror the online manual with
> an offline reader
> > (linebreaks ok, highlighting ok, but quite a bit
> more work for me to
> > get rid of the left column an the top row). Or you
> guys provide me the
> > version of the manual that is online but without
> the navigation column
> > and without the masthead/search block.
> >
> My decision goes to fix it for online and let the
> CHM depend on that,
> as to IE (other browsers, maybe too), having
> problems with missing \n
> after a <br />.
> This should kill two birds with one stone:
> a) the problem Hodicska Gergely reported [1] (also
> see HTML above) and
> b) the problem with broken examples in CHM version
> as reported by
> Alexey Borzov [2]
>
> [1]
>
http://news.php.net/article.php?group=php.pear.doc&article=1785
> [2]
>
http://news.php.net/article.php?group=php.pear.doc&article=1787
>
> --
> Dennis Sterzenbach
> http://www.darknoise.de/
>
> --
> PEAR Documentation List Mailing List
> (http://pear.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
=====
--- Jesus M. Castagnetto <jmcastagnetto@php.net>
__________________________________
Do you Yahoo!?
Exclusive Video Premiere - Britney Spears
http://launch.yahoo.com/promos/britneyspears/