Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rename HTML documentation files using the 8.3 filename convention #152

Open
wants to merge 13 commits into
base: master
Choose a base branch
from

Conversation

thecatkitty
Copy link
Contributor

@thecatkitty thecatkitty commented Apr 29, 2018

@NazmusLabs has converted the CHM help from Windows 98 into discrete HTML pages (#125).

I just made it open in Windows 3.x.

Windows File Manager HTML help in Internet Explorer 5 on Windows for Workgroups 3.11

NazmusLabs and others added 13 commits April 22, 2018 04:41
… HTML

The original documentations for winfile, as extracted from the Windows 98 operating system, has now been ported to an open, and fully functional web based help system, complete with hyper-link support and table of contents.

This represents the initial milestone "freeing" the documentation, making it easy to read on any device. And now that this is done, contributors can now easily add information to reflect the current state of the applicaion.

Furthermore, I'm hoping to have the webpage that is stored on the reposity serve as a live, up-to-date, documentation for the applicaion, that can be launched right from the help menu. And, and the same time, with subsequent releases of Winfile, a forzen version of these documents can be distributed with the binaries, allowing that particular release enjoy a fully offline copy of the help files, as they were at the time of the release. This can be especially useful in older computers without internet access.

I have not done extensive testing in all the differnt browsers, and, but it appears all desktop browsers are able to view the files perfectly fine. I have yet to test mobile browser compatibilities.

But that's where the community comes in. By having the help file out there and easily accessible, it can be improved quickly whereas, before, the documentation was trapped in propriotary file fomates that were difficult to read.

Best
@NazmusLabs
Copy link
Contributor

Thanks! Very much appreciate the changes! I'll close the original one, now that this is online! 😊

@craigwi
Copy link
Contributor

craigwi commented May 4, 2018

Question: what are the references to "Unknown" in the files? One appears to be an author statement.

@NazmusLabs
Copy link
Contributor

I used a tool to convert the Metadata included with the CHM file to HTML, and as the CHM files had some Metadata missing, the tool just put an "Unknown" there instead.

@thecatkitty
Copy link
Contributor Author

I have more than one question:

  1. Are we going to edit these docs in the near future?

  2. Are we going to replace Unknown with something or to drop it whatsoever?

  3. If we're going to expand the docs, we'll need to consider the whole format of them. What do we want them to be like?

  4. Are we going to translate the docs in the future, too?

  5. Aaand... A question which is recurring among other contributors and disputants: Do we have any broad vision of what we want to achieve? Are we going to deliver just a nice tool for the passionate, as a secondary file manager (just like a certain tool with the word Total in its name), or rather a full-fledged (but program-manager-less) Windows Explorer/File Explorer replacement capable of getting things done on Windows PE and Server Core?

@craigwi
Copy link
Contributor

craigwi commented May 30, 2018

I remain curious about 2 ("unknown") and 5 (the "big" question). I see WinFile as a "nice tool for the passionate". I use it as my primary file manager and so don't identify with the idea that it is a "secondary file manager".

However, my primary question is what features would a "full-fledged" explorer have that WinFile does not have? When I find things missing, I just add them.

@ad43
Copy link

ad43 commented May 30, 2018

I use it as my primary file manager and so don't identify with the idea that it is a "secondary file manager".

Well, what does functions does Win10 Explorer do that File Manager doesn't? Explorer removed the option to open 2 or more windows onto the file system and save the configuration. So perhaps File Manager should be able to save more than one window config (I mean MDI config) to make File Task management easier. Explorer adds ghost 'Library' and 'Network' etc entries to the filing system tree which are navigational aids and not actually files or folders. In my opinion they confuse things immensely and should reside in a Program Manager view or a My Stuff or Desktop view or a properly configurable and stable Start Menu, not in a File Manager.

I do enjoy the right-click Actions menu though.

Chris

@craigwi
Copy link
Contributor

craigwi commented May 31, 2018

I'm aware of what Win10 explorer does, but I don't understand what @thecatkitty means by "a full-fledged (but program-manager-less) Windows Explorer/File Explorer replacement capable of getting things done on Windows PE and Server Core?"

@thecatkitty
Copy link
Contributor Author

The main reason I've written such a thing was that I've been wondering if we want all the File Manager functionality to run properly in environments lacking the Explorer completely, like Server Core. If that is the case, there could be situations when re-inventing things would be needed.

@clzls
Copy link
Contributor

clzls commented Jun 2, 2018

@craigwi

I'm aware of what Win10 explorer does, but I don't understand what @thecatkitty means by "a full-fledged (but program-manager-less) Windows Explorer/File Explorer replacement capable of getting things done on Windows PE and Server Core?"

First, I think Windows PE here includes Windows Recovery Environment as well. Windows RE has no task bars, Start Menu, even explorer.exe process and so on. We certainly need a handy tool to manage it.
Second, I think these are some topics:

  • Plug & Play support;
  • Properties viewer (Rely on Explorer now);
  • Access security managements (Also rely on Explorer now; I'm not sure whether it is this name in English; maybe authority control or similar things that controls how a certain user/group can access certain file(s)...);
  • UNC path (winfile does not support UNC paths #99);
  • Help system;
  • Further thoughts (Making it a total replacement of Explorer.exe, but maybe not necessary, I think):
    • Power control: shutdown, reboot, ...
    • Format Drive and total disk operation support (Rely on Explorer now);
    • Task bars, Start Menu, ... or similar solutions;
    • Desktop icons, ...

I think that the lack of Plug & Play(not autorun, but the ability to detect new drive on the system) support for removable devices is the first topic of them all. You must restart winfile in order to access new devices under current version; that's quite unnatural.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants