(DON'T DELETE!!) ZSNES HTML Help Topic

The official forum for ZSNES documentation. Discuss future changes, mistakes, etc...
You can also join us on IRC at irc.freenode.net in #zsnes-docs.

Moderators: ZSNES Mods, ZSNES Doc Team

xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach wrote:I just checked out latest CVS for the CHM.

I'm not exactly impressed, and here's why:

http://nsrt.edgeemu.com/images/zsnes/zchm.png

Anyone know what the problem is exactly?
OK, I'm not 100% sure about this, but it looks like Richard C. started using html tags instead of xml tags for the chm around that time.

http://board.zsnes.com/phpBB2/viewtopic ... 5423#55423

Maybe this could be the problem?
KaOSoFt
Rookie
Posts: 12
Joined: Wed Aug 18, 2004 2:07 pm
Location: Colombia
Contact:

Post by KaOSoFt »

Well, I just didn't want to make another topic, so I used this since it's more my-request related.

I'm running a romhacking site (in spanish) where we (2 people working on it) translate some documents so people in our language can get closer to that world, but the thing is: I don't think .txt is nice format to read things, and since I'm redesigning the site to be XHTML/CSS compliant, I was thinking in asking if I could use ZSNES documentation XHTML/CSS (design) for the translated documents. It'll be better for any person, since the format is pretty readable, so I really expect a positive answer. :P

It'll be just for the documents, since the site has a really different design (colors and stuff). I'll be linking you to it when I'm done with the new layout.

Anyways, thanks for your help.
To be human is to know the fear of death, yet keep on fighting.
Richard C.
Lurker
Posts: 151
Joined: Wed Oct 06, 2004 9:09 pm
Location: Georgia, USA
Contact:

Post by Richard C. »

i, for one, have no problem with you using the layout in any way you see fit. however, i didnt create the layout in the first place, radio did. he had no objections to me using the design for the docs, and i dont see why he would care if it was used somewhere else.
Latest ZSNES release: [url=http://zsnes.ipherswipsite.com]ZSNES 11/12/06 WIP[/url]
Latest NSRT release: [url=http://nsrt.edgeemu.com/]NSRT 3.3 Final[/url]
KaOSoFt
Rookie
Posts: 12
Joined: Wed Aug 18, 2004 2:07 pm
Location: Colombia
Contact:

Post by KaOSoFt »

Well, it can't hurt to ask. 8)
To be human is to know the fear of death, yet keep on fighting.
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Clements, just curious, but are you able to commit the CHMs to CVS yourself? We probably don't need these hosted anywhere other than SourceForge. Just a thought.
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

I've looked into TortoiseCVS, but I could not understand any of it, so gave up.
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

I'm not so sure how good CVS is for something like a CHM.

I'll look into later into making a batch file to automatically upload the CHM to http://zsnes-docs.sf.net/chm.zip or something.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Freewebs is messed up and has been so for weeks, not letting me access the file manager. I'll have to find another host...

For now the links'll be broken.
Noxious Ninja
Dark Wind
Posts: 1271
Joined: Thu Jul 29, 2004 8:58 pm
Location: Texas
Contact:

Post by Noxious Ninja »

I can host it on my school web space if you want. There's no way I can get you upload privileges, however.
[u][url=http://bash.org/?577451]#577451[/url][/u]
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Noxious Ninja wrote:I can host it on my school web space if you want. There's no way I can get you upload privileges, however.
Or just go ahead and commit it to CVS instead (just the CHM, not the source). ;)

Oh, and filespace.org is good, too, for hosting.
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

I could get Emulation64 to host it for me. I messed the file manager up last time, so hopefully I won't delete the entire ZSNES section. :lol:

This host should be much more reliable than Freewebs.
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

I'm not sure what the exact style I'm supposed to be seeing, but it looks okay for the most part.

Image

Is the menu supposed to be on the left, or there are supposed to be a background and table lines?

Other than my wondering over the style, the two images on the bottom of each page are broken.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Here's what it looks like with Windows:

Image

It looks usable as it stands at least, but it's as if all the CSS code is broken in your shot. If I remove the style.css file from the docs I get the same result, so perhaps your viewer does not support it.
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Nach, that navigation stuff isn't supposed to be on the right, only the left. :/ And there is supposed to be color and graphics, as well.

About the broken images: If you're talking about the Firefox images, they are not supposed to be there. We decided that it just looks weird to have them in the chm.
Jipcy
Veteran
Posts: 768
Joined: Thu Feb 03, 2005 8:18 pm
Contact:

Post by Jipcy »

Yes, the actual document in Nach's xCHM is completely unstyled. Are Nach and Clements viewing the exact same file? Has styling worked in xCHM before?

I'm not even sure how chm files work. Do you "compile" the html files and css file into some other proprietary format? Or is a chm file just a bunch of zipped up html files with some extra information for the CHM viewer?
[url=http://zsnes-docs.sf.net]Official ZSNES Docs[/url] | [url=http://zsnes-docs.sf.net/nsrt]NSRT Guide[/url] | [url=http://endoftransmission.net/phpBB3/viewtopic.php?t=394]Using a Wiimote w/ emulators[/url]
Noxious Ninja
Dark Wind
Posts: 1271
Joined: Thu Jul 29, 2004 8:58 pm
Location: Texas
Contact:

Post by Noxious Ninja »

It almost sounds like xCHM is getting only the HTML, and none of the other resources. Does the ZSNES logo at the top show up?
[u][url=http://bash.org/?577451]#577451[/url][/u]
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

Jipcy wrote: Has styling worked in xCHM before?
I think it has...
Anyone have a really old version laying around?
Jipcy wrote: I'm not even sure how chm files work. Do you "compile" the html files and css file into some other proprietary format? Or is a chm file just a bunch of zipped up html files with some extra information for the CHM viewer?
The latter.
Noxious Ninja wrote:It almost sounds like xCHM is getting only the HTML, and none of the other resources. Does the ZSNES logo at the top show up?
No it doesn't. However some menu images show up.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Noxious Ninja
Dark Wind
Posts: 1271
Joined: Thu Jul 29, 2004 8:58 pm
Location: Texas
Contact:

Post by Noxious Ninja »

Has anybody tried the docs with this?

http://www.kde-apps.org/content/show.php?content=25125
[u][url=http://bash.org/?577451]#577451[/url][/u]
Nach
ZSNES Developer
ZSNES Developer
Posts: 3904
Joined: Tue Jul 27, 2004 10:54 pm
Location: Solar powered park bench
Contact:

Post by Nach »

Screenshots look nice. Although it seems to be a pretty new program and isn't in Debian yet.
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

I can now commit via TortoiseSVN now, so the CHM will not need to be commited on my behalf.

PS: There is an odd issue with the CHM with the Content links (e.g. readme.htm#disclaimer) and IE7. Works fine with IE6, and doesn't affect the standalone web-based docs in either IE6 or 7.
Jipcy
Veteran
Posts: 768
Joined: Thu Feb 03, 2005 8:18 pm
Contact:

Post by Jipcy »

Clements wrote:I can now commit via TortoiseSVN now, so the CHM will not need to be commited on my behalf.
You were not able to commit anything to the CVS repository, before? Hmm... sorry about that. Well good thing you can commit to SVN now.
Clements wrote:PS: There is an odd issue with the CHM with the Content links (e.g. readme.htm#disclaimer) and IE7. Works fine with IE6, and doesn't affect the standalone web-based docs in either IE6 or 7.
Are you saying the issue is with the compiled CHM docs, viewed on a computer that has IE7 (since I think the Windows CHM viewer uses the IE rendering engine)?

I'll check it out. It probably has to do with XHTML bullshit.
[url=http://zsnes-docs.sf.net]Official ZSNES Docs[/url] | [url=http://zsnes-docs.sf.net/nsrt]NSRT Guide[/url] | [url=http://endoftransmission.net/phpBB3/viewtopic.php?t=394]Using a Wiimote w/ emulators[/url]
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Jipcy wrote:Are you saying the issue is with the compiled CHM docs, viewed on a computer that has IE7 (since I think the Windows CHM viewer uses the IE rendering engine)?
Yes, that's right.
Jipcy
Veteran
Posts: 768
Joined: Thu Feb 03, 2005 8:18 pm
Contact:

Post by Jipcy »

I only now just realized you're talking about IE 7 Beta. So, yeah... there's no issues. It's IE 7.

And, there's no way I can test it on this computer, because I do not plan on installing IE 7 Beta.
[url=http://zsnes-docs.sf.net]Official ZSNES Docs[/url] | [url=http://zsnes-docs.sf.net/nsrt]NSRT Guide[/url] | [url=http://endoftransmission.net/phpBB3/viewtopic.php?t=394]Using a Wiimote w/ emulators[/url]
Clements
Randomness
Posts: 1172
Joined: Wed Jul 28, 2004 4:01 pm
Location: UK
Contact:

Post by Clements »

Yep. It's a minor thing, as we don't know if this bug will be in the final version yet. It did mean that I had to uninstall IE7 on one of my machines to get the CHM to work properly.
xamenus
Veteran
Posts: 907
Joined: Fri Jul 30, 2004 12:26 am

Post by xamenus »

Since you're able to commit the CHM, I just thought I'd let you know that it's my personal opinion that the CHM should not be hosted at Emulation64 any longer.

It's just that I don't always like the idea of unfinished projects to be so readily available to the public, especially when they're hosted on third party servers.

What does everyone else think of this?
Post Reply