MSGID: 1:18/200 6259f1de   
   CHRS: UTF-8 2   
   TZUTC: -0400   
   TID: MBSE-FIDO 1.0.8 (GNU/Linux-x86_64)   
   Hello All,   
      
   To say that MBSE's documentation is very outdated and in shambles is an    
   understatement so I have been quietly working on new documentation for MBSE    
   from HTML to PDF using LaTeX. It's not easy considering my health these days    
   and the use of a 28-year-old Model M keyboard that is shorting out and causing    
   random letters to appear from time to time but I am determined to get this    
   going   
      
   So what I do is I convert the HTML to LaTeX with pandoc and use TeXstudio and    
   Geany (to work with tables) to create the master document in TeX. I then call    
   pdflatex to create the PDF.   
      
   What is very nice is that the resulting PDF:   
      
    - Has a table of contents with hyperlinks within the PDF   
    - Has a very nice index for quick reference   
    - Is printable   
    - Is easily searchable   
      
   It is also much easier to update a TeX document than HTML.   
      
   I am right now just in the process of converting the HTML to TeX. I still    
   have a *LOT* of work to do just in that scope.   
      
   After I get the HTML converted, then I have to:   
      
    - Fix Michiel's bad English    
    - Rework many sections to be much easier to understand   
    - Add in important yet missing information (lots of that)   
    - Rewrite the DOS doors section for today's setup with DOSemu   
    - Add in a Linux-native doors section   
    - Add in all of the improvements that have been made   
    - Create new screenshots (need to get rid of that one screenshot that    
   discusses all the porn areas in Dreamland BBS)   
    - ...and much much more.   
      
   I have moved the global menu options and the ANSI/ASCII screen control codes    
   to their own appendicies which will make quick searching much, much easier. I    
   have also moved all of the open source licenses to their own appendicies.   
      
   I want to add in a LOT of more information, such as how to fully set up DOS    
   doors, how to set up file hatching, update the httpd and ftpd setup    
   documentation (it is badly out of date), Vince's log rotation script, et    
   cetera.   
      
   It is a very slow, deliberate process that will take me months right now. If    
   I get my Social Security and can afford to create a more comfortable    
   "operating position" with a modern Model M[1] keyboard and two larger    
   monitors, that will make things go much, much faster.   
      
   If anyone is interested in the current PDF, let me know privately and I will    
   make it available to you. It's still a huge mess. What is really killing me    
   is that Michiel did not use HTML tables in the current documentation and    
   creating tables in TeX/LaTeX is time-consuming.   
      
   But so far, so good. LaTeX does a wonderful job with formatting and making    
   the new documentation look so much nicer.   
      
   Once I get this project to a stable condition (I will never say "done"), I    
   want to convert the LaTeX to Markdown and put the entire documentation into    
   the project's wiki on the Sourceforge site.   
      
   After that, I want to work on making MBSE create HTML 5-compatible webpages    
   and make the look of the webpages somewhat customizable through the use of a    
   configuration file. The pages MBSE creates will still be static but they will    
   be modern and can take advantage of the modern features of HTML 5.   
      
   An example of what I am talking about is my own BBS website at    
   http(s)://outpostbbs.net -- I use HTML 5 and CSS Level 3 + SVG to create the    
   dropdown menu and handle the page layout. For those worried about text-based    
   browsers such as links and Lynx, the site still works though it's not quite    
   as "pretty". I test my websites using links2 in text and graphics modes and    
   Lynx.   
      
   Sorry for the long post but there's a lot going on for me.    
      
   -- Sean   
      
   ... Documentation: the worst part of programming!   
   --- GoldED+/LNX 1.1.5-b20180707   
    * Origin: Outpost BBS (MBSE BBS Dev Team) (1:18/200)   
   SEEN-BY: 1/110 123 15/0 18/200 90/1 105/81 106/201 120/340 123/131   
   SEEN-BY: 129/305 330 331 153/7715 218/700 226/30 227/114 229/110 111   
   SEEN-BY: 229/206 317 400 424 426 428 452 550 664 700 266/512 282/1038   
   SEEN-BY: 292/854 317/3 320/219 322/757 342/200 396/45 460/58 633/280   
   SEEN-BY: 712/848   
   PATH: 18/200 229/426   
      
|