View unanswered posts | View active topics It is currently Thu Aug 22, 2019 10:33 pm



Reply to topic  [ 118 posts ]  Go to page 1, 2, 3, 4, 5  Next
(DON'T DELETE!!) ZSNES HTML Help Topic 
Author Message
Randomness
User avatar

Joined: Wed Jul 28, 2004 4:01 pm
Posts: 1172
Location: UK
Reply with quote
Post (DON'T DELETE!!) ZSNES HTML Help Topic
[UPDATE]

All files needed to compile the CHM along with step-by-step instructions are now available in SVN.

This has several advantages:

- When I am unavailable, any doc team member (with the time and right software) can compile and commit the CHM to SVN. It only takes about 5 minutes or so to edit, compile and commit when you know what to do.

- Any doc writer can edit and update the Project and Contents Files. Every time a new section is added, or a section is moved, the Contents needs to be updated for the links to remain working. Sometimes it is hard for me to spot every change, so now anyone can update these files rather than just me. If you have any questions on doing this, I may be able to help. There is some documentation with the compiler as a first port of call. It's fairly simple to figure most stuff out.

Instructions should make compiling clear to everybody, but if you want to clean the file up or edit stuff to make it easier, be my guest.

Original Post:

The ZSNES HTML Help file, based on the latest HTML source available from Sourceforge.

Here is a list of my full changes to the appropriate files when compiling the CHM for the sake of reference:

Code:
==============================================================
About.htm
==============================================================
Before </HTML> tag:

<img src="./images/corner.png" style="display:none;">

==============================================================
Radio.css
==============================================================

Split these merged groups by copying/pasting this:

#navigation
{
  background-color: #C8CFD8;
  border: solid 1px black;
  color: inherit;
  padding: 1px 1px 0.5em 1px;
  display:none;
}

#content
{
  background-color: #C8CFD8;
  border: solid 1px black;
  color: inherit;
  padding: 1px 1px 0.5em 1px;
}

--------------------------------------------------------------

#nav_column {
...
  width: 0em;
}

--------------------------------------------------------------

#content_column {
   margin: 0.65em 0.65em 0.65em 0.65em;

--------------------------------------------------------------

#footer {
...
  display:none;
}

--------------------------------------------------------------

Copy contents of shared.css into Radio.css


CHM is now available at Sourceforge:

http://sourceforge.net/projects/zsnes-docs/

_________________
ZSNES Documentation Project | bsnes Fan | Official ZSNES Facebook Group


Last edited by Clements on Thu Jan 25, 2007 7:19 pm, edited 25 times in total.



Sun Jan 23, 2005 10:26 pm
Profile WWW
Dark Wind
User avatar

Joined: Thu Jul 29, 2004 8:58 pm
Posts: 1270
Location: Texas
Reply with quote
Post 
Hmm, I see. I'll try to find the cause.

_________________
#577451


Mon Jan 24, 2005 2:31 am
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
If future ZSNES releases are going to have chms, we might as well delete the firefox and navigation html code from the source.

However, that would be a somewhat major change for the docs. I reckon that we should make a team decision on whether we want to do that.


Mon Jan 24, 2005 4:09 am
Profile
ZSNES Developer
ZSNES Developer
User avatar

Joined: Tue Jul 27, 2004 10:54 pm
Posts: 3901
Location: Solar powered park bench
Reply with quote
Post 
I don't know if we're only going to do CHM releases.
Although CHM is readable on Linux, I don't know how popular it is to read a CHM file.
A browser though is a perfectly standardized way to read docs.

We'd probably only make CHMs for ZSNESW.

_________________
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding


Mon Jan 24, 2005 4:18 am
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
Actually, a chm would be a great way to unify the docs for the 3 ports, as you were wanting Nach. :) This way, all 3 ports could have documentation for the other 2 ports as well. So there's a plus.


Mon Jan 24, 2005 4:24 am
Profile
ZSNES Developer
ZSNES Developer
User avatar

Joined: Tue Jul 27, 2004 10:54 pm
Posts: 3901
Location: Solar powered park bench
Reply with quote
Post 
Regardless you'll still have 3 directories to throw in the CHM, I don't want that.

I really want it unified. Not just for myself, but for the development of it.
Do you like that every time you find some typo in gui.htm you have to modify 3 files instead of one?

_________________
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding


Mon Jan 24, 2005 4:26 am
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
The problem is that there are still lots of small differences for the ports, for readme.htm and gui.htm (eg. the dos port has the debugger, some gui and video features are in windows but not dos and linux, etc.). The FAQ isn't the only thing with differences. How should we deal with that?


Mon Jan 24, 2005 4:32 am
Profile
ZSNES Developer
ZSNES Developer
User avatar

Joined: Tue Jul 27, 2004 10:54 pm
Posts: 3901
Location: Solar powered park bench
Reply with quote
Post 
In a case where a feature is a certain port only, lable it as such.

The FAQ should be broken into All:, DOS:, Windows:, SDL:.

For the GUI, the buttons in the upper right corner are no big deal.

_________________
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding


Mon Jan 24, 2005 4:57 am
Profile WWW
Lurker
User avatar

Joined: Wed Oct 06, 2004 9:09 pm
Posts: 151
Location: Georgia, USA
Reply with quote
Post 
however, there are major differences in the dos gui. we could seperate the windows, dos, and linux gui like we would the faq.

this is definately a good idea, and i just might begin working on it once i have more time (like friday night, sadly, if i have more time, or maybe some day i have off work).

_________________
Latest ZSNES release: ZSNES 11/12/06 WIP
Latest NSRT release: NSRT 3.3 Final


Mon Jan 24, 2005 6:02 am
Profile WWW
Lurker
User avatar

Joined: Wed Oct 06, 2004 9:09 pm
Posts: 151
Location: Georgia, USA
Reply with quote
Post 
forgot something:

since the documentation should be completely skinnable just by editing the css file, would it not be a good idea to make a new layout for the docs - one more like other documentation projects. for example, the gentoo docs. easy to read, very clean with little distraction, non-graphic intensive, and most importantly, also in html.

_________________
Latest ZSNES release: ZSNES 11/12/06 WIP
Latest NSRT release: NSRT 3.3 Final


Mon Jan 24, 2005 6:06 am
Profile WWW
"God"

Joined: Tue Jul 27, 2004 11:24 pm
Posts: 1128
Reply with quote
Post 
stick with HTML.

chm is just bleah.


Mon Jan 24, 2005 6:50 am
Profile
Dark Wind
User avatar

Joined: Thu Jul 29, 2004 8:58 pm
Posts: 1270
Location: Texas
Reply with quote
Post 
Richard C. wrote:
forgot something:

since the documentation should be completely skinnable just by editing the css file, would it not be a good idea to make a new layout for the docs - one more like other documentation projects. for example, the gentoo docs. easy to read, very clean with little distraction, non-graphic intensive, and most importantly, also in html.


I've been playing with things along this line after being pleased with my recent site design, but I haven't come up with anything I really like yet.

_________________
#577451


Mon Jan 24, 2005 4:41 pm
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
So what about the DOS port? Will it have a chm, or should the docs be text only (for those running under pure DOS)?


Mon Jan 24, 2005 9:50 pm
Profile
16-bit Corpse | Nyoron~
User avatar

Joined: Sun Aug 01, 2004 7:14 pm
Posts: 3534
Location: Nokia Land
Reply with quote
Post 
IceFox wrote:
So what about the DOS port? Will it have a chm, or should the docs be text only (for those running under pure DOS)?

I think they should be text only, exactly for those who run ZSNES in pure DOS.

_________________
whicker: franpa is grammatically correct, and he still gets ripped on?
sweener2001: Grammatically correct this one time? sure. every other time? no. does that give him a right? not really.
Image


Mon Jan 24, 2005 9:57 pm
Profile
ZSNES Developer
ZSNES Developer
User avatar

