[<<] [<] Page 1 of 1 [>] [>>] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subject:
Various lists used in DocBook
From: Kian Spongsveen ####@####.#### Date: 22 Jul 2003 17:19:51 -0000 Message-Id: <200307221925.15525.sybase@kian.org> I am gradually picking up speed writing my HowTo. Now I have a list that I need some suggestions on. I'm using DocBook XML. Hope that's not too off-topic here, let me know where to post if I'm wrong. Basically, I want to describe a set of known problems, their symptoms, the cause behind and the workaround / kludge to avoid the problems. I want these as a list where the actual problem is the most important part, but I also want the other sections in a systematic order. It will be a list with short paragraphs, but several such "problem" points. I want it to look something like: Problem: Product does not install Symptom: Screen is blank Cause: The power is off Solution: Find the power switch, set it to ON position Solution2: Plug the power cord into the wall outlet The words Problem, Symptom and Cause will be emphasized bold and there will only be one of each of these first 3 items. Then there may be one Solution item, or several. I tried to use the <itemizedlist>, but that creates bullet points and makes each such section more or less become continuous with the next. I tried to use <variablelist>, but I get some complaints from my editor (jEdit with XML plug-in), and sometimes from xsltproc, when I use multiple <listitem> and/or <term> tags within each <varlistentry> section. So, which type of list that is supported by TLDP should I use for this? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subject:
Re: Various lists used in DocBook
From: Charles Curley ####@####.#### Date: 23 Jul 2003 15:47:49 -0000 Message-Id: <20030723154725.GB7323@charlescurley.com> On Tue, Jul 22, 2003 at 07:25:15PM +0200, Kian Spongsveen wrote: > I am gradually picking up speed writing my HowTo. Now I have a list that I > need some suggestions on. I'm using DocBook XML. Hope that's not too > off-topic here, let me know where to post if I'm wrong. This discussion should probably be on the docbook list rather than the discuss list, so I'll CC it there as well. If you haven't already joined it, you may want to do so so that you can get reponses. > > Basically, I want to describe a set of known problems, their > symptoms, the cause behind and the workaround / kludge to avoid the > problems. I want these as a list where the actual problem is the > most important part, but I also want the other sections in a > systematic order. It will be a list with short paragraphs, but > several such "problem" points. > > I want it to look something like: > > Problem: Product does not install > Symptom: Screen is blank > Cause: The power is off > Solution: Find the power switch, set it to ON position > Solution2: Plug the power cord into the wall outlet > > The words Problem, Symptom and Cause will be emphasized bold and > there will only be one of each of these first 3 items. Then there > may be one Solution item, or several. If you are still specifying bold and other formatting characteristics, then you are new to SGML/XML. These tools separate formatting from content. Writers write content, style sheet authors specify formatting. You as an author have to leave the choice of bold or not, ital or roman, to the style sheet. > > I tried to use the <itemizedlist>, but that creates bullet points > and makes each such section more or less become continuous with the > next. > > I tried to use <variablelist>, but I get some complaints from my > editor (jEdit with XML plug-in), and sometimes from xsltproc, when I > use multiple <listitem> and/or <term> tags within each > <varlistentry> section. > > So, which type of list that is supported by TLDP should I use for > this? TLDP supports anything your docbook tools will support. I suggest a table, three columns, like so: Problem & Causes Solution 1 Symptom Solution 2 ... Solution N With blank cells in the first two columns where you have multiple solutions. Tables are very sophisticated and very powerful in docbook, much more so than HTML. You should be able to get what you want. -- Charles Curley /"\ ASCII Ribbon Campaign Looking for fine software \ / Respect for open standards and/or writing? X No HTML/RTF in email http://www.charlescurley.com / \ No M$ Word docs in email Key fingerprint = CE5C 6645 A45A 64E4 94C0 809C FFF6 4C48 4ECD DFDB --> --> |
<type 'exceptions.IOError'> | Python 2.5.2: /usr/bin/python Mon Jul 8 01:26:39 2024 |
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 0x87fcc6c> |
/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.showthread' from '/opt/ezmlm-browse-0.20/commands/showthread.pyc'>, module.do = <function do at 0x87ffbc4>, global ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'} |
/opt/ezmlm-browse-0.20/commands/showthread.py in do(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}) |
9 ctxt.update(ezmlm.thread(ctxt[THREADID])) |
10 header(ctxt, 'Thread: ' + ctxt[SUBJECT], 'showthread') |
11 do_list(ctxt, 'msgs', ctxt[MSGSPERPAGE], ctxt[MESSAGES], |
12 lambda:sub_showmsg(ctxt, ctxt[MSGNUM])) |
13 footer(ctxt) |
global sub_showmsg = <function sub_showmsg at 0x87fc1ec>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum' |
/opt/ezmlm-browse-0.20/globalfns.py in do_list(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, name='msgs', perpage=10, values=[{'author': u'Kian Spongsveen', 'authorid': 'ibenkdkilhallhmecihm', 'date': '22 Jul 2003 17:19:51 -0000', 'month': 200307, 'msgnum': 4756, 'subject': u'Various lists used in DocBook', 'threadid': 'bcmihcgammggkadnilpp', 'timestamp': 1058894391.0}, {'author': u'Charles Curley', 'authorid': 'fbacfjfdkmpbdhgmbbhp', 'date': '23 Jul 2003 15:47:49 -0000', 'month': 200307, 'msgnum': 4761, 'subject': u'Re: Various lists used in DocBook', 'threadid': 'bcmihcgammggkadnilpp', 'timestamp': 1058975269.0}], peritem=<function <lambda> at 0x8806b8c>) |
128 write(template % ctxt) |
129 if peritem: |
130 peritem() |
131 ctxt[ROW] += 1 |
132 |
peritem = <function <lambda> at 0x8806b8c> |
/opt/ezmlm-browse-0.20/commands/showthread.py in |
9 ctxt.update(ezmlm.thread(ctxt[THREADID])) |
10 header(ctxt, 'Thread: ' + ctxt[SUBJECT], 'showthread') |
11 do_list(ctxt, 'msgs', ctxt[MSGSPERPAGE], ctxt[MESSAGES], |
12 lambda:sub_showmsg(ctxt, ctxt[MSGNUM])) |
13 footer(ctxt) |
global sub_showmsg = <function sub_showmsg at 0x87fc1ec>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum' |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=4761) |
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 0x87fc1b4>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0x86e898c> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x86e898c>, 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 0x87fc1b4>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0x885f48c> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x885f48c>, 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 0x87fc144>, ctxt = {'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0x885f48c> |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'HTTP_X_FORWARDED_SERVER': 'glitch', 'HTTP_REFE...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x885f48c>) |
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 0x87f4e9c>, global html = <function html at 0x87f4ed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x8861250> |
/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 0x87f4e9c>, 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 0x878da7c>, 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 0x8857fac>, 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 0x8857fac>, 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'