discuss: Some ideas for TLDP


Previous by date: 9 Jan 2016 12:17:28 +0000 Re: RTC Quickstart Guide into TLDP?, Daniel Pocock
Next by date: 9 Jan 2016 12:17:28 +0000 Re: Some ideas for TLDP, Daniel Pocock
Previous in thread:
Next in thread: 9 Jan 2016 12:17:28 +0000 Re: Some ideas for TLDP, Daniel Pocock

Subject: Some ideas for TLDP
From: "J. S. Evans" ####@####.####
Date: 9 Jan 2016 12:17:28 +0000
Message-Id: <5481365.QxDa14rpdB@localhost.localdomain>

Hi all,

Where is TLDP today?  Looking at the site, I see some really good information 
and a lot of info that is plainly outdated.  Really, when was the last time 
anyone needed a guide for setting up a 3-button serial mouse in Linux? I 
wonder if it is time to see some changes to the site and introduce new 
content.

Some suggestions & talking points:

- Move away from DocBook 4 to something a little more modern and preferably 
user friendly like LyX.

I'm sure someone will bring this up from the FAQ (written in 2004)

Q: DocBook is too hard to learn for a LyX user like me. Why do you use it?

A: It's not just LyX users that say this, but here's the answer... There are 
hundreds of documents in our collection. We have one set of scripts to convert 
each of these documents into human-readable formats (HTML, PostScript and 
PDF). We use these scripts not only to save time, but also to keep our 
collection visually similar, as requested by many of our readers (read 
http://ask.slashdot.org/article.pl?sid=04/03/30/0041253 for more information. 
DocBook is a very descriptive markup language specifically desgined to describe 
technical documentation. Always under active development, DocBook is be used 
to output a variety of formats, including HTML pages, slide shows, PDF and 
PostScript for printed materials. We are always interested in hearing about 
scripts or tools for converting text to DocBook. Please read the Author Guide 
and contribute your ideas to the "Discuss" mailing list. LyX users should also 
read http://www.teledyn.com/help/XML/lyx2db/t1.html for more information.

The problem with this is that DocBook 4 is really friggin old.  No, you can't 
export LyX or OpenOffice/LibreOffice to it anymore because it is an outdated 
version of the DocBook standard.  Rather than rewriting the scripts to use 
DocBook 5, why not find a better standard?

- Find a way to grow enthusiasm for the project. Looking at the stats for the 
existing mailing lists, it looks like most of them haven't had any new traffic 
in years.  Some going back to 2008 and before. TLDP is an amazing idea, why 
aren't we utilizing it for it's maximum value?

- Articles, books, guides, etc that are > 5 years old from the present should 
be put into an archives section of the site, but never ever deleted.  Who 
knows when some poor slob really will need to use a 3-button serial mouse? 
Information is always needed, but it doesn't need to be on the front page.

- Replace pluckerDB with epub.  It just makes sense.

What I love about TLDP is the same as what I love about Linux, the GPL, and 
free software. I love the fact that there are no ads.  Never change that.  The 
site is smooth and easy to navigate. Mostly what I propose is to see more 
content and make it easier for that content to be added.

Best Regards,
J.S. Evans

--> -->
 
 
<type 'exceptions.IOError'>
Python 2.5.2: /usr/bin/python
Mon Oct 3 03:30:05 2022

A problem occurred in a Python script. Here is the sequence of function calls leading up to the error, in the order they occurred.

 /opt/ezmlm-browse-0.20/<string> in ()
 /opt/ezmlm-browse-0.20/main.py in main()
  424 
  425         if path is not None:
  426                 main_path(path)
  427         else:
  428                 main_form()
global main_form = <function main_form at 0x89b6c6c>
 /opt/ezmlm-browse-0.20/main.py in main_form()
  378         except ImportError:
  379                 die(ctxt, "Invalid command")
  380         module.do(ctxt)
  381 
  382 def main():
module = <module 'commands.showmsg' from '/opt/ezmlm-browse-0.20/commands/showmsg.pyc'>, module.do = <function do at 0x89cb3ac>, global ctxt = {'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}
 /opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'})
   18         write(html('msg-pager') % ctxt)
   19         write('<hr>')
   20         sub_showmsg(ctxt, ctxt[MSGNUM])
   21         write('<hr>')
   22         write(html('msg-pager') % ctxt)
global sub_showmsg = <function sub_showmsg at 0x89b61ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, global MSGNUM = 'msgnum'
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, msgnum=12696)
  229         format_timestamp(ctxt, ctxt)
  230         write(html('msg-header') % ctxt)
  231         rec_showpart(ctxt, msg, 0)
  232         write(html('msg-footer') % ctxt)
  233         ctxt.pop()
global rec_showpart = <function rec_showpart at 0x89b61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, msg = <email.message.Message instance at 0x8a3114c>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, part=<email.message.Message instance at 0x8a3114c>, partnum=1)
  205                 else:
  206                         for p in part.get_payload():
  207                                 partnum = rec_showpart(ctxt, p, partnum+1)
  208         else:
  209                 write(html('msg-sep') % ctxt)
