I sent a separate email to Willi that included screenshots (the list doesn't like screenshots) but I wanted to repeat this thought with the list:
>> BTW, I created my own index.htm file and ran a few tests. HTML Help supports HTML coding structures - this is awesome! I honestly don't remember if HTML Help supported that previously, so maybe this isn't new. But it makes me wonder: Do we need to use <pre> to format everything "manually"? I tried with tables, and tables don't work .. and that's okay, tables are hard in plain text. So I guess we'd need to use <pre> to format lists of links in columns. But I think most use cases could use standard HTML tags for headings, paragraphs, lists, bold, italics, links, .. I think using standard HTML would make the pages easier to maintain, and easier for others to contribute. I teach a university class called Tech Writing with Digital Technologies where the students learn to code in HTML (and other tools). Students are always looking for projects [for example, to add to their resume] and I'm confident we could get a few students to help update/clean up the HTML Help documentation. One project could be to adapt it to standard HTML for us - we could define the rules to make things more reliable for rendering, such as "only use <h1> and <h2> [two levels of headings], <p> [paragraphs], <a> [links], <ul> and <li> [unordered lists only], <i> and <b> [italics and bold], <pre> [preformatted, like for lists or sample program output] and <code> [inline code, such as program names that aren't links]." On Sat, Jul 8, 2023 at 11:24 AM Wilhelm Spiegl via Freedos-devel <[email protected]> wrote: > > Hi, > meanwhile FDT2307 is published with Bernds new htmlhelp.exe. > It includes the actual unfinished english version 1.1.0 of help, other > languages are in version 1.0.8. > With mail at: > https://www.mail-archive.com/[email protected]/msg14794.html > I asked you to help me at the following questions: > > > Help 1.1.0 is coming into a stadium where I have to ask you all > > Please have a look at: > https://www.bootablecd.de/FreeDOS-Internet-version/help110/en/index.htm > or execute htmlhelp on a HD installed with FDT2307 live CD. > My questions: > a) Do I have to add a file? > b) Do I have to remove a file (e.g. xdvd2 - no GPL... etc...)? Are the > commands in [square brackets] necessary or can I remove some of them? > c) Are there problems with the sort order of the commands? I did not put them > exactly in the main folders as it listed at gitlab. > d) Can somebody proofread the different commands? As I am no programmer I > have to use the manuals or ask the programmers > or this forum - and I often get no response. This is frustrating. > e) I mixed utils, drivers, unix tools etc. because otherwise people will have > to search in different alphabetical lists and reduces the chance to > find it in a short time. > f) I added usbdos, but examples are still bad and there is a comment from > Berki that it may be not legal to distribute it. > Nobody gave a response to him. What to do? > g) Other ideas? > > Please keep in mind that this is a WYSIWYG project, means: If you do not > correct things where you think they are wrong NOW they will > stay wrong for a long time! > > Then it's not my disgrace, it's yours! > > > Thanks for feedback! > > > Willi > _______________________________________________ > Freedos-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/freedos-devel _______________________________________________ Freedos-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/freedos-devel
