Diff: Help/TextFormattingRules

Note: You are viewing an old revision of this page. View the current version.

Differences between version 2 and predecessor to the previous major change of Help/TextFormattingRules.

Other diffs: Previous Revision, Previous Author

Newer page: version 2 Last edited on 22 May 2014 3:01 by harold Revert
Older page: version 1 Last edited on 17 January 2022 18:35 by harold Revert
@@ -11,9 +11,9 @@
 **References:** use pipe ##~|## to name the links: ##~[~[page link~|some text~]~]## or ##~[~[~http:~//cool.wiki.int/~|some text~]~]##. \\ 
 **Preventing linking:** Prefix with "##~~##": ##~~~DoNotHyperlink##. \\ 
 **Misc:** "##~\~\##" makes a linebreak, "##~----##" makes a horizontal rule. \\ 
 **Allowed HTML tags:** <b>b</b> <big>big</big> <i>i</i> 
-<small>small</small> < tt>tt</tt> <em>em</em> <strong>strong</strong> 
+<small>small</small> ## tt## <em>em</em> <strong>strong</strong> 
 <s>s</s> <strike>strike</strike> 
 <abbr>abbr</abbr> <acronym>acronym</acronym> <cite>cite</cite> 
 <code>code</code> <dfn>dfn</dfn> <kbd>kbd</kbd> <samp>samp</samp> 
 <var>var</var> <sup>sup</sup> <sub>sub</sub> \\ 
@@ -70,9 +70,9 @@
 There's no syntax for font tags. 
  
 === Color Text === 
  
-It is possible to write text in color. 
+Is it possible to write text in color. 
  
 {{{ 
 %color=green% green text %% and back to normal 
 }}} 
@@ -88,9 +88,9 @@
 * the following predefined color names: 
 {| class="bordered" 
 |- 
 | %color=aqua% aqua %% 
-| style ="background-color: #565c5e" | %color=beige% beige %% 
+| bgcolor ="#565c5e" | %color=beige% beige %% 
 | %color=black% black %% 
 | %color=blue% blue %% 
 | %color=brown% brown %% 
 | %color=chocolate% chocolate %% 
@@ -99,9 +99,9 @@
 | %color=gold% gold %% 
 | %color=gray% gray %% 
 |- 
 | %color=green% green %% 
-| style ="background-color: #565c5e" | %color=ivory% ivory %% 
+| bgcolor ="#565c5e" | %color=ivory% ivory %% 
 | %color=indigo% indigo %% 
 | %color=lime% lime %% 
 | %color=magenta% magenta %% 
 | %color=maroon% maroon %% 
@@ -113,13 +113,13 @@
 | %color=purple% purple %% 
 | %color=red% red %% 
 | %color=salmon% salmon %% 
 | %color=silver% silver %% 
-| style ="background-color: #565c5e" | %color=snow% snow %% 
+| bgcolor ="#565c5e" | %color=snow% snow %% 
 | %color=teal% teal %% 
 | %color=turquoise% turquoise %% 
 | %color=violet% violet %% 
-| style ="background-color: #565c5e" | %color=white% white %% 
+| bgcolor ="#565c5e" | %color=white% white %% 
 | %color=yellow% yellow %% 
 |} 
  
 Note: you can put the headers in color, but only if you do not have a table of content. For now, the table of content is incompatible with color headers. 
@@ -251,17 +251,16 @@
 * Hyperlinks to other pages within the Wiki are made by placing the 
  page name in double square brackets: [[this is a page link]]. 
  Single brackets or WikiWords will also work. 
 * Hyperlinks to external pages are done like this: [[http://www.wcsb.org/]] 
-* You can name the links by providing the hyperlink or pagename , a pipe (##|##) and then the name
+* You can name the links by providing a name , a pipe (##|##) and then the hyperlink or pagename
  [[http://phpwiki.sourceforge.net/|PhpWiki home page]], [[HomePage|the front page]] 
-* You can suppress linking to URIs by preceding the word with a '##~~##',  
- e.g. ~NotLinkedAsWikiName, ~http~://not.linked.to/ 
+* You can suppress linking to URIs by preceding the word with a '##~~##', e.g. ~NotLinkedAsWikiName, ~http~://not.linked.to/ 
 * Also, the old way of linking URL's is still supported: precede URLs 
  with "##~http:##", "##~ftp:##" or "##~mailto:##" to 
  create links automatically as in: http://c2.com/ 
 * URLs ending with ##.png##, ##.gif##, or ##.jpg## are inlined if in square brackets, by themselves: 
- [[http://phpwiki.demo .free .fr /themes/default/images/png.png]] 
+ [[http://phpwiki.svn .sourceforge .net/viewvc/phpwiki/trunk /themes/default/images/png.png]] 
 * You can create footnotes by using ~[1], ~[2], ~[3], ... like this here #[|ftnt 
 _ref_1]<sup>~[[1|#ftnt_1]~]</sup>. See footnote for counterpart. (If the ~[ is 
 in the first column, it is a footnote <em>definition</em> rather than a footnote 
  <em>reference</em> #[|ftnt_ref_1]<sup>~[[1|#ftnt_1]~]</sup>.) 
@@ -270,9 +269,9 @@
 *** ##~#~[~[foo]]##: An anchor around the text "foo" with id "foo". 
 *** ##~#~[~[|foo]]##: An empty anchor with id "foo". 
 *** ##~#~[~[howdy|foo]]##: An anchor around the text "howdy" with id "foo". 
 ** References to name anchors are made thusly:\\##~[~[~#hyperlinks]]##, ##~[~[~OtherPage#foo]]##, ##~[~[~OtherPage#foo|named]]##. 
-* Semantic links are named links like: {{{ is_a::WikiPage}}} and attributes like {{{ size:-4000}}}
+* Semantic links are named links like: is_a::WikiPage and attributes like size:-4000. 
 * A pagelink within square brackets starting with ":" is not backlinked. 
  
 == Images == 
  

version 2

Synopsis

Emphasis: // for italics, ** for bold, **//...//** for both, ## for fixed width.
Lists: * for bullet lists, # for numbered lists; use multiple * or # for nested lists.
Headings: "==", "===", "====", etc. make headings.
Preformatted text: Enclose text in {{{...}}} or <pre></pre>.
Indented text: Indent the paragraph with whitespaces.
References: use double square brackets for a [[page link]] or URL [[http://cool.wiki.int/]].
References: use pipe | to name the links: [[page link|some text]] or [[http://cool.wiki.int/|some text]].
Preventing linking: Prefix with "~": ~DoNotHyperlink.
Misc: "\\" makes a linebreak, "----" makes a horizontal rule.
Allowed HTML tags: b big i small tt em strong s strike abbr acronym cite code dfn kbd samp var sup sub
More: tables, images, table of contents, plugins

More explanations: Help:TextFormattingRules

Character Formatting

Emphasis

  • Use a double slash (//) for emphasis (usually italics)
  • Use a double asterisk (**) for strong emphasis (usually bold)
  • Mix them at will: bold italics
  • Emphasis can be used multiple times within a paragraph, but cannot cross paragraph boundaries:

// this

will not work//

Monospace

Monospace text is made using two hashes:

This sentence contains ##monospace text##.

This sentence contains monospace text.

Superscript

Superscript text is made using two carets:

The XX^^th^^ century.

The XXth century.

Subscript

Subscript text is made using two commas:

Water is H,,2,,O.

Water is H2O.

Fonts

There's no syntax for font tags.

Color Text

Is it possible to write text in color.

%color=green% green text %% and back to normal

will give:
green text and back to normal

The easiest way to do it is to use the COLOR button in the Edit Toolbar. The text will be in green by default. You can then change the color.

Allowed colors are:

  • an HTML color number (# followed by 3 or 6 digits),
  • the following predefined color names:

aqua

beige

black

blue

brown

chocolate

cyan

fuchsia

gold

gray

green

ivory

indigo

lime

magenta

maroon

navy

olive

orange

pink

purple

red

salmon

silver

snow

teal

turquoise

violet

white

yellow

Note: you can put the headers in color, but only if you do not have a table of content. For now, the table of content is incompatible with color headers.

Escape Character

The tilde '~' is the Escape Character:

  • A single tilde '~' followed by nothing gets rendered as a single tilde. => ~
  • Two tilde '~~' get rendered as a single tilde. => ~
  • A single tilde before a link ('~http://foo.bar') prevents linking. => http://foo.bar
  • Two tildes before a link ('~~http://foo.bar') produce a tilde followed by the hyperlinked URL. => ~http://foo.bar
  • A tilde inside an URL gets removed, unless it's formatted inside square brackets.
  • Two tildes inside an URL (without brackets) become a single tilde. => http://foo.bar/~user or http://foo.bar/~user

Special Characters

All special non-whitespace HTML characters are displayed as-is. Exceptions below.

Paragraphs

  • Don't indent paragraphs
  • Words wrap and fill as needed
  • Use blank lines as separators
  • Four or more minus signs make a horizontal rule
  • "\\", "%%%" or "<br>" makes a linebreak (in headings and lists too)

Lists

Unordered lists

Recommended syntax (Wikicreole):

  • asterisk for first level
  • double asterisk for second level, etc.

Be sure to put a space after the asterisk.

You can also use indented asterisk for second level (indent at least two spaces).

Ordered lists

Recommended syntax (Wikicreole):

  • # for first level
  • double # for second level, etc.

Be sure to put a space after the hash sign.

You can also use indented # for second level (indent at least two spaces).

Definition lists

Term:
  definition

gives

Term
definition

Remark

Items may contain multiple paragraphs and other multi-lined content, just indent the items

Headings

Wikicreole syntax (recommended)

  • '==' at the start of a line makes a large heading (h2)
  • '===' at the start of a line makes a medium heading (h3)
  • '====' at the start of a line makes a small heading (h4)
  • '=====' at the start of a line makes a smaller heading (h5)
  • '======' at the start of a line makes a tiny heading (h6)

Classic Phpwiki syntax

  • '!!!' at the start of a line makes a large heading (h2)
  • '!!' at the start of a line makes a medium heading (h3)
  • '!' at the start of a line makes a small heading (h4)

Preformatted text

Place the preformatted text between three opening curly brackets and three closing curly brackets:

{{{
Preformatted text. ~WikiLinks do not work.
}}}

gives

Preformatted text. WikiLinks do not work.

If you want Wiki interaction, place preformatted lines inside <pre>:

<pre>
Preformatted text. WikiLinks still work.
</pre>

gives

Preformatted text. WikiLinks still work.

Indented Paragraphs

Two or more whitespaces signal indented text. Indents may be nested.

This is an indented block of text.

This block is even more indented.

E-mail style block-quoting is supported as well:

> This is block-quoted text.

renders as

This is block-quoted text.

References

  • Hyperlinks to other pages within the Wiki are made by placing the page name in double square brackets: this is a page link. Single brackets or WikiWords will also work.
  • Hyperlinks to external pages are done like this: http://www.wcsb.org/
  • You can name the links by providing a name, a pipe (|) and then the hyperlink or pagename: PhpWiki home page, the front page
  • You can suppress linking to URIs by preceding the word with a '~', e.g. NotLinkedAsWikiName, http://not.linked.to/
  • Also, the old way of linking URL's is still supported: precede URLs with "http:", "ftp:" or "mailto:" to create links automatically as in: http://c2.com/
  • URLs ending with .png, .gif, or .jpg are inlined if in square brackets, by themselves:
  • You can create footnotes by using [1], [2], [3], ... like this here #[|ftnt

_ref_1][1]. See footnote for counterpart. (If the [ is in the first column, it is a footnote definition rather than a footnote

reference [1].)

  • In-page hyperlinks are made by placing a named anchor and referring to the anchor in a hyperlink:

    • Named anchors:

      • #[[foo]]: An anchor around the text "foo" with id "foo".
      • #[[|foo]]: An empty anchor with id "foo".
      • #[[howdy|foo]]: An anchor around the text "howdy" with id "foo".
    • References to name anchors are made thusly:
      [[#hyperlinks]], [[OtherPage#foo]], [[OtherPage#foo|named]].
  • Semantic links are named links like: is_a::WikiPage and attributes like size:-4000.
  • A pagelink within square brackets starting with ":" is not backlinked.

Images

An inline image is created with curly brackets. An alternate text can be put after a pipe. If there is none, an empty alternate text will be created.

{{myimage.png}}
{{myimage.png|this is the alt text for my image}}
[[some link|{{myimage.png}}]] - if you click on the image, will goto "some link"
[[some link|{{myimage.png|alt text}}]] - same with alternative
[[http://example.com/|{{myimage.png}}]] - same as above: picture links to url
[[http://example.com/|{{myimage.png|alt text}}]] - same with alternative

Tables

Wikicreole tables

All cells are separated by single pipes. Leading spaces are permitted before the first cell of a row and trailing spaces are permitted at the end of a line. The ending pipe is optional.

You can embed links, bold, italics, line breaks, and nowiki in table cells.

Equal sign directly following pipe defines a header. Headers can be arranged horizontally or vertically.

|=Heading Col 1 |=Heading Col 2         |
|Cell 1.1       |Two lines\\in Cell 1.2 |
|Cell 2.1       |Cell 2.2               |

will give:

Heading Col 1 Heading Col 2
Cell 1.1 Two lines
in Cell 1.2
Cell 2.1 Cell 2.2

Mediawiki tables

See Help:MediawikiTablePlugin.

Definition list style tables

Definition list style tables are written just like definition lists, except that you replace the trailing colon on the term with a "pipe" (|).

Term 1 |
   Definition 1 begins here.
   Term 1.1 |
      Definition 1.1
   Term 1.2 |
      Definition 1.2
   This is part of definition 1.
Term 2 |
   Here's definition 2.

will give:

Term 1

Definition 1 begins here.

Term 1.1 Definition 1.1
Term 1.2 Definition 1.2

This is part of definition 1.

Term 2 Here's definition 2.

Old-style tables

See: Help:OldStyleTablePlugin

HTML Mark-Up Language

  • Some in-line markup is allowed through the use of HTML tags: b, big, i, small, tt, em, strong, abbr, acronym, cite, code, dfn, kbd, samp, var, sup and sub
  • < and > are themselves
  • The & characters will not work

Creating various kinds of special links

See Help:MagicPhpWikiURLs for gory details on how to write various kind of wiki maintenance and other special links.

Inserting plugins

Several plugins permit embedding additional functionality to Wiki pages. For example,

<<BackLinks page=HomePage info=hits>>

gives

247 pages link to HomePage:
|<<   << - 1 / 5 - Next >>   >>|
|<<   << - 1 / 5 - Next >>   >>|
Page Name. Hits.
Help/TextFormattingRules 13374
PhpWikiAdministration 907
Help/EditMetaDataPlugin 827
Help/RedirectToPlugin 872
TextFormattingRules 5251
OldTextFormattingRules 375
RedirectToPlugin 362
NewMarkupTestPage 381
OldMarkupTestPage 345
IncludePagePlugin 584
AmperexElectronicCorporation 1080
DeltaElectronics 1906
EimacDivisionOfVarian 858
GatesRadioCompany 409
GatesRadioCatalog99 433
GeneralElectric 2335
GeneralRadio 397
HallikainenAndFriends 10772
MoseleyAssociatesInc 7572
Motorola 825
National 807
NemsClarke 766
RCA 11118
WesternElectric 1557
Technics 992
Westinghouse 837
MilitaryRadio 4210
Historic Papers 6362
Station Histories 3344
Ratheon 342
Raytheon 1271
EfJohnson 841
American Electronic Laboratories 1356
Victoreen Instrument Company 903
Anton Electronic Laboratories 1038
Collins Radio 10223
HoweTech 835
Belar Electronics Laboratory 2333
Ampex 8936
Harris Corporation - Broadcast Division 7527
Dorrough Electronics 4286
Radio Engineering Laboratories 790
Standard Electronics 737
Amalgamated Wireless (Australiasia) Ltd. 1544
Byer Industries 784
Circuit Research Laboratories 1674
Bauer Electronics Corporation 899
Trimax 751
United Transformer Corporation 747
template 363
Philips 916
McMartin 2167
ITA 900
Continental Electronics 3247
Magnecord 746
TFT, Inc. 4967
Schafer Automation 1255
Gentner 4733
Texar 1010
Langevin 1064
Altec 1771
CBS Labs 2634
Pultec 753
Sony 2815
3M 3262
UREI 1967
Frese and Kaping 1040
Revox 2602
Federated Purchaser 670
CCA 2125
LPB 3111
Hollyanne 696
Telfax 677
Help/OldTextFormattingRules 362
AmministrazioneDiPhpWiki 388
Help/NewMarkupTestPage 353
Help/NewMarkupTestPage 353
Help/NewMarkupTestPage 353
Help/OldMarkupTestPage 344
Help/OldMarkupTestPage 344
Help/OldMarkupTestPage 344
Larcan 1350
Tepco 864
Standard Telephones & Cables. Australia 716
Presto 794
Straight Wire Audio 716
Arrakis Systems, Inc 1738
Consolidated Electronic Industries 735
Aphex Systems Limited 1093
QEI 2864
Multronics 714
ITC 3313
Machlett Laboratories 869
Cutting Edge Technologies 725
Bext 1135
Tektronix 2696
Electronics Research, Inc. 664
Advanced Research & Technology 1584
Marantz 854
Microcon 730
Broadcast Television Systems 730
Bosch 871
dbx 2355
Otari 1004
Crown 2171
Broadcast Electronics 9751
ATI 1216
Scully 854
Marti Electronics, Inc. 2125
Harman Kardon 909
Potomac Instruments 2011
Broadcast Audio 1796
Andrew Corporation 2041
Audio Arts 944
Bird Electronic Corporation 21783
Dumont 1233
Autogram 3267
Radio Engineering 352
Heathkit 3682
Mullard 746
NBC 861
Amperite 1040
McIntosh 1162
Inovonics 1307
Neotek 1547
Moulic Specialties Co. 708
Engineering Services 774
IRC 1064
ESE 2076
Comtech Antenna Corporation 935
Panasonic 4286
Orban 2121
Studer 751
Coastcom 807
Clear-Com 731
Dolby Laboratories 1730
CSI 1715
Bell Telephone Laboratories 1229
Pacific Recorders and Engineers 1156
Hewlett Packard 2870
Sparta Electronics 3626
Tapecaster 2039
Scala 858
Marconi Wireless Telegraph Company 896
Energy-Onix 1460
Modulation Sciences 1590
Burk Technology 2107
Auditronics 2278
Jampro Antenna 1315
Dayton Industrial 4568
Thompson-CSF 1185
Rust Industrial Company, Inc. 1332
Accurate Sound Corporation 1700
IGM 1030
SMC 1077
Radix 1278
Fidelipac 50
Hughey & Phillips 1362
Microwave Radio Corporation 1583
Broadcast Tools 104
Symmetrix 1492
GatesAir 866
Hallicrafters 1752
Kenwood 1306
Kyocera 1457
Teac 2602
Wheatstone Corporation 1573
Gorman-Redlich 1144
Studer International AG 919
Data Systems Design 1005
Dana Electronics 1592
American Data 1485
Teletronix Engineering Company 1227
Tentel 921
Taber Manufacturing and Engineering Company 1057
Standart Tape Laboratory 974
Extel 1085
Russco 931
Automated Broadcast Controls 1116
Electrovoice 923
Jennings 946
Wegener Communications 897
Midwest Communications 873
Aston 1207
Farallon 953
Kenneth A. Bacon Associates 825
J. G. S. Engineering Inc. 940
Continental Satellite Systems 895
ComStream 1303
Conex Electro Systems 839
Denon 1037
Multi-technical Services 876
Electronic Signal Products 1057
Lorain Products Corporation 963
C & D Batteries 1570
Nova Systems, Inc. 855
Nortronics 1869
Norcom 1162
Lambda Electronics Corp. 1234
US Audio 906
Jensen Transformers 969
Garner Industries 845
Sescom 1017
Soltec 1000
Peak Audio 832
MCI 1233
MEI 1801
Minicom Division of 3M 1353
Metrotech 1524
Lang Electronics 868
Kinght-kit 1278
Cetec Broadcast Group 1693
Computer Concepts 1077
Dataworld 1026
National Association of Broadcasters 1294
Link, Fred M 908
Weston 1274
Yokogawa Electric Works 1035
Measurements 1305
Electronics Digest 1374
Gregg Laboratories 959
Leeds & Northrup Company 974
Video Systems of America 839
Simpson Electric Company 980
Triplett 787
Boonton Radio Corporation 860
Ohmite Manufacturing Company 1096
Contel ASC 609
Audi-Cord Corporation 690
Johnson Electronics 608
Telefile Computer Products, Inc. 850
Realistic 516
Thordarson 515
Sine Systems 644
Telos 583
Harris Allied 503
Broadcasters General Store 737
QRK 621
BME - Broadcast Management Engineering Magazine 1419
Radio Business Report 481
UMC Beaucart 448
Armstrong Transmitter Corporation 5515
Cablewave Systems 450
Aristocart 546
Elgin Electronics 499
Goldline 404
NAD Electronics 861

For more information on plugins see Help:WikiPlugin, and PluginManager for a list of all plugins.