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

437

148

Example:

438

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

439

{{{#!td

440

{{{

441

{{{

442

def HelloWorld():

443

print '''Hello World'''

444

}}}

445

}}}

446

}}}

447

{{{#!td

448

{{{

449

def HelloWorld():

450

print '''Hello World'''

451

}}}

452

}}}

453

454

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

455

456

== Blockquotes ==

457

458

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

459

460

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

461

{{{#!td

149

462

{{{

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

475

179

Example:

180

{{{

476

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

477

{{{#!td

478

{{{

479

>> Someone's original text

480

> Someone else's reply text

481

> - which can be any kind of Wiki markup

482

My reply text

483

}}}

484

}}}

485

{{{#!td

181

486

>> Someone's original text

182

487

> Someone else's reply text

488

> - which can be any kind of Wiki markup

183

489

My reply text

184

490

}}}

185

491

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

492

193

493

== Tables ==

194

494

=== Simple Tables ===

195

495

Simple tables can be created like this:

196

{{{

496

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

497

{{{#!td

498

{{{

499

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

500

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

501

}}}

502

}}}

503

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

197

504

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

198

505

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

199

506

}}}

200

507

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].

508

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

509

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

510

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

511

{{{#!td

512

{{{

513

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

514

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

515

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

516

}}}

517

}}}

518

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

519

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

520

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

521

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

522

}}}

523

524

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

525

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

526

{{{#!td

527

{{{

528

|| 1 || 2 || 3 ||

529

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

530

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

531

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

532

}}}

533

}}}

534

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

535

|| 1 || 2 || 3 ||

536

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

537

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

538

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

539

}}}

540

541

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:

542

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

543

{{{#!td

544

{{{

545

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

546

||left align || 1.0||

547

|| center || 4.5||

548

|| right align|| 4.5||

549

|| default alignment || 2.5||

550

||default|| 2.5||

551

|| default || 2.5||

552

|| default || 2.5||

553

}}}

554

}}}

555

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

556

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

557

||left align || 1.0||

558

|| center || 4.5||

559

|| right align|| 4.5||

560

|| default alignment || 2.5||

561

||default|| 2.5||

562

|| default || 2.5||

563

|| default || 2.5||

564

}}}

565

566

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.

567

568

||= Wiki Markup =||

569

{{{#!td

570

{{{

571

|| 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

592

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]

593

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

594

{{{#!td

595

{{{

596

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

597

}}}

598

}}}

599

{{{#!td

600

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

601

}}}

602

603

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.

604

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.

605

606

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

607

{{{#!td

608

{{{

609

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

610

* [wiki:TitleIndex Title Index]

611

* [wiki:TitleIndex]

612

* [wiki:ISO9000]

613

}}}

614

}}}

615

{{{#!td

616

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

617

* [wiki:TitleIndex Title Index]

618

* [wiki:TitleIndex]

619

* [wiki:ISO9000]

620

}}}

621

622

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.

623

624

{{{#!td

625

{{{

626

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

627

* [[wiki:TitleIndex|Title Index]]

628

or even [[TitleIndex|Title Index]]

629

* [[wiki:TitleIndex]]

630

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

631

* [[ISO9000]]

632

}}}

633

}}}

634

{{{#!td

635

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

636

* [[wiki:TitleIndex|Title Index]]

637

or even [[TitleIndex|Title Index]]

638

* [[wiki:TitleIndex]]

639

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

640

* [[ISO9000]]

641

}}}

642

643

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

644

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

645

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

646

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

647

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

648

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

649

to the page.

234

650

235

651

== Trac Links ==

236

652

237

653

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:

654

655

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

656

{{{#!td

657

{{{

658

* Tickets: #1 or ticket:1

659

* Reports: {1} or report:1

660

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

661

* ...

662

* targeting other Trac instances,

663

so called InterTrac links:

664

- Tickets: #Trac1 or Trac:ticket:1

665

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

666

}}}

667

}}}

668

{{{#!td

246

669

* Tickets: #1 or ticket:1

247

670

* Reports: {1} or report:1

248

671

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

249

672

* ...

250

251

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

252

253

254

== Escaping Links and WikiPageNames ==

673

* targeting other Trac instances,

674

so called InterTrac links:

675

- Tickets: #Trac1 or Trac:ticket:1

676

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

677

}}}

678

679

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

680

681

682

== Setting Anchors ==

683

684

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:

685

686

{{{

687

[=#point1]

688

}}}

689

690

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

691

{{{

692

== Long title == #title

693

}}}

694

695

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

696

{{{

697

[#point1]

698

}}}

699

700

Optionally, a label can be given to the anchor:

701

{{{

702

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

703

}}}

704

705

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

706

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

707

{{{#!td

708

{{{

709

[#point2 jump to the second point]

710

711

...

712

713

Point2: [=#point2] Jump here

714

}}}

715

}}}

716

{{{#!td

717

[#point2 jump to the second point]

718

719

...

720

721

Point2: [=#point2] Jump here

722

}}}

723

724

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)^)]]`.

725

726

727

== Escaping Links, WikiPageNames and other Markup == #Escaping

255

728

256

729

You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark).