WikiFormatting

Markup Wiki merupakan fitur utama pada Trac, metode ini sangat tepat untuk memadukan semua bagian dari Trac menjadi suatu kesatuan sehingga lebih baik dan fleksibel.

Trac has a built in small and powerful wiki rendering engine. Mesin wiki ini yang mengimplementasikan perkembangan perintah dari wiki populer lainnya, terutama MoinMoin and WikiCreole.

Halaman ini mencoba memberikan penjelasan secara mendalam tentang markup maupun format wiki yang diperbolehkan pada berbagai halaman wiki secara umum.

Panduan Dasar di bawah ini memberi Anda gambaran singkat pada sintaks yang paling umum, setiap tautan pada kolom Kategori akan membawa Anda ke penjelasan yang lebih detail pada halaman ini.

Beberapa halaman wiki lainnya menyajikan fitur yang canggih dan lebih mendalam dari markup wiki Trac:

  • TracLinks mencakup semua cara yang mungkin untuk merujuk ke sumber daya Trac atau bagiannya,
  • WikiPageNames berisi berbagai nama halaman wiki dapat dipergunakan, CamelCase atau tidak
  • WikiMacros adalah daftar macro yang tersedia untuk menghasilkan konten dinamis,
  • WikiProcessors dan WikiHtml rincian bagaimana bagian-bagian dari teks wiki dapat diproses dengan cara khusus

Panduan Dasar

Kategori Markup Wiki Tampilan

Gaya Huruf

