% .... % % Usually you don't have more than one body or header, so ID should be % sufficient. % % Problem 04: %! Style: one.css %! Style: two.css % I have ordered to use two CSS, but only the second is used. % It's not uncommon to use several CSS files on a page, considering they are % modular and reusable. % Problem 05: % % % Why? The default should probably be better than ours (if someone has changed % it, it's because he/she wants to). % Also, the colors are part of the design and should be set on the CSS. % So: just % Problem 06: % % I think that html and xhtml should behave exactly the same, except % for the DOCTYPE, the character set, and the % So: both in lower case, and both closing all tags. That's simpler than the % old HTML, and easier to process by parsers and browsers. % Also, lower case tag compress better with gzip and is easier to read/write. % - a - b - % so this should be %

% % (closing all tags).

and

in the same line probably look better % Problem 07: % Look just after the list, above. % Why is there a

inserted? It happens a lot, and is unnecessary. here, too: see? % Also at lists, etc. 'grep' the output for it. % Problem 08: % When using -t xhtml: % The default character set for XHTML is UTF-8, so, if no other character set % is specified, shouldn't txt2tags transform the characters? % Or, at least, specify that the character set is not UTF-8, but the one % you're using. Some strange characters here, to test: ñ á è í ò ú. % Problem 09: % When the previous bugs are fixed, I think it's worth to change from % HTML Transitional to HTML Strict, and make our browsers stop rendering pages % in Quirks Mode (it's simpler in Standards Compliant Mode, at least for HTML). % The HTML Validator will say which more things need to be fixed. % Problem 10: % Each page is supposed to have just one

heading. It's normally the title % of the page, just as txt2tags is doing. % http://www.htmlhelp.com/reference/wilbur/block/h1.html % http://www.htmlhelp.com/reference/wilbur/block/h2.html % % So the sections are

, and the subsections are

, etc. + This should be a h2 + ++ This, a h3 ++ + h2 again + % (Just avoiding "=", and using "==" or "++" to mean "sections", doesn't work: % the TOC doesn't assign correct section numbers then.) % Headers are used to make a tree of the document, and should not be used just % to put text in big letters. Some browsers (like Amaya) are able to create the % table of contents of the page by reading the headers. % So the structure for a page is: % % title H1 % % - section H2 % - section H2 % - subsection H3 % - subsection H3 % - subsubsection H4 % - section H2 % etc. % % Problem 11: % I think that //a// should be a, and a should % be a % It's easier to apply styles this way, and has more semantic meaning. It's % very absurd to have a CSS rule saying "the italic text should not appear % italic" and things like that. % and are getting deprecated. As for : well, it's not recommended % to underline text which are not links; usually you mean emphasis, so use % or (stronger emphasis), and if you want the underline, say in the CSS % text-decoration:underline % Maybe these //emphasis// and strong emphasis can be just for the % "with CSS" mode. % Problem 12: = [this is a link section1.html] = = This is a //test// = Doesn't work. Neither in the title (first line). % Problem 13: % Some browsers (e.g. Mozilla, Firefox) don't show empty cells () % So if the table has border, maybe we should add || a | b | c | | 1 | 2 | | | 4 | | | | | | 9 | || a | b | c | d | e | | 1 | | | | 5 | | 6 | | | | 10 | % Problem 14: As suggested by Bruce Who at the mailing list: Line 1 of blockquote. Now, an empty line. It should insert
Line 4 of blockquote. End. This should be different to: Line 1 of blockquote. Line 2 of blockquote. End. Line 1 of second blockquote. End. ------------------------ % Problem 15: % According to the HTML spec, a
(definition description) can contain % any element, including more lists : title1 paragraph one paragraph two - first element of the list - second element of the list - third element of the list - paragraph three. : title2 Second description. : % Yes, I once needed to do that, it can be useful to avoid using headers % Problem 16: It's so easy to leave a list open! - a - b - c Oh, I forgot that about the two blank lines again! I would try to remember to close lists just with the "blank item" method - a - b - c - Right. I think it's a good practice; couldn't this be the "official" method? (the most explained in the docs, used in the examples, etc.) % Problem 17: some translations are excessively funny % Por el padrón, la salida convertida es ahorrada 'infile.'. % By the census, the converted output is spared/reserved 'infile.'. % Oculta e-mails del Robustezas del Spam % Hide e-mails from Spam's Robustnesses % Títulos del número % Titles of the number % well, I don't mind that, nor have the time to fix it... % Problem XX: no more problems found. % But I will try to solve this... % New! 26 August: % Problem 18: =a=[i] % Generates: % %
a
% % But it's better %
a
% since it's the H1 who is really being tagged % Problem 19: % in the TOC, rather than doing: %
%
1. aaaaa %
2. bbbbbb %
% .... % % etc, it would be better to use
directly and thus solve the problems of sections named like 0.0.1, which appear if you use +++title3+++ but not +title1+ and ++title2++ % Problem 20: % Python 2.1.3, txt2tags 2.0 (the latest version for Debian) on Debian Woody % % txt2tags % /usr/bin/txt2tags:3689: SyntaxWarning: local name 'name' in 'target_name2key' shadows use of 'name' as global in nested scope 'lambda' % def target_name2key(self): % txt2tags: Error: Missing input file (try --help) % % % The code is something like: % % def target_name2key(self): % name = self.target_name.get() % target = filter(lambda x: TARGET_NAMES[x] == name, TARGETS) % try : key = target[0] % except: key = '' % self.target = self.setvar(key) % % % I have read that Python<2.2 doesn't support nested scopes. I don't know Python, but this seems to solve it: % % def target_name2key(self): % name = self.target_name.get() % def fufufu (x,name): return TARGET_NAMES[x]==name % target = filter(fufufu, TARGETS) % % % Can you make txt2tags work in old versions of Python? They are still used. % % New: 5th March 2006 % % Problem 21: % % The syntax of txt2tags has changed over time, adding more and more features; for instance an empty item to close a list in 2.1. % These features do not work in older versions, and for instance t2t 2.0 will do very strange things if it processes a 2.1 file. % % So I need an option to write inside a file "This file requires txt2tags 2.1 or newer to work correctly". % Something like %!require: 2.1 %

aaa

aaa

bbb

ccc

heading. It's normally the title % of the page, just as txt2tags is doing. % http://www.htmlhelp.com/reference/wilbur/block/h1.html % http://www.htmlhelp.com/reference/wilbur/block/h2.html % % So the sections are

, and the subsections are

a

a