Joined: Tue Jul 27, 2004 10:54 pm
Posts: 3901
Location: Solar powered park bench
Reply with quote
Post 
I don't mind giving HTML docs to DOS users. Even though to my knowledge there isn't a decent graphical web browser for DOS, if you got it off the web, you got a web browser somewhere, and you can always read the HTML directly in DOS Edit if you're desperate.

_________________
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding


Mon Jan 24, 2005 9:58 pm
Profile WWW
16-bit Corpse | Nyoron~
User avatar

Joined: Sun Aug 01, 2004 7:14 pm
Posts: 3534
Location: Nokia Land
Reply with quote
Post 
Nach wrote:
I don't mind giving HTML docs to DOS users. Even though to my knowledge there isn't a decent graphical web browser for DOS, if you got it off the web, you got a web browser somewhere, and you can always read the HTML directly in DOS Edit if you're desperate.

Eh, chalk my post up to being old school I guess.

_________________
whicker: franpa is grammatically correct, and he still gets ripped on?
sweener2001: Grammatically correct this one time? sure. every other time? no. does that give him a right? not really.
Image


Mon Jan 24, 2005 11:41 pm
Profile
ZSNES Developer
ZSNES Developer
User avatar

Joined: Tue Jul 27, 2004 10:54 pm
Posts: 3901
Location: Solar powered park bench
Reply with quote
Post 
Agozer wrote:
Nach wrote:
I don't mind giving HTML docs to DOS users. Even though to my knowledge there isn't a decent graphical web browser for DOS, if you got it off the web, you got a web browser somewhere, and you can always read the HTML directly in DOS Edit if you're desperate.

Eh, chalk my post up to being old school I guess.


I'm old school too. You have a good point about pure DOS. Maybe I'm just biased because I read HTML like it's any other doc.

_________________
May 9 2007 - NSRT 3.4, now with lots of hashing and even more accurate information! Go download it.
_____________
Insane Coding


Mon Jan 24, 2005 11:52 pm
Profile WWW
16-bit Corpse | Nyoron~
User avatar

Joined: Sun Aug 01, 2004 7:14 pm
Posts: 3534
Location: Nokia Land
Reply with quote
Post 
Nach wrote:
because I read HTML like it's any other doc.

Me too... Anyway, nowadays people tend to forget that there are still people who run pure DOS (whatever their reasons for doing so might be) so we should provide them with the documentation in the simplest form possible; just plain text.

_________________
whicker: franpa is grammatically correct, and he still gets ripped on?
sweener2001: Grammatically correct this one time? sure. every other time? no. does that give him a right? not really.
Image


Tue Jan 25, 2005 12:21 pm
Profile
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
Just a reminder for whovever converts the DOS docs to text: Don't forget to replace the hyperlinks with URLs.

That may be obvious, but hey. :P


Thu Jan 27, 2005 4:36 am
Profile
Born to Rule... Impatiently
User avatar

Joined: Wed Nov 17, 2004 8:21 pm
Posts: 265
Location: Everywhere I want to be.
Reply with quote
Post Text-Only Docs
I've already done some formatting for the text-only version of the docs from the "Unified" folder in CVS, using the latest revisions. As you can probably tell, I'd like to be in charge of the text versions. ;) I'll make changes when necessary and cooperate with the team's ideas, of course.

Unfortunately, I have no form of online file hosting right now, so what method might you prefer for transmitting what I have so far? Could I just e-mail the zipped files? ...To IceFox, I suppose?

I haven't yet done the hyperlinks-to-URLs conversion, though. :P
I'll try to do that before sending the files.

[I guess I should have made a new topic... Move this post if you feel like it. :)]

_________________
My NES palette - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- daniel bohman


Mon Feb 07, 2005 11:52 am
Profile WWW
Winter Knight
User avatar

Joined: Mon Aug 16, 2004 10:16 pm
Posts: 467
Reply with quote
Post 
I *was* going to set up a wiki on zsnes.ownsjoo.info, but pf changed the root passwd and sudo is broken, so I can't unless I do it locally.