'''tebal''', ''miring'', '''''gaya Wikipedia''''' tebal, miring, gaya Wikipedia
`monospaced dan ''nowiki''` monospaced dan ''nowiki''
**tebal**, //miring//, **//Gaya !WikiCreole//** tebal, miring, Gaya WikiCreole//
Judul
== Level 2 ==
=== Level 3 ^([#hn catatan kaki])^

Level 2

Level 3 (catatan kaki)

Paragraf
Paragraf pertama
didalam beberapa baris.

Paragraf kedua.

Paragraf pertama didalam beberapa baris.

Paragraf kedua.

Daftar
* Daftar Berbulir
  di dalam banyak paragraf
  1. Daftar Bertingkat
    a. Gaya penomoran yang berbeda
  • Daftar Berbulir

di dalam banyak paragraf

  1. Daftar Bertingkat
    1. Gaya penomoran yang berbeda

Daftar Definisi

 istilah:: Definisi didalam paragraf
istilah
Definisi didalam paragraf
Teks Terformat
{{{
teks dengan beberapa baris, ''no wiki''
      spasi
}}}
teks dengan beberapa baris, ''no wiki''
      spasi
Blockquotes
  Contoh teks quote
  Contoh teks quote

Contoh teks quote Contoh teks quote

Kutipan Diskusi
>> ... (Pertanyaan)
> (Jawaban)

... (Pertanyaan)

(Jawaban)

Tabel
||= Judul Tabel =|| Cell ||
||||  (isi detail teks)  ||
Judul Tabel Cell
(isi detail teks)

Pranala

http://trac.edgewall.org http://trac.edgewall.org
WikiFormatting (CamelCase) WikiFormatting (CamelCase)

TracLinks

wiki:WikiFormatting, wiki:"WikiFormatting" wiki:WikiFormatting, wiki:"WikiFormatting"
#1 (ticket), [1] (changeset), {1} (report) #1 (ticket), [1] (changeset), {1} (report)
ticket:1, ticket:1#comment:1 ticket:1, ticket:1#comment:1
Ticket [ticket:1], [ticket:1 ticket one] Ticket 1, ticket one
Ticket [[ticket:1]], [[ticket:1|ticket one]] Ticket 1, ticket one

Setting Anchors

[=#point1 (1)] First... (1) First...
see [#point1 (1)] see (1)

Escaping Markup

!'' doubled quotes '' doubled quotes
!wiki:WikiFormatting, !WikiFormatting wiki:WikiFormatting, WikiFormatting
Gambar [[Image(link)]] trac_logo_mini.png

Macros

[[MacroList(*)]] (short list of all available macros)
[[Image?]] (help for the Image macro)
Pemroses
{{{
#!div style="font-size: 80%"
Code highlighting:
  {{{#!python
  hello = lambda: "world"
  }}}
}}}

Code highlighting:

hello = lambda: "world"
Komentar
{{{#!comment
Catatan untuk Editor: ...
}}}
Lainnya
Garis [[br]] pisah 
Garis \\ pisah
----

Garis
pisah Garis
pisah


Gaya Huruf

The Trac wiki mendukung beberapa format gaya teks:

Wiki Markup Tampilan
 * '''tebal''', 
   ''' kutipan !''' 
   bisa juga dikombinasikan dengan gaya penulisan tebal jika diperlukan ''', 
 * ''miring''
 * '''''tebal miring''''' or ''miring and
   ''' miring tebal ''' ''
 * __garis bawah__
 * {{{monospace}}} or `monospace`
   (hence `{{{` or {{{`}}} quoting)
 * ~~strike-through~~
 * ^superscript^ 
 * ,,subscript,,
 * **tebal**, //miring//, 
   dan **'' tebal miring **'' //(sejak versi 0.12)//
  • tebal, kutipan ''' bisa juga dikombinasikan dengan gaya penulisan tebal jika diperlukan ,
  • miring
  • tebal miring or miring and miring tebal
  • garis bawah
  • monospace or monospace (hence {{{ or ` quoting)
  • strike-through
  • superscript
  • subscript
  • tebal, miring, and tebal miring (since 0.12)

Catatan:

  • {{{...}}} and `...` perintah tersebut tidak hanya berlaku untuk jenis font monospace, tetapi juga berlaku untuk teks demi teks lainnya.
  • ! menandai wiki untuk tidak mengambil karakter tersebut ("!") sebagai format wiki, jangan lupa untuk menempatkan spasi setelah tanda seru ("!"), misalnya saat mengakhiri huruf tebal.
  • Semua gaya format teks yang digunakan harus mempunyai tanda yang sama sebagai pembuka dan penutup (misalnya, tanda '' huruf miring tidak dapat dipasangkan dengan tanda //, dan tanda ''' tidak dapat dipasangkan dengan tanda **). contoh yang salah : miring sedangkan contoh yang benar adalah : miring atau miring

Judul

Kita dapat membuat sebuah judul dengan menggunakan satu hingga 6 simbol sama dengan ("=") dengan diikuti oleh sebuah spasi tunggal sebelum dan sesudah teks judul.

Teks judul harus diikuti oleh jumlah simbol sama dengan ("=") didapan dan diakhir teks judul

Teks judul juga bisa diikuti dengan ID explicit.

Wiki Markup Tampilan
= Judul =
== subjudul
=== Tentang ''pembuat'' ===
=== ID Explicit === #using-explicit-id-in-heading
== Subjudul #sub2

Subjudul

Tentang pembuat

ID Explicit

Subjudul

Paragraf

Kita dapat membuat sebuah teks paragraf baru dari dua buah blok teks yang dipisahkan oleh sebuah spasi berupa baris kosong.

Sebuah spasi baris kosong dapat dimasukkan dengan cara :

Wiki Markup Tampilan
Baris 1[[BR]]Baris 2
Paragraf
satu

Paragraf 
dua

Baris 1
Baris 2

Paragraf satu

Paragraf dua

Daftar

Wiki mendukung gaya daftar penomoran dan daftar berbulir.

Contoh:

Wiki Markup Tampilan
 * Daftar 1
   * Daftar 1.1
      * Daftar 1.1.1   
      * Daftar 1.1.2
      * Daftar 1.1.3
   * Daftar 1.2
 * Daftar 2
- sebuah daftar dapat dimulai dengan sebuah baris baru
  atau bisa juga dengan beberapa baris
  - tetap hati-hati dalam melanjutkan daftar,
  walaupun kelihatan memiliki indentansi yang sama 
tetapi itu bisa membuat sebuah paragraf baru...

 1. Daftar 1
   a. Daftar 1.a
   a. Daftar 1.b
      i. Daftar 1.b.i
      i. Daftar 1.b.ii
 1. Daftar 2
Daftar bernomor akan dimulai lagi dari penomoran awal dengan membuat nomor eksplisit:
 3. Daftar 3
  • Daftar 1
    • Daftar 1.1
      • Daftar 1.1.1
      • Daftar 1.1.2
      • Daftar 1.1.3
    • Daftar 1.2
  • Daftar 2
    • sebuah daftar dapat dimulai dengan sebuah baris baru atau bisa juga dengan beberapa baris
      • tetap hati-hati dalam melanjutkan daftar, walaupun kelihatan memiliki indentansi yang sama
      tetapi itu bisa membuat sebuah paragraf baru...

  1. Daftar 1
    1. Daftar 1.a
    2. Daftar 1.b
      1. Daftar 1.b.i
      2. Daftar 1.b.ii
  2. Daftar 2

Daftar bernomor akan dimulai lagi dari penomoran awal dengan membuat nomor eksplisit:

  1. Daftar 3

Daftar Definisi

Wiki mendukung daftar definisi.

Wiki Markup Tampilan
 llama::
   salah satu jenis hewan mamalia berambut
 ppython::
   salah satu jenis hewan reptil, tidak memiliki rambut
llama
some kind of mammal, with hair
ppython
some kind of reptile, without hair (can you spot the typo?)

Catatan bahwa dibutuhkan sebuah spasi kosong didepan teks yang akan didefinisikan.

Teks Terformat

Blok yang berisi teks terformat cocok untuk penulisan source code snippets, catatan dan contoh. Menggunakan tiga tanda kurung kurawal ("...") yang mengapit teks untuk menentukan sebuah teks kutipan. Kurung kurawal harus pada baris terpisah.

Wiki Markup Tampilan
{{{
def HelloWorld():
    print '''Hello World'''
}}}
def HelloWorld():
    print '''Hello World'''

Catatan : Blok jenis ini juga digunakan untuk menyeleksi beberapa baris yang juga akan di proses WikiProcessors.

Blok Kutipan

Untuk menandai sebuah paragraf menjadi sebuah blok kutipan digunakan 2 buah spasi diawal teks kutipan tersebut.

Wiki Markup Tampilan
Paragraf
  Ini adalah contoh teks kutipan.

Paragraf

Ini adalah contoh teks kutipan.

Kutipan Diskusi / Obrolan

Wiki mendukung kutipan diskusi atau kutipan dalam sebuah obrolan, seperti dalam sebuah tiket yang dikirim kepada para pengembang, area komentar dalam sebuah post atau artikel dan seperti obrolan dalam email (">", ">>", dll.)

Wiki Markup Tampilan
>> Ini adalah contoh teks asli atau bisa berupa sebuah pertanyaan
> Ini adalah contoh jawaban yang dikirim
>  - Dapat menggunakan beberapa jenis gaya penulisan dalam wiki.

Ini adalah contoh teks asli atau bisa berupa sebuah pertanyaan

Ini adalah contoh jawaban yang dikirim

  • Dapat menggunakan beberapa jenis gaya penulisan dalam wiki.

Tabel

Tabel Sederhana

tabel sederhana dapat dibuat dengan cara :

Wiki Markup Tampilan
||Cell 1||Cell 2||Cell 3||
||Cell 4||Cell 5||Cell 6||
Cell 1Cell 2Cell 3
Cell 4Cell 5Cell 6

Judul Cell dapat menggunakan simbol '=' Catatan : simbol '=' harus menempel pada simbol pemisah sisi kanan dan kiri table, perhatikan contoh :

Wiki Markup Tampilan
||        ||= judul 1 =||= judul 2 =||
||= 0.10 =||  0.10.5   || 0.10.6dev ||
||= 0.11 =||  0.11.6   || 0.11.7dev ||
judul 1 judul 2
0.10 0.10.5 0.10.6dev
0.11 0.11.6 0.11.7dev

Ketika membuat sebuah cell kosong makan cell kosong tersebut akan digabungkan kedalam cell yang berada di sebelah kanan cell kosong tersebut, perhatikan contoh :

Wiki Markup Tampilan
|| 1 || 2 || 3 ||
|||| 1-2 || 3 ||
|| 1 |||| 2-3 ||
|||||| 1-2-3 ||
1 2 3
1-2 3
1 2-3
1-2-3
Catatan : Jika teks yang berada didalam simbol pemisah tabel ("
...") memotong pemisah tabel lainnya makan simbol tabel terjauh atau terpanjang yang akan digunakan, perhatikan contoh :
Wiki Markup Tampilan
||=Teks =||= Nomor =||
||rata kiri    ||        1.0||
||  rata tengah ||       4.5||
||      rata kanan||     4.5||
|| standar teks ||  2.5||
||teks biasa||         2.5||
||  teks biasa ||      2.5||
|| teks biasa ||       2.5||
Teks Nomor
rata kiri 1.0
rata tengah 4.5
rata kanan 4.5
standar teks 2.5
teks biasa 2.5
teks biasa 2.5
teks biasa 2.5

Jika bertentangan dengan contoh di atas, sel-sel dalam tabel Anda mengandung lebih banyak teks, mungkin mudah untuk menyebarkan baris tabel lebih dari beberapa baris dari markup. Simbol '\' ditempatkan pada akhir baris setelah pemisah sel memberitahu Trac untuk tidak memulai baris baru untuk sel pada baris berikutnya.

Wiki Markup
|| ini adalah kolom 1 [http://dev.blankonlinux.or.id/newticket tiket baru] || \
|| ini adalah kolom 2 [http://dev.blankonlinux.or.id/roadmap Roadmap Linux BlankOn] || \
|| ini adalah kolom 3 dan seterusnya ||
Tampilan
ini adalah kolom 1 tiket baru ini adalah kolom 2 Roadmap Linux BlankOn ini adalah kolom 3 dan seterusnya

Tabel Rumit

Jika kemungkinan yang ditawarkan oleh pembuatan tabel sederhana yang dijelaskan di atas tidak cukup untuk kebutuhan Anda, Anda dapat membuat tabel yang lebih rumit lagi seperti yang dijelaskan dengan menggunakanWikiProcessor based tables.

Pranala

Hyperlink secara otomatis dibuat untuk WikiPageNames dan URL. ! WikiPageLinks? dapat dinonaktifkan dengan mengawali tanda seru "!", seperti !WikiPageLink.

Wiki Markup Tampilan
TitleIndex, http://www.blankonlinux.or.id/, !BukanPranala

TitleIndex, http://www.blankonlinux.or.id/, BukanPranala

Link dapat diberi judul yang lebih deskriptif dengan menulis link diikuti dengan spasi dan judul dan semua ini dalam tanda kurung siku. Jika judul deskriptif dihilangkan, maka awalan eksplisit dibuang, kecuali link tersebut adalah link eksternal. Hal ini dapat berguna untuk halaman wiki tidak mengikuti WikiPageNames konvensi.

Wiki Markup Tampilan
 * [http://www.blankonlinux.or.id BlankOn Linux]
 * [wiki:TitleIndex Title Index] 
 * [wiki:TitleIndex] 
 * [wiki:ISO9000]

Mengikuti aturan WikiCreole?, judul deskriptif juga dapat ditentukan dengan menulis link diikuti oleh simbol ('|') dan judul dan semua di dalam tanda kurung siku ganda ini ("...?").

 * [[http://www.blankonlinux.or.id|BlankOn Linux]]
 * [[wiki:TitleIndex|Title Index]]
   atau [[TitleIndex|Title Index]]
 * [[wiki:TitleIndex]]
   ''' tetapi bukan ![[TitleIndex]]! '''
 * [[ISO9000]]

Note: tombol WikiCreole gaya untuk link cepat untuk mengetik dan jelas terlihat akrab seperti itu yang digunakan di Wikipedia dan banyak wiki lain. Sayangnya hal itu bertentangan dengan sintaks untuk Macro macro. Jadi dalam kasus yang jarang terjadi ketika Anda perlu untuk merujuk ke halaman yang dinamai makro (contoh tipikal TitleIndex, InterTrac dan interwiki), dengan menulis [[TitleIndex]] Anda benar-benar akan memanggil makro bukan menghubungkan ke halaman....

Halaman Wiki dapat merujuk kepada bagian lain dari Trac system. Halaman - halaman tersebut dapat merujuk kepada halaman tickets, reports, changesets, milestones, source files dan halaman wiki lainnya dengan format sebagai berikut :

Wiki Markup Tampilan
 * Tickets: #1 or ticket:1
 * Reports: {1} or report:1
 * Changesets: r1, [1] or changeset:1
 * ...
 * targeting other Trac instances, 
   so called InterTrac links:
   - Tickets: #Trac1 or Trac:ticket:1
   - Changesets: [Trac1] or Trac:changeset:1

Ada banyak cara Trac link, lihat TracLinks untuk informasi yang lebih mendalam dan referensi bagi semua resolvers standar link.

Setting Anchors

Anchors, atau lebih tepatnya berbicara, nama anchor dapat ditambahkan secara eksplisit di setiap tempat di halaman Wiki, dalam rangka untuk secara unik mengidentifikasi posisi dalam dokumen.

[=#point1]

Sintaks ini dipilih sesuai format untuk secara eksplisit penamaan id header documented above yang didokumentasikan di atas. Sebagai contoh:

== Long title == #title

Hal ini juga sangat dekat dengan sintaks untuk yang sesuai link ke anchor bahwa:

[#point1]

Optionally, a label can be given to the anchor:

[[=#point1 '''Point 1''']]
Wiki Markup Tampilan
[#point2 jump to the second point]

...

Point2:  [=#point2] Jump here

jump to the second point

...

Point2: Jump here

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

Escaping Links and WikiPageNames

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

Wiki Markup Tampilan
 !NoHyperLink
 !#42 is not a link

NoHyperLink #42 is not a link

Gambar

Tautan dengan akhiran .png, .gif or .jpg tidak lagi otomatis diterjemahkan sebagai link gambar dan dikonversi ke marka <img>.

Anda diharuskan menggunakan makro [[Image]]. Ini adalah cara sederhana memasukkan gambar yang diuggah sebagai lampiran pada halaman yang anda buka sekarang dan menambahkan namafile kedalam makro dan memanggilnya seperti [[Image(picture.gif)]].

Untuk tambahan pada halaman sekarang, dimunginkan untuk merujuk pada sumber tertentu:

  • [[Image(wiki:WikiFormatting:picture.gif)]] (Merujuk ke lampiran di halaman lain)
  • [[Image(ticket:1:picture.gif)]] (File yang dilampirkan pada tiket)
  • [[Image(htdocs:picture.gif)]] (Merujuk pada file didalam direktori environment htdocs)
  • [[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]] (sebuah file di lumbung)
Wiki Markup Tampilan
[[Image(htdocs:../common/trac_logo_mini.png)]]

trac_logo_mini.png

Baca WikiMacros untuk dokumentasi lebih detail mengenai makro [[Image()]], yang mememiliki beberapa opsi berguna lain seperti (title=, link=, etc.)

Macros

Macros adalah custom functions untuk memasukkan konten dinamis kedalam sebuah halaman.

Wiki Markup Tampilan
[[RecentChanges(Trac,3)]]

Baca WikiMacros untuk informasi lebih lanjut, dan daftar pemasangan macros.

Detail bantuan untuk spesifik macro bisa langsung diketahui dengan apendik "?" pada nama macro.

Wiki Markup Tampilan
[[MacroList?]]

[[MacroList]]

Display a list of all installed Wiki macros, including documentation if available.

Optionally, the name of a specific macro can be provided as an argument. In that case, only the documentation for that macro will be rendered.

Note that this macro will not be able to display the documentation of macros if the PythonOptimize option is enabled for mod_python!

Pemroses

Trac mendukung alternatif format markup menggunakan WikiProsessors?. Sebagai contoh, pemroses yang digunakan untuk menulis halaman pada reStructuredText atau HTML.

Wiki Markup Tampilan

Contoh 1: HTML

{{{
#!html
<h1 style="text-align: right; color: blue">
 HTML Test
</h1>
}}}

HTML Test

Contoh 2: Code Highlighting

{{{
#!python
class Test:

    def __init__(self):
        print "Halo Pendekar"
if __name__ == '__main__':
   Test()
}}}
class Test:
    def __init__(self):
        print "Halo Pendekar"
if __name__ == '__main__':
   Test()

Contoh 3: Complex Tables

{{{#!th rowspan=4 align=justify
Tambahan pemroses `#td` and `#th`,
cell tabel bisa berisi konten apapun:
}}}
|----------------
{{{#!td
  - daftar
  - tabel embedded
  - konten sederhana multiline
}}}
|----------------
{{{#!td
Sebagaimana pemroses bisa dengan mudah dibuat hirarki kebawah (Koreksi)
Jadi bisa dibentuk sebagai tabel:
  {{{#!th
  Contoh:
  }}}
  {{{#!td style="background: #eef"
  || harus berada pada level ketiga... ||
  }}}
}}}
|----------------
{{{#!td
Jika kamu tidak memiliki marup yang rumit,
form tabel ini bisa jadi bentuk biasa
untuk menulis konten dalam beberapa baris.
}}}

Tambahan pemroses #td and #th, cell tabel bisa berisi konten apapun:

  • daftar
  • tabel embedded
  • konten sederhana multiline

Sebagaimana pemroses bisa dengan mudah dibuat hirarki kebawah (Koreksi) Jadi bisa dibentuk sebagai tabel:

Contoh:

Harus berada di level ketiga...

Jika kamu tidak memiliki marup yang rumit, form tabel ini bisa jadi bentuk biasa untuk menulis konten dalam beberapa baris.

Baca WikiProcessors untuk info lebih detail.

Komentar

Komentar dapat ditambahkan ke dalam teks biasa. Komentar tidak akan diproses dan ditampilkan jika format selain teks biasa.

Wiki Markup Tampilan
Tidak ada apapun
{{{
#!comment
Tulis komentar disini
}}}
senyum ;-)

Tidak ada apapun

senyum ;-)

Lainnya

Sebuah garis mendatar bisa digunakan untuk membatasi bagian yang berbeda pada halaman anda:

Wiki Markup Tampilan
Empat atau lebih strip (-) akan diganti dengan 
menjadi garis datar (<HR>)
----
Seperti ini?

Empat atau lebih strip (-) akan diganti dengan menjadi garis datar (<HR>)


Seperti ini?

"macro" style [[br]] line break

"macro" style
line break

!WikiCreole style \\ line\\break

WikiCreole style
line
break

Last modified 3 years ago Last modified on 03/12/2014 07:32:14 PM