help links subscribe changes refresh edit

	HelpPage
SandBoxTables ←	↑

StructuredText

Edit detail for StructuredText revision 1 of 1

	1
Editor: Time: 2008/05/27 19:00:20 GMT-7
Note: bkSNmGCYg: <a href=http://desonline.org/bigtits-sex/big-chinese-boobs.html

changed:
-
Structured Text is a simple plain text markup format used by Zope
and ZWiki. It's similar in effect to !WikiWikiWebMarkup but is more
intuitive and standardized. The idea is to have text that is easy
to read both in source and rendered form.

The LatexWiki extensions allow LaTeX commands to be embedded in
Structured Text. MathAction also permits Axiom and Reduce commands
to be embedded.

Zwiki supports other text formatting rules, but Structured Text is
still the default for these reasons: it was the first in zope, it's
a standard, it's simple, it's forgiving, and it allows embedded HTML
and DTML.

Structured Text rules

   0. don't bother trying to learn all the text formatting rules and 
      their interactions. Mimic the text around you;
      when STX doesn't do what you want, tweak it until it looks right.
      Note STX usually does not support non-latin characters.
      Go to the "docs":TextFormattingRules or "ask for help":UserDiscussion#bottom
      when you get really stuck or curious.

   0. text emphasis::

       *italic*
       **bold**
       _underlined_
       'monospaced'

   0. linking (see link types above)::

      WikiName
      [bracketed free-form name]
      ZWiki:RemoteWikiLink
      http://bare/url
      <a href="http://some/where">html link</a>
      "Structured Text link":http://some/where
      [1] (structured text footnote)

   0. separate paragraphs with blank lines

   0. a one-line paragraph becomes a heading when followed by a 
      more-indented paragraph (all indented, or just the first line).
      A more-indented heading becomes a subheading.

   0. a paragraph beginning with - or * or a number followed by a space
      makes a bullet or numbered list item. A more-indented list item starts
      a sub-list.

   0. HTML tags may be used if necessary; on sites which permit it,
      DTML (server-side code) may also be used

   0. to quote text, avoiding all the above: indent it after a paragraph 
      ending with a double colon::

       parent paragraph::

         This is the only reliable way to quote WikiLinks, <HTML tags> and &dtml-code;
         or preserve fixed-width formatting. Use this eg when posting zope tracebacks.
          
References

    * Cheatsheet for Structured Text: http://zwiki.org/QuickReference#4

    * Structured Text's home page is
      http://www.zope.org/Members/jim/StructuredTextWiki/FrontPage

    * The official rules http://www.zope.org/Members/jim/StructuredTextWiki/StructuredTextRules

    * An Introduction to Structured Text - a nice article by Paul Everitt
      http://www.zope.org/Documentation/Articles/STX


From unknown Mon Oct 31 12:56:22 -0600 2005
From: unknown
Date: Mon, 31 Oct 2005 12:56:22 -0600
Subject: Usage on every page
Message-ID: <20051031125622-0600@www.axiom-developer.org>

Any hint about the usage of structured text on all the pages that are editable will be useful. It is rather hard to remember all of these all the times(esp. at the times of need) and would be helpful to any newcomers.

From BillPage Sun Nov 27 01:04:07 -0600 2005
From: Bill Page
Date: Sun, 27 Nov 2005 01:04:07 -0600
Subject: Hints for using Structured Text
Message-ID: <20051127010407-0600@www.axiom-developer.org>

I have changed the **point-and-click** menu that appears below the
'comment' and the 'edit' windows to include some basic some
basic help for StructuredText commands. This works the same way
as for Axiom commands, LaTeX commands, and Latex Symbols.

For example clicking on '**' in the header of the 'Text' area will
display a list of commonly used methods for text highlighting.
To add bold highlighting select some text in the comment or edit
box and click::

  **bold**

This will insert the necessary markup.

If you have any questions about this, please ask.

Structured Text is a simple plain text markup format used by Zope and ZWiki. It's similar in effect to WikiWikiWebMarkup but is more intuitive and standardized. The idea is to have text that is easy to read both in source and rendered form.

The LatexWiki extensions allow LaTeX commands to be embedded in Structured Text. MathAction also permits Axiom and Reduce commands to be embedded.

Zwiki supports other text formatting rules, but Structured Text is still the default for these reasons: it was the first in zope, it's a standard, it's simple, it's forgiving, and it allows embedded HTML and DTML.

Structured Text rules

don't bother trying to learn all the text formatting rules and their interactions. Mimic the text around you; when STX doesn't do what you want, tweak it until it looks right. Note STX usually does not support non-latin characters. Go to the docs or ask for help when you get really stuck or curious.

text emphasis:

       *italic*
       **bold**
       _underlined_
       'monospaced'

linking (see link types above):

      WikiName
      [bracketed free-form name]
      ZWiki:RemoteWikiLink
      http://bare/url
      <a href="http://some/where">html link</a>
      <a href="http://some/where">Structured Text link</a>
      [1] (structured text footnote)

separate paragraphs with blank lines
a one-line paragraph becomes a heading when followed by a more-indented paragraph (all indented, or just the first line). A more-indented heading becomes a subheading.
a paragraph beginning with - or * or a number followed by a space makes a bullet or numbered list item. A more-indented list item starts a sub-list.
HTML tags may be used if necessary; on sites which permit it, DTML (server-side code) may also be used

to quote text, avoiding all the above: indent it after a paragraph ending with a double colon:

       parent paragraph::

         This is the only reliable way to quote WikiLinks, <HTML tags> and &dtml-code;
         or preserve fixed-width formatting. Use this eg when posting zope tracebacks.

References

Cheatsheet for Structured Text: http://zwiki.org/QuickReference#4
Structured Text's home page is http://www.zope.org/Members/jim/StructuredTextWiki/FrontPage
The official rules http://www.zope.org/Members/jim/StructuredTextWiki/StructuredTextRules
An Introduction to Structured Text - a nice article by Paul Everitt http://www.zope.org/Documentation/Articles/STX

Usage on every page --unknown, Mon, 31 Oct 2005 12:56:22 -0600 reply

Any hint about the usage of structured text on all the pages that are editable will be useful. It is rather hard to remember all of these all the times(esp. at the times of need) and would be helpful to any newcomers.

Hints for using Structured Text --Bill Page, Sun, 27 Nov 2005 01:04:07 -0600 reply

I have changed the point-and-click menu that appears below the comment and the edit windows to include some basic some basic help for StructuredText commands. This works the same way as for Axiom commands, LaTeX commands, and Latex Symbols.

For example clicking on ** in the header of the Text area will display a list of commonly used methods for text highlighting. To add bold highlighting select some text in the comment or edit box and click:

  **bold**

This will insert the necessary markup.

If you have any questions about this, please ask.