partnum = 1, global rec_showpart = <function rec_showpart at 0x89b61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, p = <email.message.Message instance at 0x8a314ac>
 /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, part=<email.message.Message instance at 0x8a314ac>, partnum=2)
  208         else:
  209                 write(html('msg-sep') % ctxt)
  210                 sub_showpart(ctxt, part)
  211         return partnum
  212 
global sub_showpart = <function sub_showpart at 0x89b6144>, ctxt = {'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, part = <email.message.Message instance at 0x8a314ac>
 /opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 0, 'HTTP_X_FORWA...set': 'utf-8', 'HTTP_ACCEPT_ENCODING': 'br,gzip'}, part=<email.message.Message instance at 0x8a314ac>)
  164         type = ctxt[TYPE] = part.get_content_type()
  165         ctxt[FILENAME] = part.get_filename()
  166         template = html('msg-' + type.replace('/', '-'))
  167         if not template:
  168                 template = html('msg-' + type[:type.find('/')])
global template = <function template at 0x89aee9c>, global html = <function html at 0x89aeed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x8a2fad8>
 /opt/ezmlm-browse-0.20/globalfns.py in html(name='msg-application-pgp-signature')
   40 
   41 def html(name):
   42         return template(name + '.html')
   43 
   44 def xml(name):
global template = <function template at 0x89aee9c>, name = 'msg-application-pgp-signature'
 /opt/ezmlm-browse-0.20/globalfns.py in template(filename='msg-application-pgp-signature.html')
   31         except IOError:
   32                 if not _template_zipfile:
   33                         _template_zipfile = zipfile.ZipFile(sys.argv[0])
   34                 try:
   35                         f = _template_zipfile.open(n).read()
global _template_zipfile = None, global zipfile = <module 'zipfile' from '/usr/lib/python2.5/zipfile.pyc'>, zipfile.ZipFile = <class zipfile.ZipFile at 0x8947a7c>, global sys = <module 'sys' (built-in)>, sys.argv = ['-c', '/opt/ezmlm-browse-0.20']
 /usr/lib/python2.5/zipfile.py in __init__(self=<zipfile.ZipFile instance at 0x89bae4c>, file='-c', mode='r', compression=0, allowZip64=False)
  337             self.filename = file
  338             modeDict = {'r' : 'rb', 'w': 'wb', 'a' : 'r+b'}
  339             self.fp = open(file, modeDict[mode])
  340         else:
  341             self._filePassed = 1
self = <zipfile.ZipFile instance at 0x89bae4c>, self.fp = None, builtin open = <built-in function open>, file = '-c', modeDict = {'a': 'r+b', 'r': 'rb', 'w': 'wb'}, mode = 'r'

<type 'exceptions.IOError'>: [Errno 2] No such file or directory: '-c'
      args = (2, 'No such file or directory')
      errno = 2
      filename = '-c'
      message = ''
      strerror = 'No such file or directory'