Block containing preformatted text are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote. The curly braces need to be on a separate line.

147

434

148

Example:

435

||= Wiki Markup =||= Display =||

436

{{{#!td

437

{{{

438

{{{

439

def HelloWorld():

440

print '''Hello World'''

441

}}}

442

}}}

443

}}}

444

{{{#!td

445

{{{

446

def HelloWorld():

447

print '''Hello World'''

448

}}}

449

}}}

450

451

Note that this kind of block is also used for selecting lines that should be processed through WikiProcessors.

452

453

== Blockquotes ==

454

455

In order to mark a paragraph as blockquote, indent that paragraph with two spaces.

456

457

||= Wiki Markup =||= Display =||

458

{{{#!td

149

459

{{{

150

{{{

151

def HelloWorld():

152

print "Hello World"

153

}}}

154

}}}

155

156

Display:

157

{{{

158

def HelloWorld():

159

print "Hello World"

160

}}}

161

162

163

== Blockquotes ==

164

165

In order to mark a paragraph as blockquote, indent that paragraph with two spaces.

To delineate a citation in an ongoing discussion thread, such as the ticket comment area, e-mail-like citation marks (">", ">>", etc.) may be used.

178

472

179

Example:

180

{{{

473

||= Wiki Markup =||= Display =||

474

{{{#!td

475

{{{

476

>> Someone's original text

477

> Someone else's reply text

478

> - which can be any kind of Wiki markup

479

My reply text

480

}}}

481

}}}

482

{{{#!td

181

483

>> Someone's original text

182

484

> Someone else's reply text

485

> - which can be any kind of Wiki markup

183

486

My reply text

184

487

}}}

185

488

186

Display:

187

>> Someone's original text

188

> Someone else's reply text

189

My reply text

190

191

''Note: Some WikiFormatting elements, such as lists and preformatted text, are lost in the citation area. Some reformatting may be necessary to create a clear citation.''

192

489

193

490

== Tables ==

194

491

=== Simple Tables ===

195

492

Simple tables can be created like this:

196

{{{

493

||= Wiki Markup =||= Display =||

494

{{{#!td

495

{{{

496

||Cell 1||Cell 2||Cell 3||

497

||Cell 4||Cell 5||Cell 6||

498

}}}

499

}}}

500

{{{#!td style="padding: 2em;"

197

501

||Cell 1||Cell 2||Cell 3||

198

502

||Cell 4||Cell 5||Cell 6||

199

503

}}}

200

504

201

Display:

202

||Cell 1||Cell 2||Cell 3||

203

||Cell 4||Cell 5||Cell 6||

204

205

Note that more complex tables can be created using

206

[wiki:WikiRestructuredText#BiggerReSTExample reStructuredText].

505

Cell headings can be specified by wrapping the content in a pair of '=' characters.

506

Note that the '=' characters have to stick to the cell separators, like this:

507

||= Wiki Markup =||= Display =||

508

{{{#!td

509

{{{

510

|| ||= stable =||= latest =||

511

||= 0.10 =|| 0.10.5 || 0.10.6dev||

512

||= 0.11 =|| 0.11.6 || 0.11.7dev||

513

}}}

514

}}}

515

{{{#!td style="padding: 2em;"

516

|| ||= stable =||= latest =||

517

||= 0.10 =|| 0.10.5 || 0.10.6dev||

518

||= 0.11 =|| 0.11.6 || 0.11.7dev||

519

}}}

520

521

Finally, specifying an empty cell means that the next non empty cell will span the empty cells. For example:

522

||= Wiki Markup =||= Display =||

523

{{{#!td

524

{{{

525

|| 1 || 2 || 3 ||

526

|||| 1-2 || 3 ||

527

|| 1 |||| 2-3 ||

528

|||||| 1-2-3 ||

529

}}}

530

}}}

531

{{{#!td style="padding: 2em;"

532

|| 1 || 2 || 3 ||

533

|||| 1-2 || 3 ||

534

|| 1 |||| 2-3 ||

535

|||||| 1-2-3 ||

536

}}}

537

538

Note that if the content of a cell "sticks" to one side of the cell and only one, then the text will be aligned on that side. Example:

539

||= Wiki Markup =||= Display =||

540

{{{#!td

541

{{{

542

||=Text =||= Numbers =||

543

||left align || 1.0||

544

|| center || 4.5||

545

|| right align|| 4.5||

546

|| default alignment || 2.5||

547

||default|| 2.5||

548

|| default || 2.5||

549

|| default || 2.5||

550

}}}

551

}}}

552

{{{#!td style="padding: 2em;"

553

||=Text =||= Numbers =||

554

||left align || 1.0||

555

|| center || 4.5||

556

|| right align|| 4.5||

557

|| default alignment || 2.5||

558

||default|| 2.5||

559

|| default || 2.5||

560

|| default || 2.5||

561

}}}

562

563

If contrary to the example above, the cells in your table contain more text, it might be convenient to spread a table row over multiple lines of markup. The `\` character placed at the end of a line after a cell separator tells Trac to not start a new row for the cells on the next line.

564

565

||= Wiki Markup =||

566

{{{#!td

567

{{{

568

|| this is column 1 [http://trac.edgewall.org/newticket new ticket] || \

If the possibilities offered by the simple "pipe"-based markup for tables described above are not enough for your needs, you can create more elaborated tables by using [#Processors-example-tables WikiProcessor based tables].

Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}.

212

589

213

Example:

214

{{{

215

TitleIndex, http://www.edgewall.com/, !NotAlink

216

}}}

217

218

Display:

219

TitleIndex, http://www.edgewall.com/, !NotAlink

220

221

Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets. If the descriptive title is omitted, then the explicit prefix is discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.

222

223

Example:

224

{{{

225

* [http://www.edgewall.com/ Edgewall Software]

226

* [wiki:TitleIndex Title Index]

227

* [wiki:ISO9000]

228

}}}

229

230

Display:

231

* [http://www.edgewall.com/ Edgewall Software]

232

* [wiki:TitleIndex Title Index]

233

* [wiki:ISO9000]

590

||= Wiki Markup =||= Display =||

591

{{{#!td

592

{{{

593

TitleIndex, http://www.edgewall.com/, !NotAlink

594

}}}

595

}}}

596

{{{#!td

597

TitleIndex, http://www.edgewall.com/, !NotAlink

598

}}}

599

600

Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets.

601

If the descriptive title is omitted, then the explicit prefix is discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.

602

603

||= Wiki Markup =||= Display =||

604

{{{#!td

605

{{{

606

* [http://www.edgewall.com Edgewall Software]

607

* [wiki:TitleIndex Title Index]

608

* [wiki:TitleIndex]

609

* [wiki:ISO9000]

610

}}}

611

}}}

612

{{{#!td

613

* [http://www.edgewall.com Edgewall Software]

614

* [wiki:TitleIndex Title Index]

615

* [wiki:TitleIndex]

616

* [wiki:ISO9000]

617

}}}

618

619

Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe ('|') and a title and all this inside //double// square brackets.

620

621

{{{#!td

622

{{{

623

* [[http://www.edgewall.com|Edgewall Software]]

624

* [[wiki:TitleIndex|Title Index]]

625

or even [[TitleIndex|Title Index]]

626

* [[wiki:TitleIndex]]

627

''' but not ![[TitleIndex]]! '''

628

* [[ISO9000]]

629

}}}

630

}}}

631

{{{#!td

632

* [[http://www.edgewall.com|Edgewall Software]]

633

* [[wiki:TitleIndex|Title Index]]

634

or even [[TitleIndex|Title Index]]

635

* [[wiki:TitleIndex]]

636

''' but not ![[TitleIndex]]! '''

637

* [[ISO9000]]

638

}}}

639

640

'''Note''': the [trac:WikiCreole] style for links is quick to type and

641

certainly looks familiar as it's the one used on Wikipedia and in many

642

other wikis. Unfortunately it conflicts with the syntax for [#Macros macros].

643

So in the rare case when you need to refer to a page which is named after

644

a macro (typical examples being TitleIndex, InterTrac and InterWiki),

645

by writing `[[TitleIndex]]` you will actually call the macro instead of linking

646

to the page.

234

647

235

648

== Trac Links ==

236

649

237

650

Wiki pages can link directly to other parts of the Trac system. Pages can refer to tickets, reports, changesets, milestones, source files and other Wiki pages using the following notations:

238

{{{

239

* Tickets: #1 or ticket:1

240

* Reports: {1} or report:1

241

* Changesets: r1, [1] or changeset:1

242

* ...

243

}}}

244

245

Display:

651

652

||= Wiki Markup =||= Display =||

653

{{{#!td

654

{{{

655

* Tickets: #1 or ticket:1

656

* Reports: {1} or report:1

657

* Changesets: r1, [1] or changeset:1

658

* ...

659

* targeting other Trac instances,

660

so called InterTrac links:

661

- Tickets: #Trac1 or Trac:ticket:1

662

- Changesets: [Trac1] or Trac:changeset:1

663

}}}

664

}}}

665

{{{#!td

246

666

* Tickets: #1 or ticket:1

247

667

* Reports: {1} or report:1

248

668

* Changesets: r1, [1] or changeset:1

249

669

* ...

250

251

There are many more flavors of Trac links, see TracLinks for more in-depth information.

670

* targeting other Trac instances,

671

so called InterTrac links:

672

- Tickets: #Trac1 or Trac:ticket:1

673

- Changesets: [Trac1] or Trac:changeset:1

674

}}}

675

676

There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers.

677

678

679

== Setting Anchors ==

680

681

An anchor, or more correctly speaking, an [http://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 anchor name] can be added explicitly at any place in the Wiki page, in order to uniquely identify a position in the document:

682

683

{{{

684

[=#point1]

685

}}}

686

687

This syntax was chosen to match the format for explicitly naming the header id [#Headings documented above]. For example:

688

{{{

689

== Long title == #title

690

}}}

691

692

It's also very close to the syntax for the corresponding link to that anchor:

693

{{{

694

[#point1]

695

}}}

696

697

Optionally, a label can be given to the anchor:

698

{{{

699

[[=#point1 '''Point 1''']]

700

}}}

701

702

||= Wiki Markup =||= Display =||

703

|----------------------------------

704

{{{#!td

705

{{{

706

[#point2 jump to the second point]

707

708

...

709

710

Point2: [=#point2] Jump here

711

}}}

712

}}}

713

{{{#!td

714

[#point2 jump to the second point]

715

716

...

717

718

Point2: [=#point2] Jump here

719

}}}

720

721

For more complex anchors (e.g. when a custom title is wanted), one can use the Span macro, e.g. `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`.