Mon Feb 07, 2005 1:25 pm
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post Re: Text-Only Docs
AspiringSquire wrote:
Unfortunately, I have no form of online file hosting right now, so what method might you prefer for transmitting what I have so far? Could I just e-mail the zipped files? ...To IceFox, I suppose?
I use GeoCities. You could also use http://rapidshare.de

And thank you for helping out btw. :)



Has anyone managed to fix style.css for IE? After that's done, maybe Clements could then modify the html docs as necessary (remove navigation, Firefox logos) and make a chm.


Mon Feb 07, 2005 6:44 pm
Profile
Born to Rule... Impatiently
User avatar

Joined: Wed Nov 17, 2004 8:21 pm
Posts: 265
Location: Everywhere I want to be.
Reply with quote
Post 
I've put a zip file for you to download here:
http://rapidshare.de/files-en/544358/zd ... 1.zip.html

I couldn't add the latest hyperlinks because CVS doesn't show that update yet, but I think I know what you put there.

Tell me what you think. :)

Edit: Whoops, forgot to rename the files to "readme.txt", etc. Oh well. That will be done when they're ready to be used.

Edit 2: ...Or rather, "when we're ready to use them." ;)

Everything is formatted and fully readable. I gave the sub-sections a numbering scheme so they could be found more easily from the Navigation listing. The only major thing that I haven't done is set a characters-per-line limit. I'd like to know whether we think that would be necessary because it would take quite a while to do it and make it work/look good with the rest of the formatting. But it is not beyond my capability. :)

Edit 3: I updated the GUI file. Nothing else was changed, but this includes all of the documents from the unified folder (hence, no FAQ):
http://rapidshare.de/files-en/551610/zd ... 1.zip.html

_________________
My NES palette - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- daniel bohman


Mon Feb 07, 2005 11:28 pm
Profile WWW
Veteran

Joined: Fri Jul 30, 2004 12:26 am
Posts: 907
Reply with quote
Post 
Wow, looks great! However, there are a lot of unneeded * and + symbols throughout the docs, in places where there are list of things, like the what's new, etc. (I imagine they appear when copying and pasting). They should be removed. Other than that, things look great so far!

Sorry that it's taken me so long to respond to this, I haven't been around as much and I missed this post.


Fri Feb 11, 2005 8:18 pm
Profile
Born to Rule... Impatiently
User avatar

Joined: Wed Nov 17, 2004 8:21 pm
Posts: 265
Location: Everywhere I want to be.
Reply with quote
Post 
IceFox wrote:
Wow, looks great!

Thanks. :) I've had some experience formatting simple text files. I know what I like. :P
Update here: http://rapidshare.de/files-en/577851/zd ... 2.zip.html

Only Changes, GUI, Netplay, and Readme were changed at all, as the version numbers indicate. The files have been relieved of superfluous markings at the beginnings of all lines that had them. I have the "find and replace" tool in metapad to thank for making the process much faster. [The best true "Notepad replacement" program available for Windows, because it is so small and fast, with added functionality. Free! :D — If you're at all interested, you should try it. See the feature list.]
It appears that the *, o, +, and # symbols are all signifiers for how far the text should be indented. At least, that was the text representation of something like that in the html.


Also, some more "bug reports":

Readme.htm wrote:
Following are present in 16-bit graphics mode:

This should be "The following are...", like the others listed in the section.

GUI.htm wrote:
Reverse Stereo - This function swaps the L and R volume levels in stereo mode.

Is that what it really does? Doesn't it swap which channel (left or right) goes to which computer speaker? If that's what it is meant to convey, the sentence needs rewriting.

_________________
My NES palette - better colors with any emulator.

"the more you know, and the more you can do... the more you are."
- daniel bohman


Sat Feb 12, 2005 1:01 am
Profile WWW
Display posts from previous:  Sort by  
Reply to topic   [ 118 posts ]  Go to page 1, 2, 3, 4, 5  Next

Who is online

Users browsing this forum: Bing [Bot] and 1 guest


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum

Search for:
Jump to:  
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group.
Designed by ST Software.