There should never been any empty frame, all parameters should have a
description - so this is a bug in the actual documentations.

Regarding the styles.. The style we use in the CHM is the same as we
use on the website..
Simply removing the css file will give you the "original style" back :)

-Hannes

2009/3/17 Łukasz Czerwiński <[email protected]>:
> Thank you for your reply and description on how to compile my own manual. I
> have changed some styles to make the manual look better for me. Maybe there
> are some more users that would like to use my style...?
>
> Screenshots:
> Previous layout (PHP manual that I used for a long time and get used to):
> http://milimetr.tis.net.pl/moje/phpdoc/previous.png
> Layout of the latest version of PHP manual, which I find really disturbing
> and uncomfortable: http://milimetr.tis.net.pl/moje/phpdoc/current.png
> My custom layout: http://milimetr.tis.net.pl/moje/phpdoc/mycustom.png
> If you find my layout useful and nice for other people, I will send
> style.css file used in compilation.
>
> I have found an annoying bug in the PHP manuals, both with my own style and
> in manual downloaded from php.net: even if there no text describing a
> function's parameter, there is an empty frame visible:
> http://milimetr.tis.net.pl/moje/phpdoc/mycustom_bug.png
> http://milimetr.tis.net.pl/moje/phpdoc/current_bug.png
>
> No additional space is seen in the old version of manual:
> http://milimetr.tis.net.pl/moje/phpdoc/previous_bug.png
>
> How to workaround these empty frames? As I understand, they are created when
> parsing manual.xml using phd.
>
> Best wishes,
> Łukasz Czerwiński
>
>
> 2009/3/17 Hannes Magnusson <[email protected]>
>>
>> 2009/3/16 Łukasz Czerwiński <[email protected]>:
>> > Hello,
>> >
>> > Sorry for sending a while ago an unfinished mail. It was of course by
>> > accident.
>> >
>> > I have not downloaded PHP documentation for quite a long time, but now
>> > wanted to do it. What I see that now it's completely unreadable - the
>> > letters are so big and there are so many color frames, that each
>> > function
>> > takes two times more place on the screen than it used to take. Is it
>> > possible for me to change CHM's styles? Or recompile it? How to do it?
>>
>> That doesn't sound right. Could you post a screenshot of what you are
>> seeing somewhere?
>>
>> You can build the chm yourself if want. To do that you need an CVS
>> client though to "download" the documentations:
>>
>> Installing the tools:
>>  Download & install Microsoft HTML Help Workshop
>> (http://go.microsoft.com/fwlink/?linkid=14188)
>>  $ pear channel-discover doc.php.net
>>  $ pear install doc.php.net/phd-beta
>>
>> Fetching the sources:
>>  $ cvs -d:pserver:[email protected]/repository login
>> The password is "phpfi"
>>  $ cvs -d:pserver:[email protected]/repository co phpdoc
>>
>> Verify the docs are OK:
>>  $ cd phpdoc
>>  $ php configure.php
>>
>> Render the documentations and build the "CHM index files":
>>  $ phd -f chmsource -t chmsource -o manual -d .manual.xml
>>
>> Compile the CHM:
>>  $ cd manual
>>  $ hhc.exe chm/php_manual_en.hhp
>> That will create "php_manual_en.chm" in the chm directory.
>>
>> > (Both layouts of the CHM file, both the current and my preffered one,
>> > are in
>> > attachments)
>>
>> Everything except for plain/text gets stripped of the list.
>>
>> -Hannes
>
>

Reply via email to