Old StructuredText discussion on zwiki.org. See also StructuredTextWiki:StructuredTextDiscussion.


Question: in StructuredText, how do I make lists without spaces between the items ?

Question: StructuredText gurus: why does it replace (blank line)Thanks.(text), below, with "1." ???

Thanks. blah blah

Structured text decides that "Thanks. blah blah" is some kind of numbered thing. This is a missfeature. ;) --JimFulton

Thanks!

Hmm, well I added it to TextFormattingSurprises earlier today. Is it fixable? --MattBehrens

You could limit the conversion rule from (something like) "spaces then letters or digits and dot" to "some limited number of digits or alphanumerics", say 3; how many 3-letter words can be in that position? You could furthermore try to recognise words, say an uppercase letter first then a lowercase. Of course, you can always fool any rule. --DanielCalvelo

I have to see how this is translated. There were rules for example formatting using PRE tags; I was translating that to PHP and run into trouble. Let's say we have a list:

A-hem. Ok, examples were removed. --DanielCalvelo

I wish it was easier to make multi-level headings. Documents I write tend to have an outline structure:

  1. Introduction
  2. 1 Subsection of introduction

etc.

I understand that I can indent paragraphs to have StructuredText make headings for me. However I'm finding I just use HTML header directives instead. I propose the following kind of extension to structured text (which I'm going to add to my zope when I get a chance):

*1 for 1st level heading

*2 for 2nd level heading, etc, etc.

comments? --MichaelWangHelmke

Sounds good to me. Add this idea to the StructuredTextWiki.

What would you think of " first level heading" to mark "first level heading" as a first level heading and ". second level heading" for a second level heading. The idea is getting the level by counting followup dots. Which integrates nicely with additional section numbering like in the above example. (When adding a dot after "1.1") --BeWo

I (BillSeitz) wish URL recognition were more robust

breaks at the end of the page, eh - thanks, we'll need to add a test and fix. The third example is a StructuredText weakness I believe - it's less accepting of unusual url characters. --SM

todo: capture on ZwikiProblems

Test

Making an object persistent in Zope is supposed to be trivial. All you have to do is inherit the Persistent class:

 # person.py
 import ZODB
 from Persistence import Persistent
 class Person(Persistent):
     "Person class."
     def __init__(self, name):
         self.name = name

Why, dear gods, in the previous example does wiki add the html begin comment tag?! This is driving me insane!

Good question. See answer just added over on StructuredTextRules?.

Fixed in 0.9.4.

Simon Michael <simon@joyful.com>, Sat, 10 Nov 2001 12:46:03 -0800 (via mail):

Hey, thanks for this Jens. Interesting stuff. I am archiving it on http://zwiki.org/StructuredText. Regards, --Simon

Jens Quade <jq@jquade.de> writes:
> Hi,
>
> I played with ZWiki 0.95 today, trying to fix some StructuredText
> problems, especially I needed a version without SGML/HTML passing.
>
> Zwiki's structuredtextonly text format quotes HTML, which
> StructuredTextNG also does. But this generates &lt;s in the
> resulting html..
>
> So I created my own document class and added a hook in ZWikiPage.py
> to use it for structuredtextonly pages.
>
> http://www.zope.org/Members/jim/StructuredTextWiki/CreatingCustomStructuredText
>
> This patch also handles level correctly, the current
> StructuredText's HTML function seems to ignore the level argument.
>
> http://www.zope.org//Members/jim/StructuredTextWiki/CurrentIssues
>
> The patch is attached, I hope you'll find it useful.
>
> regards,
> jens

zwdiff


comments:

Wiki links inside tables --Miguel, Wed, 19 Nov 2003 09:53:07 -0800 reply
I am trying to define tables using structured text with links inside.

When I create tables in structured text, it works fine. But if I put Wiki links (i.e. words between []) inside the table, it render badly the tables. Is there a solution?

Excuses by my english, best regards, MIGUEL

Wiki links inside tables --DeanG, Wed, 19 Nov 2003 10:50:19 -0800 reply
please provide an example

Wiki links inside tables --DeanG, Wed, 19 Nov 2003 10:50:34 -0800 reply
please provide an example

definition lists --DeanGoodmanson, Wed, 19 Nov 2003 13:33:47 -0800 reply
Definition lists require whitespace before and after the --. Adding that information to the StructuredTextInZwiki looked horrible so I didn't save it.

expressing links --DeanGoodmanson, Wed, 19 Nov 2003 13:35:34 -0800 reply
The following line baffles me:

 "[Square brackets]":#squarebrackets : (Discouraged!) Usually turn anything into a wiki ref.

..especially odd as the old link behavior is no longer supported. (I think..)

Wiki links inside tables --Miguel, Thu, 20 Nov 2003 05:23:31 -0800 reply

This is a better example, excuses by the previous one

[...]? I have deleted the examples because they crashes this pages. I supose you have received them by mail

Wiki links inside tables --DeanGoodmanson, Thu, 20 Nov 2003 07:25:42 -0800 reply
Examples ...

This is ok:

 |---------|
 | a   | b |
 |=========|
 | c   | d |
 |---------|

This is not ok:

 |---------|
 | a   | b |
 |=========|
 | [c] | d |
 |---------|

Wiki links inside tables --SimonMichael, Thu, 20 Nov 2003 11:29:39 -0800 reply
Thanks.. the problem here was a recent refactoring-related bug, now fixed for 0.25. Also I fixed the formatting of STX errors so they now display nicely (they used to break the page. ) Miguel, if you want try the latest CVSRepository and let me know if there's still a problem.

Wiki links inside tables --Miguel, Wed, 26 Nov 2003 02:09:38 -0800 reply
I have tested the same example with the CVSRepository version and I have found the same problem.

Wiki links inside tables --simon, Wed, 26 Nov 2003 08:37:23 -0800 reply
You may need to force that page to re-render - try visiting PAGE/clearCache.

Where to hack --DeanG, Mon, 08 Dec 2003 10:52:11 -0800 reply
Where's the code points in Zwiki to patch/hack STX?

I'm trying to reduce the number of Number hits, and I think this may have already been done a bit to avoid the "p. s." problem.

p. s. Test

re: Where to ^h patch --DeanGoodmanson, Mon, 08 Dec 2003 11:28:04 -0800 reply
I've found what I need to modify in STX DocumentClass.py, but I'm not sure how to patch at the Zwiki level.

Utils.py and MyDocumentClass? seems to be a point, is it the point?

Can you describe how to include a patch in Utils.py?

re: Where to ^h patch --Simon Michael, Tue, 09 Dec 2003 15:11:31 -0800 reply
DeanGoodmanson wrote:

Utils.py and MyDocumentClass? seems to be a point, is it the point?

MyDocumentClass? is a good place for real STX customization - modifying what STX actually does. But there's a place above that for quick hacks, when you don't want to get involved with all that. That's where I tried to fix this problem before. See stxToHtml in PageTypes?.py I believe.

Can you describe how to submit a patch?

Does HowToPostPatches? have the info ?

re: Where to ^h patch --DeanGoodmanson, Tue, 09 Dec 2003 15:59:19 -0800 reply
Heh. I changed my general question to a more specific one, after email sent out. The stxToHtml I think answers my question, how to hack STX at the Zwiki level.

... -- Thu, 22 Jan 2004 02:42:15 -0800 reply

Headings -- Thu, 22 Jan 2004 02:43:41 -0800 reply
Is it at all possible to create headings and indented sub-headings. How do I do it?

Headings --Simon Michael, Thu, 22 Jan 2004 04:25:45 -0800 reply
In StructuredText you create headings with a single-line paragraph followed by a more-indented paragraph. See the STX docs or the examples throughout this site. For getting indented text, here are some options:

Apostrophe code tag grrrr --DeanGoodmanson, Tue, 02 Mar 2004 14:26:52 -0800 reply
There's many times I'm happy with the apostrophe escape, in far too many cases it bites me. Not for "''" examples, nor "where fld = 'val'"..where I'd like the whole block in a code tag.

I'd like to replace it with the back-tick. Any social or pythonic thoughts on this one?

Apostrophe code tag grrrr --SimonMichael, Wed, 03 Mar 2004 08:50:34 -0800 reply
I think it would be an improvement for STX. People often want to use ' for their own purposes. Deviating from standard STX has a cost, but I think it would be worth offering this at least as a zwiki option.

wikilink escape surprise --DeanGoodmanson, Mon, 10 May 2004 12:37:07 -0700 reply

Paragraph Heading

!I would not like to see WikiLinks? here. HMMmmm?

(This entry will be removed if it works properly on this version of ZWiki.

wikilink escape surprise --DeanGoodmanson, Wed, 12 May 2004 08:00:40 -0700 reply
Workaround: The exclamation point escape isn't considered part of the paragraph.

Paragraph Heading

I would not like to see WikiLinks? here. HMMmmm?:

   Paragraph Heading

   ! I would not like to see WikiLinks? here. HMMmmm?