Page 2 of 7

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sat Oct 08, 2016 9:36 am
by Derek_Stewart
Hi Rich,

I have resent the email to you and Norman.

I have used the sales email for you.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sat Oct 08, 2016 2:32 pm
by RWAP
Derek_Stewart wrote:Hi Rich,

I have resent the email to you and Norman.

I have used the sales email for you.
Many thanks - no sign of the original email last year - oh well...

The beauty of the approach used by Norman is that if anyone edits the document on github, it will get built into HTML, PDF and ePub formats automatically - you can access these from the one webpage - http://superbasic-manual.readthedocs.io/en/latest/

Click on read the docs at the bottom of the left hand menu to access the various formats.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sat Oct 08, 2016 7:28 pm
by NormanDunbar
Hi Derek,

Thanks for the epub. I could have saved months of lunchtimes at work if I'd known! :-)

My version has taken the original html created by a Text printer driver, cleaned it up, converted it to RestructuredText and then built html from that.

Rst as it is known, and Pandoc or better, Sphinx doc, can convert from Rst to just about anything.

My GitHub repository is configured so that any time anyone pushes to it, to force a build at Read the Docs. That will create online and downloadable html, pdf and epub with the latest amendments.

Feel free to fork me! (That wasn't a euphemism by the way ;-) )

There are still a few todos to sort out but the vast majority of the conversion has been done over the past few months.

Cheers,
Norm.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sat Oct 08, 2016 8:43 pm
by NormanDunbar
Text 87, obviously.
Damned auto correct!

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sat Oct 08, 2016 10:58 pm
by Derek_Stewart
Hi Norman,

I just dumped the Web site and converted the html files in Sigil. There was a few CSS style errors, but it was anot easy conversion.

I updated the SMQ/E Ref Manual in Libreville Office / PDF, which Wolfgang had on his Web site. I really wanted the manual in Epub format. But the ODT file format to Epub is not good conversion. Nedd a lot of manual conversion.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sun Oct 09, 2016 10:12 am
by NormanDunbar
Hi Derek,

Having run html tidy against the original html files, there were a lot more than a few CSS errors!

Program code had <>& etc which needed to be escaped as the lines were just italic paragraphs, not in pre tags. The ampersands also caused Basic strings to be considered as html entities too. Illegal ones.

Headings with line feeds in.

Br tags with a url attached which should have been a tags, etc, etc.

The tables were all over the place. Have a look at the table of printer types in your epub sdp_key section, for example.

Hopefully, now, most things are good. Knowing the internal format of Text87 files would have been a better way to extract the text and formatting, but it was not to be, so we have to work with what we had. The output from a printer driver.

Cheers,
Norm.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Sun Oct 09, 2016 12:16 pm
by Derek_Stewart
Hi Norman,

I optimised the epub file to be viewed on a Kindle. Since it looked OK, I did not delve too much into the it.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Mon Oct 10, 2016 9:10 am
by Derek_Stewart
HI Norman,

I checked the converted epub file to azw3 on the Kindle, it seemed to read okay, maybe I did not alter the HTML files much. Checking the epub file in Sigil, gave no errors on the HTML structure. Since this was really for my benefit, I am happy with the result.

My ebook is a snapshot of manual at that time and does not take in account any updates, which your system does.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Tue Nov 01, 2016 9:21 pm
by NormanDunbar
Evening all,

I've done some more work on the SuperBasic Online Manual. Some of the introductory chapters and appendices had formatting errors in that lines of code were rendering as plain text. These have been fixed.

I also took the liberty of adding DJToolkit version 1.16, the latest version, to the manual. Well, if I can't blow my own trumpet .....

As usual, the build is automatic and there is html, pdf and epub files to download if you want your own local copy.

Enjoy.


Cheers,
Norm.

Re: SBASIC / SuperBASIC Reference Manual Online

Posted: Mon Nov 07, 2016 1:32 pm
by NormanDunbar
QPC commands gave been added to the SuperBasic Online Manual.

Cheers,
Norm.